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 无响应。

解决步骤：

重启服务：killall openclaw openclaw-gateway 2>/dev/null
/data/bin/openclaw gateway –port 18789

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

查看实时日志：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 见配置文件）。