pi-mono：4万Star的Agent底层框架研究指南 ​

OpenClaw 的核心运行时就是基于 Pi 的 SDK 构建的。如果你想开发属于自己的 Agent，这个项目值得研究透彻。

项目简介 ​

pi-mono 是一个 TypeScript 单仓项目，专门用来构建 AI Agent 和管理 LLM 部署。

核心产品 Pi：跑在终端里的编程 Agent，读文件、写文件、编辑代码、执行命令。

作者：Mario Zechner（网名 badlogic），libGDX 游戏框架作者。

开源地址：github.com/badlogic/pi-mono

Pi 的极简哲学 ​

核心工具（只有4个） ​

系统提示词不到 1000 token，是所有主流 Agent 里最短的。

刻意没有内置 ​

• 没有 MCP
• 没有子 Agent
• 没有权限弹窗
• 没有 Plan 模式
• 没有内置 Todo
• 没有后台 Bash

这些功能通过 Extensions、Skills、Packages 按需扩展。

架构拆解：七个包各司其职 ​

每个包都可以独立使用。

核心特性 ​

1. 20+ LLM 提供商统一接入 ​

支持的提供商：OpenAI、Anthropic、Google、Azure、Kimi、MiniMax、Hugging Face 等。

两种认证方式：

• API Key
• OAuth 订阅登录（直接用 Claude Pro/ChatGPT Plus）

2. Sessions 树状分支 ​

会话用 JSONL 文件存储，每个条目有 id 和 parentId，形成树状结构。

• /tree 查看完整对话树
• 折叠、展开、搜索、跳转
• 像 Git 一样管理对话历史

3. Extensions 扩展机制 ​

自定义工具、命令、快捷键、UI 组件，甚至替换内置工具。

4. Skills 技能系统 ​

遵循 Agent Skills 标准，一个 Markdown 文件就是一个技能。

5. Pi Packages 生态 ​

pi install npm:@foo/pi-tools
pi install git:github.com/user/repo

6. 四种运行模式 ​

7. 上下文压缩 ​

长会话自动/手动压缩，旧消息总结精简，最近对话保持原样。

5分钟上手 ​

安装 ​

npm install -g @mariozechner/pi-coding-agent

设置 API Key ​

export ANTHROPIC_API_KEY=sk-ant-...

或用订阅登录 ​

pi
# 输入 /login，选择提供商，浏览器授权

常用快捷键 ​

与 Claude Code 对比 ​

社区特色 ​

贡献机制 ​

• 新贡献者 Issue/PR 默认关闭
• 维护者每天审核后重新打开
• 通过 lgtmi → lgtm 晋升

唯一规则：必须理解你的代码。

OSS Session 分享 ​

鼓励用户把真实编程会话数据发布到 Hugging Face，作者已公开 627+ 条工作会话。

总结 ​

最简洁的底层，支撑起最复杂的应用。

关键词：pi-mono, OpenClaw底层, Agent框架, pi-ai, pi-agent-core, Mario Zechner