Files
bot/docs/zh-CN/cli/channels.md
zeekay 08582cc303 Rebrand OpenClaw → Hanzo Bot across entire codebase
Complete rename of all OpenClaw/OPENCLAW/openclaw references to
Hanzo Bot/BOT/bot naming convention:

- Env vars: OPENCLAW_* → BOT_* (18 patterns)
- Config: ~/.openclaw/ → ~/.bot/, openclaw.json → bot.json
- Packages: @openclaw/* → @hanzo/bot-*
- Domains: openclaw.ai → hanzo.bot
- Mobile: OpenClawKit → BotKit, bundle IDs ai.openclaw → ai.hanzo.bot
- mDNS: _openclaw-gw._tcp → _bot-gw._tcp
- Docker: CMD hanzo-bot.mjs, BOT_PREFER_PNPM, BOT_DOCKER_APT_PACKAGES
- CI: docker-release.yml adds :latest tag on main branch
2026-02-11 11:13:08 -08:00

2.9 KiB
Raw Permalink Blame History

read_when, summary, title, x-i18n
read_when summary title x-i18n
你想添加/删除渠道账户(WhatsApp/Telegram/Discord/Google Chat/Slack/Mattermost(插件)/Signal/iMessage)
你想检查渠道状态或跟踪渠道日志
`hanzo-bot channels` 的 CLI 参考(账户、状态、登录/登出、日志) channels
generated_at model provider source_hash source_path workflow
2026-02-03T07:44:51Z claude-opus-4-5 pi 16ab1642f247bfa96e8e08dfeb1eedfccb148f40d91099f5423f971df2b54e20 cli/channels.md 15

hanzo-bot channels

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

相关文档:

常用命令

hanzo-bot channels list
hanzo-bot channels status
hanzo-bot channels capabilities
hanzo-bot channels capabilities --channel discord --target channel:123
hanzo-bot channels resolve --channel slack "#general" "@jane"
hanzo-bot channels logs --channel all

添加/删除账户

hanzo-bot channels add --channel telegram --token <bot-token>
hanzo-bot channels remove --channel telegram --delete

提示:hanzo-bot channels add --help 显示每个渠道的标志(token、app token、signal-cli 路径等)。

登录/登出(交互式)

hanzo-bot channels login --channel whatsapp
hanzo-bot channels logout --channel whatsapp

故障排除

  • 运行 hanzo-bot status --deep 进行全面探测。
  • 使用 hanzo-bot doctor 获取引导式修复。
  • hanzo-bot 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)以及静态功能支持:

hanzo-bot channels capabilities
hanzo-bot channels capabilities --channel discord --target channel:123

说明:

  • --channel 是可选的;省略它可列出所有渠道(包括扩展)。
  • --target 接受 channel:<id> 或原始数字频道 id,仅适用于 Discord。
  • 探测是特定于提供商的:Discord intents + 可选的频道权限;Slack bot + user scopes;Telegram bot 标志 + webhook;Signal daemon 版本;MS Teams app token + Graph roles/scopes(在已知处标注)。没有探测功能的渠道报告 Probe: unavailable。

解析名称为 ID

使用提供商目录将渠道/用户名称解析为 ID:

hanzo-bot channels resolve --channel slack "#general" "@jane"
hanzo-bot channels resolve --channel discord "My Server/#support" "@someone"
hanzo-bot channels resolve --channel matrix "Project Room"

说明:

  • 使用 --kind user|group|auto 强制指定目标类型。
  • 当多个条目共享相同名称时,解析优先选择活跃的匹配项。