OpenClaw 使用指南：部署与验收检查清单

为什么需要“部署清单”

OpenClaw 是常驻 Gateway 服务，一旦上线错误，影响的是持续的消息与自动化。所以部署要“像上线生产系统”一样严谨。

上线前检查（核心 5 项）

1. Gateway 可启动：服务正常运行，无报错
2. Control UI 可访问：本地或远程能打开控制面板
3. Auth & API Key：认证可用，模型能正常调用
4. 频道已连通：至少一个频道收发正常
5. SessionKey 规则验证：DM 与群组隔离生效

上线后验收（核心 3 项）

1. Cron/Heartbeat 跑通：至少一个定时任务成功
2. Webhook 可触发：外部事件可唤醒代理
3. 日志与回滚：日志可查、配置可恢复

常见风险点

• 群组权限未配置：默认 requireMention 导致“不回复”
• 路由绑定错误：消息进入错误 Agent
• Cron 未持久化：重启后任务丢失（注意 ~/.openclaw/cron/jobs.json）

小结

OpenClaw 的上线不是一次性部署，而是“持续运行系统”。 用清单做验收，能有效避免隐形故障与上线翻车。