OpenClaw 故障排除指南

解决 OpenClaw（原 ClawDBot）使用中的常见问题

🧭 官方排障命令梯（先跑）

openclaw status

openclaw gateway status

openclaw logs --follow

openclaw doctor

openclaw channels status --probe

官方健康基线：Runtime=running，RPC probe=ok，Channel probe=connected/ready。

📌 官方高频故障特征

WhatsApp: 已连接但 DM 不回复 -> pairing list + approve；群聊无响应 -> 检查 requireMention。

Telegram: /start 后流程不可用 -> pairing/DM policy；群消息无响应 -> 关闭 BotFather privacy 或显式 mention。

Discord: Bot 在线无 guild 回复 -> 检查 Message Content Intent + guild allowlist。

Slack: Socket 已连但无响应 -> 校验 xapp/xoxb token 与 scopes；频道忽略 -> groupPolicy/channels allowlist。

🚫 安装问题

安装命令无效

运行 `curl -fsSL https://clawd.bot/install.sh | bash` 时出错

# 解决方案：

1. 确保已安装 Node.js 22+

2. node --version # 检查版本

3. 使用 sudo 如果需要管理员权限

安装后命令找不到

运行 openclaw --version 显示命令未找到

# 解决方案：

source ~/.bashrc # 刷新 shell

# 或重启终端

🔌 连接问题

Bot 完全无响应

Telegram、WhatsApp、Discord 都收不到回复

# 检查步骤：

1. openclaw status # 检查服务状态

2. openclaw logs # 查看错误日志

3. 检查 API key 是否过期

Gateway 连接失败

# 解决方案：

openclaw gateway restart

# 或重新安装：

openclaw uninstall && openclaw install

🔧 MCP 配置问题

找不到 MCP 配置文件

用户问：where is the client MCP config file?

# 配置文件位置：

macOS: ~/.openclaw/mcp-servers.json

Linux: ~/.openclaw/mcp-servers.json

Windows: %USERPROFILE%\.openclaw\mcp-servers.json

MCP 服务器连接失败

# 排查步骤：

1. 检查 npm 包是否安装

2. 验证 server URL 是否可访问

3. 检查 API keys 是否正确配置

💬 仍然需要帮助？

加入我们的社区获取更多支持：