OpenClaw 术语表：新手沟通与排障必备

术语统一是团队效率的起点。很多排障失败，不是技术太难，而是沟通词汇不一致。

1) 核心术语与实战解释

• Gateway：消息与模型请求的核心网关进程。
  实战判断：openclaw status 不是 running，优先修 Gateway。
• Channel：机器人通道，如 Telegram / 飞书 / Discord。
  实战判断：Gateway 正常但机器人无回复，优先查 Channel。
• Allowlist：允许访问机器人的用户或群组名单。
  实战判断：只有你收不到回复而别人正常，多半是 allowlist。
• Fallback Model：主模型失败时自动切换的备用模型。
  实战判断：主模型 429/5xx 时，能否自动降级决定可用率。
• Health Check：健康检查，用于判断服务可用性。
  实战判断：值班交接先跑 openclaw health。
• Rate Limit：调用频率限制，超出后常见 429。
  实战判断：高峰期大量 429，先控并发再排查。
• Retry：失败重试机制。
  实战判断：重试太多会放大延迟，建议限制次数。

2) 三层排障话术（团队统一模板）

建议团队在群里按这个模板报障：

层级：Gateway / Channel / Model
现象：
复现步骤：
错误码：
已尝试动作：

这样能避免“只说不行了”的低效沟通。

3) 新人入组 10 分钟术语训练

1. 先读本术语表
2. 跑一遍 openclaw status 与 openclaw health
3. 模拟一次“Bot 不回复”排障
4. 按模板输出一次故障报告

4) 术语与命令映射表

5) 推荐动作

把本术语表放进团队 wiki 首页，并在值班手册里加入“术语与命令映射表”，让新人第一天就能独立排查基础问题。