01|启动与观测闭环

这一章的目标只有一个:把系统变得“可观察”。后面所有源码/机制分析,都应该能落回到这条最短链路的日志与事件上。

最短可验证链路(建议 10 分钟内完成)

  1. 启动 Gateway(前台):
openclaw gateway
  1. 另开终端尾随日志:
openclaw logs --follow
  1. 打开 Control UI 并完成一次对话(或让任意渠道进来一条消息):
openclaw dashboard

你应该能看到什么(验收点)

至少能稳定观察到两类信号:

  1. 控制面事件:WS connect 成功后,持续出现 tick / presence 等事件(概念入口见 TypeBox)。
  2. 聊天执行chat.send 先快速 ACK(给出 runId),回复通过 chat 事件流式回传(界面入口见 Control UI)。

如果你做不到上述两点,先不要继续读“实现剖析”,优先按下面顺序排障。

常见卡点(先按入口排)

  • 看不到 Control UI:先核对 Dashboard 与网络/端口(见 Network)。
  • WS 连不上:优先读 Gateway 协议 的握手与鉴权,并用 健康检查 做最小验证。
  • 日志太少/太乱:按 日志 配置输出与过滤,再回到本章验收点复测。