`openclaw channels`

管理 Gateway 网关上的聊天渠道账户及其运行时状态。

常用命令


bash
openclaw channels list
openclaw channels status
openclaw channels capabilities
openclaw channels capabilities --channel discord --target channel:123
openclaw channels resolve --channel slack "#general" "@jane"
openclaw channels logs --channel all

添加/删除账户


bash
openclaw channels add --channel telegram --token <bot-token>
openclaw channels remove --channel telegram --delete

提示：openclaw channels add --help 显示每个渠道的标志（token、app token、signal-cli 路径等）。

登录/登出（交互式）


bash
openclaw channels login --channel whatsapp
openclaw channels logout --channel whatsapp

故障排除

✦运行 openclaw status --deep 进行全面探测。
✦使用 openclaw doctor 获取引导式修复。
✦openclaw channels list 输出 Claude: HTTP 403 ... user:profile → 用量快照需要 user:profile 权限范围。使用 --no-usage，或提供 claude.ai 会话密钥（CLAUDE_WEB_SESSION_KEY / CLAUDE_WEB_COOKIE），或通过 Claude Code CLI 重新授权。

能力探测

获取提供商能力提示（可用的 intents/scopes）以及静态功能支持：


bash
openclaw channels capabilities
openclaw channels capabilities --channel discord --target channel:123

说明：

✦--channel 是可选的；省略它可列出所有渠道（包括扩展）。
✦--target 接受 channel:<id> 或原始数字频道 id，仅适用于 Discord。
✦探测是特定于提供商的：Discord intents + 可选的频道权限；Slack bot + user scopes；Telegram bot 标志 + webhook；Signal daemon 版本；MS Teams app token + Graph roles/scopes（在已知处标注）。没有探测功能的渠道报告 Probe: unavailable。

解析名称为 ID

使用提供商目录将渠道/用户名称解析为 ID：


bash
openclaw channels resolve --channel slack "#general" "@jane"
openclaw channels resolve --channel discord "My Server/#support" "@someone"
openclaw channels resolve --channel matrix "Project Room"

说明：

✦使用 --kind user|group|auto 强制指定目标类型。
✦当多个条目共享相同名称时，解析优先选择活跃的匹配项。