网关故障排除

快速诊断

openclaw gateway status
openclaw gateway probe
openclaw status --all
openclaw logs --follow

常见问题

网关无法启动

症状: openclaw gateway 报错或立即退出

检查:

1. 端口是否被占用

   lsof -i :18789

2. 配置是否有效

   openclaw doctor

3. 查看日志

   openclaw logs --follow

解决:

• 使用 --force 强制启动
• 更换端口 --port 19000
• 修复配置问题

"unauthorized" 错误

症状: 连接时提示未授权

原因:

• Token/密码不匹配
• 设备未配对
• 认证过期

解决:

1. 检查 token 配置
2. 使用 openclaw dashboard 获取正确的 URL
3. 重新配对设备

RPC 探测失败

症状: gateway status 显示 "RPC probe failed"

检查:

openclaw gateway probe
openclaw health --verbose

原因:

• 网关未运行
• 端口/绑定配置错误
• 认证问题

通道连接问题

症状: 通道显示离线或重连

检查:

openclaw channels status --probe
openclaw channels logs --channel whatsapp

WhatsApp 常见问题:

• 需要重新扫码：openclaw channels login
• 会话过期：重新登录

Telegram 常见问题:

• Bot token 无效
• 网络问题

服务与手动运行不一致

症状: 服务运行时行为与手动不同

原因: 环境变量差异

解决:

1. 检查服务使用的配置

   openclaw gateway status

2. 确保环境变量在服务中可用
3. 重新安装服务

   openclaw gateway uninstall
   openclaw gateway install

日志位置

• 文件日志：/tmp/openclaw/openclaw-*.log
• 服务日志：
  • macOS: ~/Library/Logs/openclaw/
  • Linux: journalctl --user -u openclaw

重置

如果问题持续：

# 仅重置配置
openclaw reset --scope config

# 完全重置
openclaw reset --scope full

相关文档

• 故障排除
• 日志
• Doctor