小白AI编程

Appearance

安装报错怎么办 ​

解决 OpenClaw 安装过程中可能遇到的问题。

快速导航 ​

下载太慢 ​

症状： 下载进度很慢，或者提示下载失败

原因： 网络问题（可能是因为网络不稳定或被限速）

解决方法：

  1. 换个网络试试

    • 如果用 WiFi，试试用手机热点
    • 如果用手机热点，试试 WiFi

  2. 等网络好一点的时候再下载

    • 晚上或凌晨网络通常比较快

  3. 使用下载工具

    • 可以用浏览器自带的下载管理
    • 尽量不要用第三方下载工具

权限不足 ​

症状： 安装时提示"权限不足"、"无法访问"等

原因： 没有管理员权限

Windows 解决方法 ​

  1. 右键点击安装文件（.exe 文件）
  2. 选择"以管理员身份运行"
  3. 然后正常安装

Mac 解决方法 ​

  1. 打开"系统偏好设置"
  2. 点击"安全性与隐私"
  3. 如果提示"已阻止"，点"仍然允许"

扩展安装失败 ​

症状： 在 VS Code 里安装 OpenClaw 扩展失败

原因： 网络问题或 VS Code 版本太旧

解决方法：

方法一：检查网络 ​

确保网络稳定，可以打开一个网页试试。

方法二：更新 VS Code ​

  1. 打开 VS Code
  2. 按 Ctrl+Shift+P（Windows）或 Cmd+Shift+P（Mac）
  3. 输入 "Check for Updates"
  4. 如果有更新，点更新

方法三：重新安装扩展 ​

  1. 在 VS Code 扩展列表里找到 OpenClaw
  2. 点"卸载"
  3. 等卸载完成后，重新点"安装"

找不到命令 ​

症状： 按 Ctrl+Shift+P 后输入 OpenClaw，找不到选项

原因： 安装没有成功，或者 VS Code 没有重启

解决方法：

  1. 重启 VS Code

    • 关掉 VS Code，重新打开

  2. 检查扩展列表

    • 按 Ctrl+Shift+X（Windows）或 Cmd+Shift+X（Mac）
    • 搜索 "OpenClaw"
    • 确认显示"已安装"而不是"安装"

  3. 卸载重装

    • 如果还是不行，卸载 OpenClaw 扩展
    • 重启 VS Code
    • 重新安装

其他问题 ​

端口被占用 ​

症状： 提示"端口被占用"

原因： 其他程序占用了 OpenClaw 需要用的端口

解决方法：

  1. 关闭其他可能占用端口的程序
  2. 重启 VS Code
  3. 重试

还是解决不了？ ​

  1. 截图或复制报错信息
  2. 去常见问题看看
  3. 把报错信息发给我们（如果你是跟着教程来的）