开源鸿蒙PC三方库编译问题速查手册 本文总结了开源鸿蒙PC平台第三方库编译过程中常见的10类高频错误及解决方案： CRLF换行符问题：Windows与Linux换行符差异导致脚本执行失败，建议使用Python脚本统一转换或使用Linux编辑器 musl库函数缺失：鸿蒙使用musl而非glibc导致部分POSIX扩展函数不可用，需条件编译或功能降级处理 构建缓存问题：修改配置后构建被跳过，需清除构建

OpenClaw 在执行操作时遇到权限不足错误，本质是文件只读或安装目录需要 sudo。文中给出修复文件权限、使用虚拟环境、--user 安装等完整方案。

OpenClaw 使用时遇到额度或 Token 用量超限报 402 错误，本质是免费额度用完或月度 Token 超限。文中给出充值、等待重置、减少 Token 消耗、多 Key 轮换等完整方案。

OpenClaw 在不兼容的 Python 环境中运行失败，本质是 Python 版本低于 3.8 或默认 Python 指向错误。文中给出 pyenv 管理版本、创建虚拟环境、修复依赖冲突等完整方案。

OpenClaw 使用了不存在或已弃用的模型名称，本质是拼写错误或版本已弃用。文中给出查看可用模型、修复配置、检查大小写、使用默认模型等完整方案。

OpenClaw 调用 API 时返回 500 Internal Server Error，本质是服务端临时故障或流量高峰。文中给出重试脚本、--no-stream、简化请求、切换模型等完整方案。

OpenClaw 无法找到或加载 AGENTS.md 项目指令文件，本质是文件位置、命名或格式错误。文中给出在根目录创建、检查文件名、修复格式、精简内容等完整方案。

OpenClaw 无法找到或加载配置文件，本质是文件位置、命名或 JSON 格式错误。文中给出检查位置、创建配置、验证 JSON、处理优先级冲突等完整方案。

OpenClaw 编辑文件时 diff 应用不正确或修改与预期不符，本质是文件内容已变化或空格缩进不一致。文中给出使用具体指令、--print 先分析、Git 分支保护等完整方案。

OpenClaw 的会话过期或认证令牌失效，本质是 API Key 撤销或 OAuth 令牌过期。文中给出重新设置 API Key、重新认证、检查凭证文件等完整方案。