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
This commit is contained in:
Josh Palmer
2026-02-03 13:23:00 -08:00
parent 9f03791aa9
commit a3ec2d0734
228 changed files with 10651 additions and 10475 deletions
+17 -17
View File
@@ -4,39 +4,39 @@ read_when:
summary: 渠道连接的健康检查步骤
title: 健康检查
x-i18n:
generated_at: "2026-02-01T20:26:10Z"
generated_at: "2026-02-03T07:47:59Z"
model: claude-opus-4-5
provider: pi
source_hash: 74f242e98244c135e1322682ed6b67d70f3b404aca783b1bb5de96a27c2c1b01
source_path: gateway/health.md
workflow: 14
workflow: 15
---
# 健康检查(CLI
验证渠道连接状态的简指南,无需猜测。
验证渠道连接的简指南,无需猜测。
## 快速检查
- `openclaw status` — 本地摘要:Gateway网关可达性/模式、更新提示、已关联渠道认证时长、会话 + 近活动。
- `openclaw status --all` — 完整本地诊断(只读、带颜色、可安全粘贴用于调试)。
- `openclaw status --deep` — 还会探测运行中的 Gateway网关(支持时进行渠道探测)。
- `openclaw health --json` — 向运行中的 Gateway网关请求完整健康快照(仅 WS;不直接访问 Baileys socket)。
- 在 WhatsApp/WebChat 中发送 `/status` 作为独立消息可获取状态回复而不触发智能体。
- 日志:尾部查看 `/tmp/openclaw/openclaw-*.log` 并过滤 `web-heartbeat``web-reconnect``web-auto-reply``web-inbound`
- `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`修改时间应为近期)。
- 会话存储:`ls -l ~/.openclaw/agents/<agentId>/sessions/sessions.json`(路径可在配置中覆盖)。计数和近期接收者可通过 `status` 查看
- 重新关联流程:当日志中出现状态码 409–515 或 `loggedOut` 时,执行 `openclaw channels logout && openclaw channels login --verbose`。(注意:QR 登录流程在配对后遇到状态 515 时会自动重一次。)
- 磁盘上的凭证:`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` 或状态 409515 → 使用 `openclaw channels logout` 然后 `openclaw channels login` 重新关联
- Gateway网关不可达 → 启动它:`openclaw gateway --port 18789`(如果端口被占用使用 `--force`)。
- 没有收到入站消息 → 确认已关联的手机在线且发送者被允许(`channels.whatsapp.allowFrom`);对于群聊,确保允许列表 + 提及规则匹配(`channels.whatsapp.groups``agents.list[].groupChat.mentionPatterns`)。
- `logged out` 或状态 409515 → 使用 `openclaw channels logout` 然后 `openclaw channels login` 重新链接
- Gateway 网关不可达 → 启动它:`openclaw gateway --port 18789`(如果端口被占用使用 `--force`)。
- 没有入站消息 → 确认已链接的手机在线且发送者被允许(`channels.whatsapp.allowFrom`);对于群聊,确保允许列表 + 提及规则匹配(`channels.whatsapp.groups``agents.list[].groupChat.mentionPatterns`)。
## 专用 "health" 命令
## 专用"health"命令
`openclaw health --json` 向运行中的 Gateway网关请求其健康快照(CLI 不直接访问渠道 socket)。它报告已关联凭证/认证时长(如可用)、渠道探测摘要、会话存储摘要和探测耗时。如果 Gateway网关不可达或探测失败/超时,以非零状态码退出。使用 `--timeout <ms>` 覆盖默认的 10 秒超时
`openclaw health --json` 向运行中的 Gateway 网关请求其健康快照(CLI 不直接访问渠道套接字)。它报告已链接凭证/认证时长(如可用)、渠道探测摘要、会话存储摘要和探测持续时间。如果 Gateway 网关不可达或探测失败/超时,以非零退出。使用 `--timeout <ms>` 覆盖默认的 10 秒。