Pi的核心逻辑非常精简,它只给 AI 提供 4 个最基础的“超能力”:
Read (读):读取文件内容。
Write (写):创建或覆盖文件。
Edit (改):对代码进行精确的行级修改(而不是重写整个文件,省钱又快)。
Bash (执行):直接在你的终端运行命令(比如跑测试、安装依赖、编译代码)。
2. 核心架构设计
pi-ai:模型适配层 (Unified LLM API),屏蔽不同模型供应商(Anthropic, OpenAI, DeepSeek, Ollama 等)的 API 差异,提供统一的调用接口。
pi-agent-core:核心算法层。负责处理“观察-推理-行动”循环、管理对话上下文、分叉/回滚会话、以及定义基础工具(Read/Write/Edit/Bash)的协议。
pi-coding-agent:基于 Core 开发的完整命令行工具,也就是普通开发者直接在终端里用的那个东西。使得 OpenClaw 具备强大的代码编写与执行能力.
pi-ai = 大脑(负责连接模型进行思考) pi-agent-core = 灵魂/神经系统(负责逻辑控制和工具使用) pi-coding-agent = 身体(负责在终端与你交互,干脏活累活)
极轻量:它的系统提示词(System Prompt)非常短(通常不到 1000 tokens),运行速度极快。
无限制:它是开源且透明的,你可以完全控制它能看哪些文件、能跑什么命令。 可扩展:你可以通过 TypeScript 给它增加新的“技能(Skills)”或“扩展(Extensions)”。 自动化友好:它支持 JSON-RPC 模式,意味着你可以把它集成到你自己的脚本或 CI/CD 流程中。
4. 运行流程

// npm (Node Package Manager)# npm install -g @mariozechner/pi-coding-agent
# ollama pull qwen2.5:7b# ollama launch pi 





夜雨聆风