Files

Josh Palmer a3ec2d0734 Docs: update zh-CN translations and pipeline

What:
- update zh-CN glossary, TM, and translator prompt
- regenerate zh-CN docs and apply targeted fixes
- add zh-CN AGENTS pipeline guidance

Why:
- address terminology/spacing feedback from #6995

Tests:
- pnpm build && pnpm check && pnpm test

2026-02-03 13:23:00 -08:00

2.5 KiB

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

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

快速检查

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

深度诊断

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

当出现故障时

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

专用"health"命令

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

2.5 KiB Raw Blame History Unescape Escape