最近在折腾终端里的 AI 编程助手时，遇到一个叫 Pi 的项目，名字很短，思路也很有意思。它出自开源开发者 Mario Zechner（游戏引擎 libGDX 的作者），GitHub 上已经攒了 11 万多星。市面上多数 Agent 一上来就给你塞满一抽屉的工具、子代理、权限弹窗、计划模式，看着功能全，用起来反而累。Pi 反过来做——刚装好的时候，它只有 4 个工具：读文件、写文件、改文件、跑命令。剩下的能力，你想加什么，就自己加什么。

这篇文章就聊聊 Pi 到底好在哪、怎么装，以及把它跟另外两个很火的 Agent（Hermes 和 OpenClaw）放在一起比一比，看你更适合哪个。

一、Pi 的核心优点：从最小起步，按需加东西

1. 默认极简，不吓人

很多 Agent 第一次打开，扑面而来的是几十个工具、一堆弹窗确认、各种模式切换。Pi 恰恰相反，刚装完就 4 个工具。好处是直接能感受到的：命令少，不怕误操作，新手也能快速跑通；没有乱七八糟的后台动作，默认只做你明确让它做的事；也没有计划模式、一堆 to-do 列表，专注就是干。

想想看，写代码这件事，绝大多数操作确实就是"读、写、改、跑命令"这四件事。先把这四件做好，就够了。

2. 能力靠"安装包"自选

4 个工具当然不够全能。Pi 的思路是你要什么装什么。它有清晰的扩展体系：

• • Extensions（扩展）：给 Pi 加新工具。比如你觉得"跑危险命令前想让 AI 先问我一句"，可以装一个权限确认的扩展。
• • Skills（技能包）：把一组指令和工具打包在一起，用到才加载，不用的时候只占一行描述，几乎不占上下文。
• • Packages 市场：社区发了挺多现成的包，几条 pi install 命令就能装（支持 npm 包、Git 仓库，还能锁版本）。

它甚至能自己给自己写扩展。你描述一下想要什么功能，它直接帮你把插件代码写出来。内核很轻，能力却能按需往上加。

3. 模型随你挑，跟哪家都不绑死

Pi 兼容 15 家以上的模型服务商，Anthropic、OpenAI、Google、Azure、Gemini、Kimi、MiniMax，连本地跑 Ollama 都能接。挂什么 Key 就用什么模型，聊着聊着还能用 /model 指令（或 Ctrl+L）随时切模型，不用重启。切换时那段对话的"记忆"会序列化保留下来，换个模型接着聊不丢上下文。

对厂商中立这点，很多人很看重——公司里换了模型供应商，工具不用换。

4. 会话像一棵树，探索不丢

Pi 里每跑一条指令，会话记录会像树的分支一样被存下来，每一步都能回溯到任意节点。你试了路径 A，又探了路径 B，两条线都不会丢，能随时查看或回退到任何一个分支。对那种"试来试去、想翻旧账"的开发场景很顺手。

5. 还有几个用着顺手的小细节

• • 自动上下文压缩：聊长了，它自动帮你压缩上下文，避免越到后面越"忘事"。
• • 支持主题定制：终端颜色、提示语都能按喜好改。
• • 身份认证两套方案：既能用订阅账号登录，也支持 API Key 环境变量，管理密钥更灵活。

写到这，配一张信息图，把 Pi 的核心"小而美"串起来：

二、安装步骤：两条路随你挑

Pi 基于 Node 生态，通过 npm 分发。装它之前，确保机器上有 Node.js 环境。装好后，在项目目录里执行 pi 就能启动。

方式一：一键脚本（适合快速尝鲜）

curl -fsSL https://pi.com/install | sh

方式二：npm 全局安装（适合用包管理器管版本的人）

npm install -g --ignore-scripts @earendil-works/pi-coding-agent

pnpm、yarn、bun 也都能适配，把对应命令替换一下就行。

装完之后做身份认证，二选一：

• • 用你的订阅账号登录：直接跑 pi login，跟着交互提示走，适合用 Claude Pro/Max、ChatGPT Plus、GitHub Copilot 这类订阅服务的人，不用手动复制密钥。
• • 用 API Key：把密钥通过环境变量注入：

export ANTHROPIC_API_KEY="sk-ant-xxxx"
export OPENAI_API_KEY="sk-xxx"

或者也在 pi login 里把 Key 写进 ~/.pi/agent/auth.json 配置文件，省得每次开终端都重新设置一遍。

配好之后，就两个字：用起来。在目录里运行 pi，开聊。

上来就能装的安全提醒：原生 Pi 默认没有任何权限确认机制，命令它说跑就跑。正式用之前，建议先去 package 里搜个 sandbox 之类的扩展，给危险命令加上确认，心里踏实点。

三、和 Hermes、OpenClaw 放在一起比

现在开源 Agent 里，Hermes 和 OpenClaw 是讨论度比较高的两个。它们和 Pi 走的是不同路线，适合不同的人。有个绕不开的渊源：OpenClaw 底下那套跑动作的引擎，用的正是 Pi 的 Agent SDK——OpenClaw 是那只你看到的手，Pi 是背后的"神经系统"。所以这仨其实不完全是同一层的东西，比之前先知道这一点。

一句话先对比

Pi 值在哪

• • 想自己说了算，Pi 最对你的路：Pi 给你的是一个干净可控的起点。它不替你决定，装上啥全靠你自己。想把安全做成什么样子、想加什么工具，都由你掌控，规则透明。
• • 想要个越用越顺手的，Hermes 更合适：Hermes 会自动帮你构建记忆，还能自己写新技能来提升自己。它的特点是你没想到的它能替你想。代价是它跑起来更重、更自主，适合希望 Agent 主动成长的人。而这类自动记忆，对有些人来说也可能是"太主动"。
• • 想要到处都能装的，OpenClaw 更省心：OpenClaw 渠道覆盖广（iMessage、微信、桌面 App 等），内置 40+ 技能，生态大而成熟。适合需要把 Agent 放到多个聊天渠道、做规模化编排的人。但因为它重，跑起来成本也更高，启动时要管的配置更多。你要是喜欢 OpenClaw 却又嫌它重，底下的 Pi 反而是个更轻的入口。

选哪个？看你最怕什么

• • 你受不了 Agent"自作主张"、一堆后台动作 → 选 Pi，把它当个随身工具，缺啥加啥。
• • 你工作内容是"反复跑同类的活、而且希望它越跑越顺" → 可以考虑 Hermes，让它帮你自动沉淀经验。
• • 你要"在多个渠道里统一调度一堆 Agent" → 选 OpenClaw，生态最成熟，功能最全。

看下来就一个感受：Pi 让你掌控一切但东西少，Hermes 更聪明也更主动，OpenClaw 功能最全但也最重。 没有谁绝对更好，关键是哪个跟你的干活习惯合拍，最怕哪种"翻车"。

写在最后

Pi 让我最舒服的一点，是它把"不打扰"当成了默认。现在很多 AI 工具卷功能、卷全面，Pi 反而做减法：先把 4 件事做扎实，把扩展权完全交给你。

如果你用那种"功能很全"的终端 Agent 感到有点累、有点乱、有点不可控，不妨试试 Pi 这种轻的玩法。装上，跑命令，聊两句，看顺不顺眼。项目还在快速迭代，某些 API 后面可能有变动，正式项目建议锁版本。

（如果你也用哪个，欢迎评论区聊聊你更顺手的是哪个。）