问题排查

症状：openclaw gateway status 显示 stopped 或 not running。

解决方案：

1. 查看启动错误日志：

   openclaw logs gateway --last 50

2. 手动启动网关前台运行查看错误：

   openclaw gateway

3. 修复配置问题后重新安装服务：

   openclaw onboard --install-daemon

症状：浏览器无法访问 http://127.0.0.1:18789 或显示连接错误。

解决方案：

1. 确认网关正常运行：

   openclaw gateway status

2. 检查绑定地址配置：

   openclaw config get gateway.bind

3. 远程访问需要将绑定地址设置为 0.0.0.0：

   openclaw config set gateway.bind.host 0.0.0.0

症状：发送消息后没有任何回复，或显示处理中。

排查步骤：

1. 检查模型配置和API密钥是否正确：

   openclaw models list

2. 查看实时日志：

   openclaw logs --follow

3. 群聊环境下确认是否@了智能体，或是否配置了提及激活
4. 检查用户是否在配对允许列表中：

   openclaw pairing list

症状：openclaw channels status 显示 disconnected 或 error。

解决方案：

1. 检查渠道配置是否正确：

   openclaw channels config <channel-name>

2. 重新配置渠道：

   openclaw channel setup <channel-type>

3. 查看渠道错误日志：

   openclaw logs channel --name <channel-name>

症状：智能体回复显示红色感叹号，或日志中有发送失败错误。

常见原因：

• 渠道令牌/密钥过期或权限不足
• 网络连接问题，需要配置代理
• 消息内容被平台风控拦截
• 接收方ID或群组ID错误

症状：安装的技能或插件没有被调用，或提示不存在。

解决方案：

1. 确认技能/插件已正确安装：

   openclaw skills list openclaw plugins list

2. 插件安装失败提示missing openclaw.extensions时，需要在插件package.json中添加：

   "openclaw": { "extensions": ["./dist/index.js"] }

3. 重新加载技能：向智能体发送"刷新技能"指令
4. 检查技能SKILL.md格式是否正确，是否有语法错误

症状：工具调用返回权限错误、命令不存在或执行失败。

排查步骤：

1. 检查工具是否在允许列表中，是否开启了权限限制
2. 系统命令需要确认PATH环境变量包含命令路径
3. 文件操作工具需要确认工作区目录权限配置
4. 沙箱模式下确认是否允许工具执行

症状：摄像头、屏幕录制、定位等节点功能调用失败。

解决方案：

1. 确认节点设备已正确配对：

   openclaw nodes list

2. 检查设备权限是否已授予（相机、麦克风、屏幕录制等）
3. 移动端节点需要确认App在前台运行，未被系统杀掉
4. 重新配对设备：

   openclaw node pair

症状：智能体回复时间过长，超过5秒。

优化方案：

1. 优先使用速度更快的模型（如豆包/DeepSeek等国产模型延迟更低）
2. 开启模型缓存：

   openclaw config set model.cache.enabled true

3. 限制会话历史长度，减少上下文Token消耗
4. 检查网络到模型供应商的延迟，必要时配置代理
5. v0.8.0版本已优化核心调度逻辑，平均响应时间从800ms降低到200ms，建议升级到最新版本

症状：网关进程内存占用超过2GB，系统卡顿。

优化方案：

1. 开启会话自动清理：

   openclaw config set session.autoPrune.enabled true

2. 限制最大会话保留时间（默认7天）：

   openclaw config set session.autoPrune.maxAgeDays 3

3. 定期清理日志文件：

   openclaw logs prune --keep 7

4. 如使用本地模型，推荐使用4bit/8bit量化版本减少内存占用