❓ 常见问题 FAQ

解决方案：

1. 清理 npm 缓存：

   npm cache clean --force

2. 检查 Node.js 版本：

   node --version

   （需要 18+）
3. 使用管理员权限运行
4. 如果还不行，尝试用 pnpm：

   pnpm add -g openclaw

解决方案：

Windows:

1. 找到 npm 全局路径：

   npm config get prefix

2. 添加到系统环境变量 PATH：

   C:\Users\你的用户名\AppData\Roaming\npm

3. 重启 PowerShell

Mac/Linux:

1. 添加到 shell 配置：

   export PATH=$(npm config get prefix)/bin:$PATH

2. 添加到 ~/.zshrc 或 ~/.bashrc
3. 执行 source ~/.zshrc

检查清单：

• ✅ Key 是否正确复制（无多余空格、换行）
• ✅ 账号是否有足够额度（余额/免费额度）
• ✅ 模型名称是否正确（如 bailian/qwen3.5-plus）
• ✅ API Key 是否已激活
• ✅ 网络是否能访问 API 服务

测试方法：

openclaw ask "你好"

可能原因：

• 网络连接问题
• API Key 无效或额度不足
• 模型服务暂时不可用
• 消息内容触发安全过滤

排查步骤：

1. 检查网络：

   ping bailian.aliyuncs.com

2. 测试 API：

   openclaw ask "1+1 等于几"

3. 查看日志：

   openclaw status

4. 尝试更换模型

改进方法：

1. 问题更具体：

   ❌ "帮我写代码"
   ✅ "帮我写一个 Python 函数，计算两个数的和"

2. 提供上下文：

   "我正在开发一个网站，需要..."

3. 指定格式：

   "请用表格形式列出..."

检查清单：

• ✅ 文件路径是否正确（区分大小写）
• ✅ 文件是否在 AI 工作区内
• ✅ 文件是否被其他程序占用
• ✅ 是否有读取权限

解决方法：

1. 使用绝对路径
2. 将文件移到工作区
3. 关闭占用文件的程序
4. 检查文件权限

原因：

文件编码不是 UTF-8（Windows 默认 GBK）

解决方案：

1. 用文本编辑器另存为 UTF-8
2. PowerShell 转换：

   Get-Content file.txt | Set-Content file-utf8.txt -Encoding UTF8

预防方法：

所有文本文件统一用 UTF-8 编码保存

排查步骤：

1. 测试网络连通性：

   ping bailian.aliyuncs.com

2. 检查防火墙设置
3. 尝试更换网络（如手机热点）
4. 检查 DNS 设置

临时方案：

• 使用代理服务器
• 等待网络恢复