01|启动与观测闭环
这一章的目标只有一个:把系统变得“可观察”。后面所有源码/机制分析,都应该能落回到这条最短链路的日志与事件上。
最短可验证链路(建议 10 分钟内完成)
- 启动 Gateway(前台):
openclaw gateway- 另开终端尾随日志:
openclaw logs --follow- 打开 Control UI 并完成一次对话(或让任意渠道进来一条消息):
openclaw dashboard你应该能看到什么(验收点)
至少能稳定观察到两类信号:
- 控制面事件:WS
connect成功后,持续出现tick/presence等事件(概念入口见 TypeBox)。 - 聊天执行:
chat.send先快速 ACK(给出runId),回复通过chat事件流式回传(界面入口见 Control UI)。
如果你做不到上述两点,先不要继续读“实现剖析”,优先按下面顺序排障。
常见卡点(先按入口排)
- 看不到 Control UI:先核对 Dashboard 与网络/端口(见 Network)。
- WS 连不上:优先读 Gateway 协议 的握手与鉴权,并用 健康检查 做最小验证。
- 日志太少/太乱:按 日志 配置输出与过滤,再回到本章验收点复测。