OpenClaw从入门到应用——CLI：频道（Channels）

通过OpenClaw实现副业收入：《OpenClaw赚钱实录：从“养龙虾“到可持续变现的实践指南》

openclaw channels管理聊天频道账户及其在网关上的运行时状态。

相关文档：

• 频道指南：Channels
• 网关配置：Configuration

常用命令

openclaw channels list openclaw channels status openclaw channels capabilities openclaw channels capabilities--channeldiscord--targetchannel:123 openclaw channels resolve--channelslack"#general""@jane"openclaw channels logs--channelall

添加/移除账户

openclaw channelsadd--channeltelegram--token<token>openclaw channels remove--channeltelegram--delete

提示：openclaw channels add --help会显示每个频道的专属参数（token、应用 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--channelwhatsapp openclaw channelslogout--channelwhatsapp

故障排除

• 运行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 配置但在当前命令路径中不可用，它会将该账户报告为“已配置（降级）”，而不是显示为“未配置”。

能力探测

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

openclaw channels capabilities openclaw channels capabilities--channeldiscord--targetchannel:123

说明：

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

将名称解析为 ID

使用提供方目录将频道/用户名解析为 ID：

openclaw channels resolve--channelslack"#general""@jane"openclaw channels resolve--channeldiscord"My Server/#support""@someone"openclaw channels resolve--channelmatrix"Project Room"

说明：

• 使用--kind user|group|auto强制指定目标类型。
• 当多个条目共享相同名称时，解析器优先选择活动匹配。
• channels resolve是只读操作。如果所选账户通过 SecretRef 配置但该凭证在当前命令路径中不可用，该命令会返回降级的未解析结果并附带备注，而不是中止整个运行。