CLI - channels 命令

openclaw channels

管理 Gateway 上的聊天频道账号及其运行状态。支持 WhatsApp、Telegram、Discord、Slack、Signal、iMessage、Matrix、Nostr 等。

常用命令

openclaw channels list           # 列出已配置账号（含 installed/configured/enabled 状态）
openclaw channels list --all     # 含未配置的可安装频道
openclaw channels status         # 频道运行状态
openclaw channels capabilities   # 查看频道能力（intents/scopes）
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

不带参数运行 channels add 会进入交互向导，可配置账号并绑定到 Agent。

常用认证字段：

• bot-token 类：--token, --bot-token, --app-token
• Signal/iMessage：--signal-number, --cli-path, --http-url
• Matrix：--homeserver, --user-id, --access-token
• Nostr：--private-key, --relay-urls

登录 / 登出（交互式）

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

• 必须在 Gateway 宿主机终端执行，不能在 Agent exec 中调用
• 支持 --verbose
• logout 优先通过 Gateway 停止监听器，再清理本地认证状态

状态探测

openclaw channels status --probe   # 实时探测（会发起真实请求）

--probe 触发 probeAccount + auditAccount，输出包含 works/probe failed/audit ok 等结果。Gateway 不可达时降级为 config-only 摘要。

能力探测与名称解析

openclaw channels capabilities --channel discord --target channel:<voice-id>
openclaw channels resolve --channel discord "My Server/#support" "@someone"

• --kind user|group|auto 指定解析类型
• resolve 是只读操作，不安装插件

故障排查

openclaw status --deep
openclaw doctor

模型 provider 用量/配额不再显示在 channels list，改用 openclaw models list。

相关链接

• cli-nodes — 节点管理
• channels-overview — 频道概览