openclaw channels

管理 Gateway 上的聊天 Channel 账号及其运行状态。

相关文档：

常用命令

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

添加/删除账号

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

提示：运行 openclaw channels add --help 可以查看各个 Channel 的专属参数（token、app token、signal-cli 路径等）。

登录/登出（交互式）

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 session key（CLAUDE_WEB_SESSION_KEY / CLAUDE_WEB_COOKIE），或通过 Claude Code CLI 重新认证。

Capabilities 探测

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

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

注意事项：

  • --channel 是可选的；省略它会列出所有 Channel（包括扩展）。
  • --target 接受 channel:<id> 或纯数字 channel id，仅适用于 Discord。
  • 探测是 Provider 特定的：Discord intents + 可选的 channel 权限；Slack bot + user scopes；Telegram bot flags + webhook；Signal daemon 版本；MS Teams app token + Graph roles/scopes（已知的会标注）。没有探测功能的 Channel 会显示 Probe: unavailable。

将名称解析为 ID

使用 Provider 目录将 channel/用户名称解析为 ID：

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 强制指定目标类型。
  • 当多个条目共享相同名称时，解析会优先选择活跃的匹配项。