OpenClaw 的 Pi Agent Runtime 核心

OpenClaw 的 Runtime（也叫 Agent Runtime）核心就是基于 Pi Agent 框架构建的。

Pi Agent 是由 Mario Zechner（GitHub @badlogicgames）开发的极简 TypeScript 开源 AI Agent 工具包（monorepo 项目：https://github.com/badlogic/pi-mono），它以“做极致减法”闻名，被认为是目前最高效、最轻量的 coding agent 引擎之一。OpenClaw 并没有自己从零写一套 Agent 核心逻辑，而是直接把 Pi 当作 SDK 嵌入进来，在其上叠加了多通道接入、持久记忆、技能市场、沙箱等实用层，才形成了今天这个爆火的个人 AI 助手系统。

Pi Agent 框架的核心特点（为什么这么极简却强大）

• 只内置 4 个工具
  ：read、write、edit、bash 模型就靠这四个原语操作文件系统和执行命令，就能完成绝大部分编程、运维、自动化任务。 不预装 plan、todo、multi-agent、复杂编排等“花里胡哨”的东西，一切交给用户和模型自己决定。
• 系统提示词极短
  ：通常几百 token 就能跑完整套逻辑，token 消耗比很多框架低 5–10 倍。
• 完全不依赖重型生态
  ：零 LangChain、零 LangGraph、零 LlamaIndex，纯净到极致。
• 模型完全中立
  ：支持 OpenAI、Claude、Gemini、Grok、DeepSeek、本地 Ollama/vLLM 等，随意切换。
• Session 设计
  ：append-only + 可分支（树状历史），支持随时回溯、分叉尝试不同方案，不会覆盖旧对话。
• 可扩展但不强制
  ：通过 skills、extensions 机制按需叠加功能。

Pi monorepo 主要包含以下层级包（从底层到上层）：

OpenClaw 如何把 Pi 变成自己的 Runtime

OpenClaw 采用“嵌入式”方式集成 Pi，而不是 subprocess 或 RPC 调用：

1. Gateway 层
   （OpenClaw 自研） 负责 Telegram、WhatsApp、Discord、Slack、Web、CLI 等多渠道消息路由、鉴权、队列管理、激活模式（main/group/agent 等）。
2. Embedded Pi Runtime
   （核心执行部分）
• 直接 import { createAgentSession } from 'pi-coding-agent' 创建 session
• 所有操作限制在单一 workspace 目录（默认 ~/.openclaw/workspace/）
• 支持工具流式输出、块式输出
• OpenClaw 在 Pi 原生工具上额外封装了：浏览器控制、消息发送、ClawHub 技能调用、持久化记忆文件等
3. 记忆 & 个性实现
   （全靠纯文本，零数据库）
• SOUL.md：角色设定与个性
• AGENTS.md：行为规则与约束
• TOOLS.md：工具使用约定
• MEMORY.md：长期记忆积累 这种设计让整个 Runtime 极其轻量，能轻松跑在 Mac Mini、VPS、甚至 Raspberry Pi 4/5 上，实现 24/7 常驻。

为什么很多人把 Pi 称为“工业级极简”的代表？

• Token 效率极高，同任务省 token 严重
• Prompt 短而清晰，模型遵循性强
• 工程细节扎实：故障恢复、模型 fallback、工具死循环检测等
• 社区扩展性好，已有很多基于 Pi 做的定制 Agent

想自己上手或二次开发的话，推荐路径：

• Pi 原仓库：https://github.com/badlogic/pi-mono
• OpenClaw 主仓库：https://github.com/openclaw/openclaw
• 官方文档中 Pi 整合部分：https://docs.openclaw.ai/pi 或 /concepts/agent

如果你想深入某个具体点，比如 Pi 的 Agent Loop 代码实现、OpenClaw 如何扩展工具、Raspberry Pi 部署步骤、内存文件工作原理等，随时告诉我，我可以继续细讲！