mirror of https://github.com/hanzoai/bot.git synced 2026-11-01 07:38:30 +00:00

Files

T

zeekay 6e661b15d3 rebrand: complete OpenClaw→Hanzo Bot cleanup across 424 files

- Rename lobster extension → flow (dir, types, env vars, docs)
- LOBSTER_* env vars → BOT_FLOW_* / BOT_*
- 🦞 → 🤖 everywhere (src, docs, skills, zh-CN)
- docs.bot.ai → docs.hanzo.bot
- github.com/bot/bot → github.com/hanzoai/bot
- @bot/* → @hanzo/bot-* (npm scope)
- ~/.bot/ → ~/.hanzo/bot/ (config paths)
- discord.gg/hanzo → discord.gg/XthHQQj (real Hanzo Discord)
- clawhub.com → skills.hanzo.bot
- ClawDock → BotDock in shell helpers
- EXFOLIATE lore → Hanzo Bot branding in all locales
- LOBSTER_PALETTE → BOT_PALETTE, LOBSTER_ASCII → BOT_ASCII

2026-02-13 13:22:53 -08:00

2.5 KiB

Raw Permalink Blame History

read_when, summary, title, x-i18n

read_when

summary

title

x-i18n

诊断 WhatsApp 渠道健康状况

渠道连接的健康检查步骤

健康检查

generated_at	model	provider	source_hash	source_path	workflow
2026-02-03T07:47:59Z	claude-opus-4-5	pi	74f242e98244c135e1322682ed6b67d70f3b404aca783b1bb5de96a27c2c1b01	gateway/health.md	15

健康检查（CLI）

验证渠道连接的简短指南，无需猜测。

快速检查

hanzo-bot status — 本地摘要：Gateway 网关可达性/模式、更新提示、已链接渠道认证时长、会话 + 最近活动。
hanzo-bot status --all — 完整本地诊断（只读、彩色、可安全粘贴用于调试）。
hanzo-bot status --deep — 还会探测运行中的 Gateway 网关（支持时进行每渠道探测）。
hanzo-bot health --json — 向运行中的 Gateway 网关请求完整健康快照（仅 WS；不直接访问 Baileys 套接字）。
在 WhatsApp/WebChat 中单独发送 /status 消息可获取状态回复，而不调用智能体。
日志：跟踪 /tmp/bot/bot-*.log 并过滤 web-heartbeat、web-reconnect、web-auto-reply、web-inbound。

深度诊断

磁盘上的凭证：ls -l ~/.hanzo/bot/credentials/whatsapp/<accountId>/creds.json（mtime 应该是最近的）。
会话存储：ls -l ~/.hanzo/bot/agents/<agentId>/sessions/sessions.json（路径可在配置中覆盖）。计数和最近收件人通过 status 显示。
重新链接流程：当日志中出现状态码 409–515 或 loggedOut 时，执行 hanzo-bot channels logout && hanzo-bot channels login --verbose。（注意：配对后状态 515 时 QR 登录流程会自动重启一次。）

当出现故障时

logged out 或状态 409–515 → 使用 hanzo-bot channels logout 然后 hanzo-bot channels login 重新链接。
Gateway 网关不可达 → 启动它：hanzo-bot gateway --port 18789（如果端口被占用则使用 --force）。
没有入站消息 → 确认已链接的手机在线且发送者被允许（channels.whatsapp.allowFrom）；对于群聊，确保允许列表 + 提及规则匹配（channels.whatsapp.groups、agents.list[].groupChat.mentionPatterns）。

专用"health"命令

hanzo-bot health --json 向运行中的 Gateway 网关请求其健康快照（CLI 不直接访问渠道套接字）。它报告已链接凭证/认证时长（如可用）、每渠道探测摘要、会话存储摘要和探测持续时间。如果 Gateway 网关不可达或探测失败/超时，它以非零退出。使用 --timeout <ms> 覆盖默认的 10 秒。

2.5 KiB Raw Permalink Blame History Unescape Escape