夜雨聆风
OpenClaw 底层到底跑着什么?一个叫做pi-mono的 43K Star 的开源引擎
大家好，我是寂寞的熊猫。
之前聊过Hermes Agent 和 OpenClaw 各有千秋，但真的需要那么多 Agent 吗那么OpenClaw 到底凭什么能做到这些？凭什么消息推送不卡顿，凭什么长任务跑了三天还能续上？
答案藏在它底层的引擎里。
省流版
- OpenClaw 底层跑着一个叫 pi-mono 的开源引擎，GitHub 43.3K Star
- 它的设计极端到只给 AI 4 个工具：读文件、写文件、改文件、跑命令
- 这种极简反而让 OpenClaw 做到了很多别的框架做不到的事
pi-mono 不是”又一个 Agent 框架”，而是 OpenClaw 为什么能做成今天这个样子的根本原因。
三个你以为理所当然的能力
你在 OpenClaw 里感受到的丝滑体验，底层全是 pi-mono 在干活。
| 你在 OpenClaw 里感受到的 | 底层其实是 pi-mono 的 |
|---|---|
| 消息几乎实时推送，不卡顿 | 嵌入式 SDK，不走子进程管道 |
| Claude 限速了，自动切到 Gemini | 统一 LLM 抽象层 + 模型热切换 |
| 长任务跑了三天还没断 | DAG 会话管理 + 自动上下文压实 |
这三件事，每件都比你想的难得多。
实时推送。 传统做法是起一个子进程，通过管道（pipe）捕获输出。管道有缓冲区，输出是一坨一坨来的，不是一条一条的。你在终端里看到的”打字机效果”，其实只是前端做的动画，真正的后端输出早就卡在缓冲区里了。pi-mono 不走这条路，它是嵌入式 SDK，OpenClaw 通过 createAgentSession() 直接挂载到事件总线上，延迟是毫秒级的。你看到的就是它正在做的，没有中间商赚差价。
模型热切换。 大多数框架把 API Key 写死在配置文件里，限速了就报错，你得手动换 Key、换配置、重启进程。pi-mono 内部维护了 300 多个模型定义的注册表，支持 OpenAI、Anthropic、Google 四大协议标准。当你用的模型触发限速，它自动切到备用提供商，整个对话历史自动重新编译。你完全感觉不到切换发生了。这个能力在 Claude 被频繁限速的当下，几乎是刚需。
长任务不断。 传统做法是线性的对话历史，消息越积越多，迟早爆掉上下文窗口。一旦爆了，要么对话断了，要么你得手动清理历史重新来过。pi-mono 用的是树状结构（DAG），Append-Only、JSONL 格式存储。当快接近上下文上限时，自动把早期内容压缩成摘要。专业术语叫 Auto-Compaction。跑了三天的任务照样能续上，而且续上之后 Agent 还记得之前干了什么。
一句话：你以为的”理所当然”，背后全是工程上的硬骨头。而且这些硬骨头，不是靠堆功能能解决的，得靠架构。
pi-mono 到底是什么
一句话定义：一个极简的 AI Agent 运行时，MIT 开源协议，GitHub 43.3K Star，作者 Mario Zechner（代号 badlogic），一个人贡献了约 3900 次提交。最新版本 v0.71.0，2026 年 4 月 30 号刚发布。
它最核心的设计是：只给 AI 四个原子工具，Read、Write、Edit、Bash。没有搜索工具，没有数据库工具，没有邮件工具，没有你在别的框架里常见的那堆花里胡哨的集成。就这四个。
这种设计的直接好处是：系统提示词加工具定义不到 1000 个 Token。对比一下 Claude Code，初始就要吃掉数千 Token 的系统提示。Token 越少，留给真正工作的空间就越大，模型的注意力也越集中。这不是抠门，这是工程上的刻意选择。
pi-mono 一共五个包：pi-ai（统一 LLM 接口）、pi-agent-core（Agent 运行时）、pi-coding-agent（CLI SDK）、pi-tui（终端 UI）、pi-web-ui（Web 组件）。OpenClaw 用的是 createAgentSession() 直接嵌入，还通过 splitSdkTools() 把默认工具替换成自己的。这意味着 OpenClaw 不是”调用”pi-mono，而是”长在”pi-mono 上面。
| 维度 | Claude Code | pi-mono |
|---|---|---|
| 模型 | 只能用 Claude | 300+ 模型随便切 |
| 开源 | 闭源 | MIT 协议 |
| 初始 Token | 数千 | < 1000 |
| 嵌入能力 | 不能 | 可以当 SDK 嵌进你的产品 |
Claude Code 是一把精心打磨的瑞士军刀，pi-mono 是一把可以装进任何工具箱的螺丝刀。你不会拿瑞士军刀去组装一个产品，但螺丝刀可以。
不足之处
- 没有内置多 Agent 协调，想做多 Agent 得自己搞。社区里有人在做，比如 Gondolin 沙箱和 Rust 重写的 pi_agent_rust，但都还是早期项目
- 默认 YOLO 模式，没有安全护栏。AI 想删文件就删文件，想跑命令就跑命令，不会弹个确认框问你”确定吗”。得靠容器或沙箱兜底，不然就是裸奔
- 文档偏少，上手有门槛。很多设计意图得翻源码才能理解，对新手不太友好
- 核心作者就一个人（badlogic），3900 次提交几乎全是他写的。维护风险客观存在
写在最后
pi-mono 用”只给 4 个工具”的极简哲学，换来了嵌入式能力、模型热切换和超长会话管理。OpenClaw 的很多能力，本质上都是 pi-mono 。
- 如果你在用 OpenClaw，知道底层是 pi-mono 能帮你理解它的能力边界，出问题也知道往哪查，不会再觉得”怎么又报错了”
- 如果你在选 Agent 技术栈，pi-mono 的极简思路值得参考。少即是多不是口号，是工程选择。工具越少，模型越不容易犯选择困难症
- 如果你想自己做一个 Agent 产品，嵌入式 SDK 模式比 RPC 和子进程方案更值得考虑。延迟和灵活性都不是一个量级的。别再起子进程了，2026 年了
如果对AI个人提效，以及副业感兴趣，而不只是围观，也推荐加入 IDO 老徐 的知识星球：AI 落地实战 · DeepSeek · OpenClaw。
里面会持续分享 OpenClaw 相关内容、AI 工作流搭建、商业化落地和各种实战避坑经验。
