openclaw channels

管理 Gateway 上的聊天通道账户及其运行时状态�?

相关文档�?

常用命令

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 add 而不带标志时，交互式向导可以提示�?

  • 每个选定通道的账�?id
  • 这些账户的可选显示名�?
  • 是否将配置的通道账户绑定到代理？

如果确认立即绑定，向导会询问哪个代理应该拥有每个配置的通道账户，并写入账户作用域的路由绑定�?

你也可以稍后使用 openclaw agents bindings、openclaw agents bind �?openclaw agents unbind 管理相同的路由规则（参见 agents）�?

当你向仍使用单账户顶级设置（没有 channels.<channel>.accounts 条目）的通道添加非默认账户时，OpenClaw 会将账户作用域的单账户顶级值移动到 channels.<channel>.accounts.default，然后写入新账户。这在保持原始账户行为的同时，转换为多账户形式�?

路由行为保持一致：

  • 现有的仅通道绑定（没�?accountId）继续匹配默认账户�?
  • channels add 在非交互模式下不会自动创建或重写绑定�?
  • 交互式设置可以选择添加账户作用域的绑定�?

如果你的配置已经处于混合状态（存在命名账户、缺�?default、顶级单账户值仍设置），运行 openclaw doctor --fix 将账户作用域的值移动到 accounts.default�?

登录 / 退出（交互式）

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）以及静态功能支持：

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

注意�?

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

将名称解析为 ID

使用提供商目录将通道/用户名解析为 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 强制目标类型�?
  • 当多个条目共享相同名称时，解析优先匹配活动项�?