OpenClaw安装及启动失问题解答

OpenClaw（原 Moltbot/Clawdbot）在安装或启动过程中常见问题及解决方案如下，按典型场景分类整理，详细参考OpenClaw部署安装阿里云官方页面：https://www.aliyun.com/benefit/scene/moltbot

一、安装失败或命令未找到

• 现象：执行 openclaw 提示 command not found。
• 原因与解决：
  • OpenClaw 可能尚未安装，或旧版仍使用 moltbot / clawdbot 命令。
  • 建议操作：
    • 尝试运行 clawdbot -version 或 moltbot -version 确认是否为旧版。
    • 若需全新安装，在无影云手机中执行：

      curl -sSL https://android-phone-resources.oss-cn-hangzhou.aliyuncs.com/script/install_openclaw.sh | sh
      

    • 安装时需提供有效的 DashScope API Key（以 sk- 开头）。

二、启动后无法访问或服务异常

• 现象：启动后 Web UI 无法打开，或 TUI 无响应。
• 解决步骤：
  1. 重启服务：

     killall openclaw openclaw-gateway 2>/dev/null
     /data/bin/openclaw gateway --port 18789
     

     或使用快捷命令（若支持）：

     openclaw gateway restart
     

  2. 查看实时日志：

     openclaw logs -follow
     

     按 Ctrl+C 退出。日志可帮助定位模型加载、API 配置或网络错误。

三、API Key 或模型配置错误

• 典型报错：HTTP 401: Incorrect API key provided 或 model qwen-max-latest is not supported。
• 排查要点：
  • 确认 API Key 以 sk- 开头，且来自 百炼平台 > 密钥管理。
  • 若使用 Coding Plan 的 Key（如 sk-sp-xxxx），必须：
    • 在模型配置中点击 “切换到通用模型”；
    • 模型 ID 填写 qwen3-coder-plus 或 qwen3-max-2026-01-23；
    • Base URL 改为：https://coding.dashscope.aliyuncs.com/v1。
  • 配置文件路径：~/.openclaw/openclaw.json，可手动检查 providers.bailian 配置。

四、通道（钉钉/飞书/QQ）接入问题

• 钉钉重复收消息：升级至最新 OpenClaw 镜像。
• QQ 机器人无响应：
  • 检查 AppID 和 Bot Secret 是否正确；
  • 确保已在 QQ 机器人后台添加云电脑公网 IP 到白名单（可用 curl cip.cc 获取 IP）。
• 通用诊断命令：

  clawdbot doctor
  

  可自动检测配置异常。

五、其他注意事项

• 不支持图片/文件解析：当前版本无法处理 IM 中发送的图片或文件。
• 无影个人版不支持手动升级：避免使用 clawdbot update，可能破坏环境。
• Web UI 访问方式：
  • 本地通过 SSH 端口转发：

    ssh -L 18789:127.0.0.1:18789 root@<云电脑IP>
    

  • 浏览器访问：http://127.0.0.1:18789/?token=<GATEWAY_TOKEN>（Token 见配置文件）。