乐于分享
好东西不私藏

简化版OpenClaw (pi-coding-agent)

简化版OpenClaw (pi-coding-agent)
   安装运行OpenClaw的复杂之处在于它涉及聊天应用,Gateway,大模型等的配置。使用pi-coding-agent,可以去除聊天应用,Gateway,让使用变得简单一点。
pi-coding-agent(通常简称为 Pi是一个由 OpenClaw 团队开发的极简主义命令行AI Coding Agent
   1. 极简主义哲学(四件套工具)

   Pi的核心逻辑非常精简,它只给 AI 提供 4 个最基础的超能力

  • Read ():读取文件内容。

  • Write ():创建或覆盖文件。

  • Edit ():对代码进行精确的行级修改(而不是重写整个文件,省钱又快)。

  • Bash (执行):直接在你的终端运行命令(比如跑测试、安装依赖、编译代码)。

   2. 核心架构设计

Pi 的项目采用了模块化的设计,主要由以下几个 npm 包组成:
  • pi-ai模型适配层 (Unified LLM API),屏蔽不同模型供应商(Anthropic, OpenAI, DeepSeek, Ollama 等)的 API 差异,提供统一的调用接口。
  • pi-agent-core:核心算法层。负责处理观察-推理-行动循环、管理对话上下文、分叉/回滚会话、以及定义基础工具(Read/Write/Edit/Bash)的协议。
  • pi-coding-agent:基于 Core 开发的完整命令行工具,也就是普通开发者直接在终端里用的那个东西。使得 OpenClaw 具备强大的代码编写与执行能力.
这三者之间的关系: pi-coding-agent基于pi-agent-core调用pi-ai LLM API
   如果把一个 AI 助手比作一个
  • pi-ai = 大脑(负责连接模型进行思考)
  • pi-agent-core = 灵魂/神经系统(负责逻辑控制和工具使用)
  • pi-coding-agent = 身体(负责在终端与你交互,干脏活累活)
   3. 为什么开发者喜欢它?
  • 极轻量:它的系统提示词(System Prompt)非常短(通常不到 1000 tokens),运行速度极快。
  • 无限制:它是开源且透明的,你可以完全控制它能看哪些文件、能跑什么命令。
  • 可扩展:你可以通过 TypeScript 给它增加新的技能(Skills扩展(Extensions
  • 自动化友好:它支持 JSON-RPC 模式,意味着你可以把它集成到你自己的脚本或 CI/CD 流程中。

   4. 运行流程

   当用户通过聊天工具向 OpenClaw 发送指令时,消息流向如下:
    5. pi-coding-agent 安装
// npm (Node Package Manager)# npm install -g @mariozechner/pi-coding-agent 
   安装pi-coding-agent时,npm 会自动下载另外两个组件(pi-ai, pi-agent-core)作为底层依赖。
6. 安装ollama
   请参考树莓派3B 安装Ollama并运行tinyllama模型
   安装完以后,请安装千问大模型,在本地运行大模型,确保私有数据不外泄。
# ollama pull qwen2.5:7b
 7. 运行
ollama launch pi  或者pi --model qwen2.5:7b
# ollama launch pi 
   单独运行pi,从运行流程看,直接从第2步我们自己给pi coding agent 输入请求,而不是通过用户 -> 聊天工具 -> OpenClaw Gateway -> pi agent core
   1) 选择模型 qwen2.5:7b
   2) 开始对话, 请求检查C语言文件hello.c,读文件的能力
   3) 修复错误,修改文件的能力
   4) 运行Bash命令 ls,运行Bash的能力
   5) 删除某个文件,在删除之前,会请求用户确认,来保证系统安全。