官方网站:http://openclaw.ai/ · 本站基于官网内容整理更适合新手的安装、部署与排障指南

FastOpenClaw OpenClaw 快速安装与部署指南

教程

OpenClaw 如何工作:从消息输入到模型回复的完整链路

解释 OpenClaw 的核心工作流程,帮助你快速定位故障点。

继续查看

安装、排障和深入阅读最常用的入口都在这里。

理解链路,是降低排障成本最快的方法。

标准链路

  1. 用户在机器人通道发送消息。
  2. OpenClaw 网关接收并解析上下文。
  3. 路由层选择模型与技能。
  4. 模型返回结果。
  5. OpenClaw 将结果回写到通道。

每一层最常见故障

通道层

  • Token 无效
  • 用户不在 allowlist

路由层

  • 模型名写错
  • 配置项拼写错误

模型层

  • 401/403 权限错误
  • 429 频率限制

你可以这样快速定位

openclaw status
openclaw health
openclaw logs --tail 120

先判断是“通道没进来”,还是“模型没出去”。不要一上来就改一堆参数。

进阶建议

  • 为每个环境保留一份“最小可用配置”。
  • 每次变更只改一个变量并记录结果。
  • 有条件就上告警,避免问题积累到不可逆。