openclaw channels

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

相关文档：

  • 渠道指南（Channel guides）：渠道
  • Gateway 配置（Gateway configuration）：配置

常用命令

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 显示每个渠道的标志（token、app token、signal-cli 路径等）。

登录 / 登出（交互式）

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

故障排除（Troubleshooting）

  • 运行 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 重新认证。

能力探测（Capabilities probe）

获取提供商能力提示（可用时的意图/作用域）以及静态功能支持：

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

注意：

  • --channel 是可选的；省略它以列出每个渠道（包括扩展）。
  • --target 接受 channel:<id> 或原始数字渠道 ID，仅适用于 Discord。
  • 探测是提供商特定的：Discord 意图 + 可选渠道权限；Slack 机器人 + 用户作用域；Telegram 机器人标志 + webhook；Signal 守护进程版本；MS Teams 应用令牌 + Graph 角色/作用域（在已知的地方注释）。没有探测的渠道报告 Probe: unavailable。

解析名称到 ID（Resolve names to IDs）

使用提供商目录将渠道/用户名称解析为 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 强制目标类型。
  • 当多个条目共享相同名称时，解析优先选择活跃匹配。
← 返回文档首页