跳转到主要内容

Documentation Index

Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

当渠道已连接但行为异常时，请使用此页面。

​
命令阶梯

先按顺序运行这些命令： 
openclaw status
openclaw gateway status
openclaw logs --follow
openclaw doctor
openclaw channels status --probe
健康基线：
  • Runtime: running
  • Connectivity probe: ok
  • Capability: read-only、write-capable 或 admin-capable
  • 渠道探测显示传输协议已连接，并且在支持的情况下显示 works 或 audit ok

​
WhatsApp

​
WhatsApp 故障特征

症状最快检查修复
已连接但没有私信回复openclaw pairing list whatsapp批准发送者，或切换私信策略/允许列表。
群组消息被忽略检查配置中的 requireMention + 提及模式提及机器人，或放宽该群组的提及策略。
二维码登录因 408 超时检查 Gateway 网关的 HTTPS_PROXY / HTTP_PROXY 环境变量设置可访问的代理；仅将 NO_PROXY 用于绕过。
随机断开连接/重新登录循环openclaw channels status --probe + 日志即使当前已连接，最近的重连也会被标记；观察日志，重启 Gateway 网关，如果仍持续抖动则重新关联。
回复延迟数秒/数分钟才到达openclaw doctor --fix当已验证的陈旧本地 TUI 客户端正在拖慢 Gateway 网关事件循环时，Doctor 会停止它们。
完整故障排除：WhatsApp 故障排除

​
Telegram

​
Telegram 故障特征

症状最快检查修复
/start 后没有可用的回复流程openclaw pairing list telegram批准配对或更改私信策略。
机器人在线但群组保持静默验证提及要求和机器人隐私模式禁用隐私模式以允许群组可见性，或提及机器人。
发送失败并出现网络错误检查日志中的 Telegram API 调用失败修复到 api.telegram.org 的 DNS/IPv6/代理路由。
启动报告 getMe returned 401检查已配置的令牌来源重新复制或重新生成 BotFather 令牌，并更新 botToken、tokenFile 或默认账户的 TELEGRAM_BOT_TOKEN。
轮询停滞或重连缓慢用 openclaw logs --follow 查看轮询诊断升级；如果重启是假阳性，请调优 pollingStallThresholdMs。持续停滞仍指向代理/DNS/IPv6 问题。
启动时 setMyCommands 被拒绝检查日志中的 BOT_COMMANDS_TOO_MUCH减少插件/技能/自定义 Telegram 命令，或禁用原生命令菜单。
升级后允许列表阻止了你openclaw security audit 和配置允许列表运行 openclaw doctor --fix，或将 @username 替换为数字发送者 ID。
完整故障排除：Telegram 故障排除

​
Discord

​
Discord 故障特征

症状最快检查修复
机器人在线但没有服务器回复openclaw channels status --probe允许服务器/频道，并验证消息内容意图。
群组消息被忽略检查日志中因提及门控而丢弃的记录提及机器人，或设置服务器/频道 requireMention: false。
有输入状态/令牌使用但没有 Discord 消息会话日志显示助手文本且 didSendViaMessagingTool: false模型私下回答了，而不是调用消息工具。使用可靠调用工具的模型，或设置 messages.groupChat.visibleReplies: "automatic" 以自动发布。
私信回复缺失openclaw pairing list discord批准私信配对，或调整私信策略。
完整故障排除：Discord 故障排除

​
Slack

​
Slack 故障特征

症状最快检查修复
Socket mode 已连接但没有响应openclaw channels status --probe验证 app token + bot token 和所需 scopes；在基于 SecretRef 的设置中留意 botTokenStatus / appTokenStatus = configured_unavailable。
私信被阻止openclaw pairing list slack批准配对，或放宽私信策略。
频道消息被忽略检查 groupPolicy 和频道允许列表允许该频道，或将策略切换为 open。
完整故障排除：Slack 故障排除

​
iMessage

​
iMessage 故障特征

症状最快检查修复
imsg 缺失或在非 macOS 上失败openclaw channels status --probe --channel imessage在 Messages Mac 上运行 OpenClaw，或为 cliPath 使用 SSH 包装器。
在 macOS 上可以发送但无法接收检查 macOS 对 Messages 自动化的隐私权限重新授予 TCC 权限，并重启渠道进程。
私信发送者被阻止openclaw pairing list imessage批准配对，或更新允许列表。
完整故障排除：

​
Signal

​
Signal 故障特征

症状最快检查修复
守护进程可访问但机器人静默openclaw channels status --probe验证 signal-cli 守护进程 URL/账户和接收模式。
私信被阻止openclaw pairing list signal批准发送者，或调整私信策略。
群组回复未触发检查群组允许列表和提及模式添加发送者/群组，或放宽门控。
完整故障排除：Signal 故障排除

​
QQ Bot

​
QQ Bot 故障特征

症状最快检查修复
机器人回复“gone to Mars”验证配置中的 appId 和 clientSecret设置凭据，或重启 Gateway 网关。
没有入站消息openclaw channels status --probe在 QQ Open Platform 上验证凭据。
语音未转写检查 STT 提供商配置配置 channels.qqbot.stt 或 tools.media.audio。
主动消息没有到达检查 QQ 平台交互要求如果近期没有交互，QQ 可能会阻止机器人发起的消息。
完整故障排除：QQ Bot 故障排除

​
Matrix

​
Matrix 故障特征

症状最快检查修复
已登录但忽略房间消息openclaw channels status --probe检查 groupPolicy、房间允许列表和提及门控。
私信未处理openclaw pairing list matrix批准发送者，或调整私信策略。
加密房间失败openclaw matrix verify status重新验证设备，然后检查 openclaw matrix verify backup status。
备份恢复处于等待状态/已损坏openclaw matrix verify backup status运行 openclaw matrix verify backup restore，或使用恢复密钥重新运行。
交叉签名/bootstrap 看起来异常openclaw matrix verify bootstrap一次性修复密钥存储、交叉签名和备份状态。
完整设置和配置：Matrix

​
相关