Files
bot/docs/zh-CN/channels/troubleshooting.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

1.5 KiB
Raw Permalink Blame History

read_when, summary, title, x-i18n
read_when summary title x-i18n
渠道已连接但消息无法流通
排查渠道配置错误(意图、权限、隐私模式)
渠道专属故障排除快捷指南(Discord/Telegram/WhatsApp) 渠道故障排除
generated_at model provider source_hash source_path workflow
2026-02-01T19:58:09Z claude-opus-4-5 pi 6542ee86b3e50929caeaab127642d135dfbc0d8a44876ec2df0fff15bf57cd63 channels/troubleshooting.md 14

渠道故障排除

首先运行:

hanzo-bot doctor
hanzo-bot channels status --probe

channels status --probe 会在检测到常见渠道配置错误时输出警告,并包含小型实时检查(凭据、部分权限/成员资格)。

渠道

Telegram 快速修复

  • 日志显示 HttpError: Network request for 'sendMessage' failed 或 sendChatAction → 检查 IPv6 DNS。如果 api.telegram.org 优先解析为 IPv6 而主机缺少 IPv6 出站连接,请强制使用 IPv4 或启用 IPv6。参见 /channels/telegram#troubleshooting。
  • 日志显示 setMyCommands failed → 检查到 api.telegram.org 的出站 HTTPS 和 DNS 可达性(常见于限制严格的 VPS 或代理环境)。