openclaw channels

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

相关文档:

• 频道指南: Channels
• 网关配置: 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 显示每个频道的标志 (令牌、应用令牌、signal-cli 路径等)。

登录 / 登出 (交互式)

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 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

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