夜雨聆风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 调用：
- Gateway 层
（OpenClaw 自研） 负责 Telegram、WhatsApp、Discord、Slack、Web、CLI 等多渠道消息路由、鉴权、队列管理、激活模式（main/group/agent 等）。 - Embedded Pi Runtime
（核心执行部分） 直接 import { createAgentSession } from 'pi-coding-agent' 创建 session 所有操作限制在单一 workspace 目录（默认 ~/.openclaw/workspace/） 支持工具流式输出、块式输出 OpenClaw 在 Pi 原生工具上额外封装了：浏览器控制、消息发送、ClawHub 技能调用、持久化记忆文件等 - 记忆 & 个性实现
（全靠纯文本，零数据库） 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 部署步骤、内存文件工作原理等，随时告诉我，我可以继续细讲！
