跳转到主要内容

​
openclaw channels

管理 Gateway 网关 上的聊天通道账户及其运行时状态。 相关文档：
  • 频道指南：频道
  • 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 add --channel nostr --private-key "$NOSTR_PRIVATE_KEY"
openclaw channels remove --channel telegram --delete
提示：openclaw channels add --help 显示各渠道的标志（令牌、私钥、应用令牌、signal-cli 路径等）。 当您不带标志运行 openclaw channels add 时，交互式向导可以提示：
  • 每个选定通道的账户 ID
  • 这些账户的可选显示名称
  • Bind configured channel accounts to agents now?
如果您确认现在绑定，向导会询问每个已配置的通道账户应由哪个代理拥有，并写入账户范围的路由绑定。 您稍后也可以使用 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 重新进行身份验证。
  • 当网关不可达时，openclaw channels status 会回退到仅配置摘要。如果受支持的渠道凭证是通过 SecretRef 配置的，但在当前命令路径中不可用，它会将该帐户报告为已配置并带有降级说明，而不是显示为未配置。

​
功能探测

获取提供商功能提示（可用时包含 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 守护程序版本；Microsoft Teams 应用令牌 + 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 来强制指定目标类型。
  • 当多个条目共享相同名称时，解析优先考虑活动匹配项。
  • channels resolve 是只读的。如果选定的帐户是通过 SecretRef 配置的，但该凭证在当前命令路径中不可用，命令将返回带有说明的降级未解析结果，而不是中止整个运行。
本页面源自 openclaw/openclaw，由 BeaversLab 翻译，遵循 MIT 协议 发布。
Last modified on March 27, 2026