OpenClaw 中文教程站

1. 什么是 Pi

Pi（Programming Interface）是一个轻量级的 AI 编程助手代理，它可以连接各种 AI 模型（如 Kimi、Claude、GPT 等），让你在终端或 IDE 中直接与 AI 对话编程。

与其他编程助手相比，Pi 的特点是：

🔌 模型无关 - 支持 Kimi、Claude、GPT 等多种模型
🚀 轻量快速 - 比 Claude Code 更轻量，启动更快
📝 文件感知 - 自动读取项目文件作为上下文
⚡ 命令执行 - 可以直接执行终端命令
🔄 Git 集成 - 自动获取 git 信息作为上下文

2. 为什么选择 Kimi

Kimi（月之暗面）是国内领先的 AI 大模型，在编程任务上表现出色：

💰 性价比高 - 价格比 GPT-4 便宜很多，效果接近
🌐 国内访问 - 无需代理，国内网络可直接访问
📚 长上下文 - 支持 200K token 上下文，适合大项目
💻 编程能力强 - 代码理解、生成、调试能力优秀

💡 对比 Claude Code：Claude 3.5 Sonnet 的代码能力确实很强，但需要 $20/月订阅。Kimi 按量付费，轻度使用每月只需几块钱。

3. 环境准备

在开始之前，请确保：

✅ 已安装 OpenClaw（参考入门指南）
✅ 已有 Kimi API 密钥（platform.moonshot.cn 申请）
✅ Node.js 18+ 和 npm

4. 安装 Pi

Pi 可以通过 npm 全局安装：

npm install -g @openclaw/pi

验证安装：

pi --version

5. 配置 OpenClaw

编辑 OpenClaw 配置文件，添加 Kimi 模型支持：

code ~/openclaw-workspace/openclaw.json

添加 Kimi 模型配置：

{"version": "1.0", "gateway": {"host": "0.0.0.0", "port": 3000}, "models": {"default": "kimi", "providers": {"kimi": {"type": "openai-compatible", "baseUrl": "https://api.moonshot.cn/v1", "apiKey": "${KIMI_API_KEY}", "model": "kimi-k2-latest", "temperature": 0.3, "maxTokens": 4096}}}}

编辑环境变量文件：

code ~/openclaw-workspace/.env

KIMI_API_KEY=sk-your-kimi-api-key-here

启动 OpenClaw Gateway：

cd ~/openclaw-workspace openclaw gateway start

6. 配置 Pi

在项目目录下创建 Pi 配置文件：

cd your-project-directory pi init

这会创建一个 .pi/ 目录和基础配置。

编辑 Pi 配置：

code .pi/config.json

{"agent": "kimi", "model": "kimi-k2-latest", "baseUrl": "http://localhost:3000/api/v1", "apiKey": "local", "temperature": 0.3, "maxTokens": 4096, "context": {"includeFiles": true, "includeGit": true, "maxFileSize": 100000}}

配置说明

参数	说明	推荐值
agent	AI 代理类型	kimi / openai / anthropic
temperature	创造性程度	0.3（代码用低值）
includeFiles	自动包含项目文件	true
includeGit	包含 Git 信息	true

7. 使用方法

基础对话

# 启动 Pi pi # 直接提问 pi "如何优化这个函数的性能？" # 多轮对话 pi chat

文件操作

# 读取文件并提问 pi -f src/utils.js "解释这个函数的作用" # 读取多个文件 pi -f src/api.js -f src/db.js "这两个文件如何交互？" # 生成代码并保存 pi "生成一个 JWT 验证中间件" -o src/middleware/auth.js

命令执行

# AI 建议命令 pi "运行测试并检查失败的用例" # AI 执行命令（需确认） pi "安装 lodash 包" --exec

代码重构

# 重构单个文件 pi -f old-code.js "使用 async/await 重写这段代码" -o new-code.js # 批量重构 pi "将所有 var 改为 const/let" --apply

8. 最佳实践

提示词技巧

💡 给 AI 足够的上下文
不要只说"修复 bug"，要说"这个函数在处理空数组时返回 undefined，应该返回空数组"

# ❌ 不好的提示 "优化这段代码" # ✅ 好的提示 "这段代码在数组很大时性能很差（O(n²)），请优化到 O(n log n)， 保持功能不变，添加必要的注释"

工作流建议

先描述再编码
让 AI 先给出方案描述，确认后再生成代码
小步快跑
一次只让 AI 处理一个函数或一个小功能
及时验证
AI 生成的代码要立即测试，有问题及时反馈
保持 Git 提交
重要修改前先 commit，方便回滚

成本控制

Kimi API 按 token 计费，合理使用可以大幅降低成本：

使用 temperature: 0.3 减少随机性，避免重复生成
限制 maxTokens 避免生成过长内容
精确指定要处理的文件，避免读取整个项目
复杂任务拆分成多个小任务

🎉 配置完成！现在你已经拥有了一个强大的 AI 编程助手。相比 Claude Code 的 $20/月，这套方案按量付费，轻度使用每月只需几元钱。

Pi + Kimi 编程助手配置教程