编者按:当我们惊叹于OpenClaw仿佛“活过来”般的自主行为时,我们究竟在惊叹什么——是模型真的拥有了某种意识,还是我们被某种精妙的工程机制“欺骗”了?
今天为大家带来的这篇文章,作者给出了一个清晰而坚定的答案:OpenClaw 的“自主性”并非源于神秘的涌现能力,而是一套严谨、可解释的事件驱动架构所带来的工程成果。
本文深入技术底层,为读者抽丝剥茧地解析了 OpenClaw 的核心架构。文章首先厘清了 OpenClaw 的本质 —— 一个围绕集中式控制平面构建的事件驱动状态机,而非具备感知能力的后台大脑。随后,作者详细拆解了网关作为“中央路由器”如何通过会话键实现隔离,利用 lane-aware FIFO 队列避免并发冲突,以及如何通过统一的 WebSocket 协议协调多端通信。最为关键的是,文章揭示了让智能体产生“活着”这一错觉的真实原因:心跳、Webhooks 等多种输入类型触发的事件循环,而非某种灵光一现。最后,作者还从安全角度出发,针对这一高权限系统的潜在风险提供了务实的加固建议。
作者 | Vinoth Govindarajan
编译 | 岳扬
## 大多数 AI 智能体的演示看起来神奇无比,就像魔法一样。
而 OpenClaw 给人的感觉是真正的“自主运行”。
但在技术底层,它并非依靠魔法 —— 而是一套严谨的事件驱动机制。
OpenClaw 是一款可自托管、开源的个人 AI 助手,与典型的聊天应用相比,它更贴近你的操作系统。它不在浏览器标签页里与你对话,而是直接接入你正在使用的通讯渠道(WhatsApp、Telegram、Slack、Discord、iMessage、WebChat 等),并能通过工具执行实际的操作。
很多人把 OpenClaw 描述为“自主的”或“始终在线的”。最简单的理解方式是:
OpenClaw 的“主动行为”并不是因为它有“自我意识”或像人一样会“睡醒然后开始思考”。它之所以给人主动感,是因为它能接收的输入类型远不止你的消息 —— 并且通过一个持续的循环对所有这些输入进行处理。
这便是其架构设计的奥秘所在。
01
OpenClaw 是什么(以及不是什么)
它是什么:
- 网关(控制平面),负责接收来自四面八方的各类事件并进行路由分发。
- 智能体运行时(Agent runtime),能够执行“轮次操作”:调用大语言模型、使用工具、写入状态,并回复。
OpenClaw 的官方文档将网关 WebSocket 协议描述为统一的控制平面,所有客户端(命令行界面、网页界面、macOS 应用、iOS/Android 节点等)都通过它连接。
它不是什么:
- 一个有感知能力的系统。
- 一个在后台持续运转的推理大脑。
如果它看起来像是“在凌晨 3 点灵光一闪”,通常只是因为某个定时器、计划任务、网络钩子(webhook)或系统钩子(hook)在凌晨 3 点触发了一个事件,然后智能体执行了一轮正常的处理流程。
02
整体架构:以网关为中心的星型拓扑
如果你更喜欢可视化内容,下面这张图展示了整个架构:
OpenClaw 本质上是一个围绕集中式控制平面构建的、事件驱动的、会话隔离的单写入状态机。
核心思想:网关(Gateway)是流量调度器和唯一事实来源。智能体运行时(agent runtime)是负责“思考与执行”的工作单元。
03
网关:中央路由器(以及事实来源)
OpenClaw 运行着一个持续在线的网关守护进程,负责维持所有连接并协调整个系统。文档中明确指出:
- 所有会话状态均由网关管理
- UI 客户端应通过查询网关来获取信息,而不是直接读取本地的会话文件
3.1 会话(Sessions):隔离是刻意的(并且是可配置的)
当你从不同的场景(私信与群聊、Telegram 与 Slack 等)与 OpenClaw 对话时,你肯定不希望发生意外的上下文泄露。OpenClaw 通过会话键(session keys)来建模这一需求。
会话模型(session model)非常灵活,但其默认逻辑是:
- 每个智能体实例,默认会拥有一个“类似于私信”的主会话,这个会话通常被命名为 main。
- 针对群组/频道/话题则有独立的会话
- 可选的“安全私信模式”,按发送者/频道/账号隔离私聊会话,避免不同用户间的上下文泄露
一个简单的思维模型:
如果你部署 OpenClaw 不只是给自己用,那么安全私信模式就很重要 —— 因为默认情况下,私信的作用域会让所有私信共享同一个会话上下文以保持连续性,除非你另行配置。
3.2 会话状态的实际存储位置
OpenClaw 将会话记录以 JSONL 格式存储在磁盘上,并维护一个存储文件,用于将会话键(session keys)映射到具体的会话 ID 和元数据。文档中显示的路径如下:
- 存储文件:~/.openclaw/agents/
/sessions/sessions.json - 会话记录:~/.openclaw/agents/
/sessions/ .jsonl
这部分内容很重要,原因有二:
1)持久性:会话在系统重启后依然存在
2)安全性:这些文件可能包含敏感内容
04
队列:OpenClaw 如何防止“两种想法同时碰撞”
如果多个输入几乎同时到达(一条 Slack 私信 + 一个心跳信号 + 一个 webhook),你肯定不希望并发运行导致同一会话文件或工具状态被破坏。
OpenClaw 通过 lane-aware FIFO 队列来解决这个问题:
- 它保证每个会话只有一个活跃运行
- 它仍然允许跨不同会话的并行处理,直到达到配置上限
以下是该队列工作原理的简化示意图:
OpenClaw 还支持不同的队列行为(“模式”),例如:
- collect(…