06-AI 编程助手实战

OpenClaw + ACP：AI 编程助手实战“让 AI 帮你写代码、调 Bug、做重构——这就是 ACP 的魔力。”在软件开发领域，如何让 AI 真正成为程序员的得力助手，而非仅仅是「代码补全工具」？OpenClaw 给出的答案是ACP（Agent Coding Protocol）。通过这一协议，OpenClaw 能够与业界顶尖的 AI 编程助手深度集成，实现从需求到代码、从 Bug 到修复的全流程智能化。本文将带你深入了解 ACP 的工作机制，并通过四个真实案例展示如何在 OpenClaw 中调用 AI 编程助手来完成各种开发任务。1. ACP（Agent Coding Protocol）详解1.1 ACP 是什么？定位与设计理念ACP（Agent Coding Protocol）是 OpenClaw 专门为 AI 编程助手设计的集成协议。它的核心定位是：建立一个统一的标准接口，让 OpenClaw 能够以「对话式」的方式调用各种 AI 编程助手的能力。传统的 AI 编程工具往往以插件或 IDE 扩展的形式存在，使用场景受限。ACP 的设计理念是将 AI 编程能力从 IDE 中解放出来，嵌入到 OpenClaw 的工作流中。这意味着你可以：通过自然语言描述需求，让 AI 生成完整代码发送一段代码让 AI 进行审查和优化建议描述一个 Bug 现象，让 AI 定位问题并给出修复方案讨论项目架构，让 AI 提供重构建议ACP 支持多种主流 AI 编程助手，包括Claude Code、Codex（GitHub Copilot 的后端）、Gemini（Google 的 AI 模型）等。通过统一的协议接口，OpenClaw 能够以相同的方式与这些不同的 AI 助手交互，极大地降低了使用门槛。1.2 与普通 API 调用的区别你可能会问：ACP 和直接调用这些 AI 模型的 API 有什么区别？让我们从多个维度来分析：特性ACP普通 API 调用交互模式持续对话，会话管理单一请求-响应上下文保持自动维护项目上下文需手动维护工具调用原生支持文件操作、命令执行需自行实现 Tool Use会话恢复支持 resumeSessionId需自行保存上下文多轮协作支持主会话与子会话协作需自行管理状态关键差异解读：会话管理（Session Management）普通 API 调用是一次性的：你发送 prompt，得到 response，结束。而 ACP 提供了完整的会话生命周期管理。AI 可以记住之前对话的内容，理解项目结构，甚至记住你之前否定的方案。# 普通 API 调用示例response=openai.chat.completions.create(model="gpt-4",messages=[{"role":"user","content":"写一个排序函数"}])# 每次调用都是独立的，无状态# ACP 会话示例# 第一次：描述需求# 第二次：让 AI 根据之前的需求修改# 第三次：继续完善——AI 记得之前的所有上下文项目上下文感知ACP 代理能够理解项目结构，包括目录布局、依赖关系、代码风格等。这意味着当你让 AI「修复那个 Bug」时，它知道指的是哪个文件、哪个函数。原生工具集成ACP 内置了对文件系统、Shell 命令、Git 操作等工具的支持。AI 不仅能生成代码，还能实际执行代码、运行测试、提交 Git。1.3 支持的 AI 编程助手ACP 目前支持多种主流 AI 编程助手，每种都有其独特优势：1. Claude Code（Anthropic）Claude Code 是 Anthropic 推出的 AI 编程助手，以其出色的代码理解能力和安全性著称。优势：代码理解深入、安全性高、上下文窗口大适用场景：复杂代码审查、安全敏感项目、大型代码库分析模型选择：claude-sonnet-4-20250514、claude-opus-4-20250514 等2. Codex（GitHub Copilot）Codex 是 GitHub Copilot 的后端模型，由 OpenAI 开发，专门针对代码生成任务优化。优势：代码生成速度快、与 GitHub 生态深度集成适用场景：快速原型开发、重复性编码任务、样板代码生成模型选择：gpt-4o、gpt-4o-mini 等3. Gemini（Google）Gemini 是 Google 的多模态 AI 模型，在代码理解方面有独特优势。优势：多模态理解、长上下文、免费额度充足适用场景：需要处理多种类型内容的任务、预算有限的个人项目模型选择：gemini-2.0-flash、gemini-2.5-pro-preview 等2. 在 OpenClaw 中调用 ACP 代理2.1 配置 ACP 连接在开始使用 ACP 之前，需要先配置与 AI 编程助手的连接。OpenClaw 支持通过配置文件或环境变量进行配置。方式一：配置文件在 OpenClaw 的配置目录创建或编辑config/acp.yaml：acp_providers:claude_code:type:anthropicapi_key:${ANTHROPIC_API_KEY}default_model:claude-sonnet-4-20250514max_tokens:8192temperature:0.7codex:type:openaiapi_key:${OPENAI_API_KEY}base_url:https://api.openai.com/v1default_model:gpt-4omax_tokens:4096temperature:0.7gemini:type:googleapi_key:${GOOGLE_API_KEY}base_url:https://generativelanguage.googleapis.com/v1betadefault_model:gemini-2.0-flashmax_tokens:4096temperature:0.7# 默认使用的 providerdefault_provider:claude_code方式二：环境变量# 至少需要配置一个 API KeyexportANTHROPIC_API_KEY="sk-ant-xxxxx"# 或者exportOPENAI_API_KEY="sk-xxxxx"# 或者exportGOOGLE_API_KEY="AIza-xxxxx"方式三：运行时指定在启动 OpenClaw 时通过参数指定：openclaw gateway start\--acp-provider claude_code\--acp-model claude-sonnet-4-202505142.2 sessions_spawn 与 runtime=“acp”在 OpenClaw 中，调用 ACP 代理的核心方式是通过sessions_spawn工具创建子会话，并指定runtime="acp"。基本语法：{"action":"spawn","session_type":"acp","provider":"claude_code","model":"claude-sonnet-4-20250514","system_prompt":"你是一个专业的后端开发工程师，擅长 Python 和 Go 语言...","initial_message":"请帮我写一个用户认证模块","working_directory":"/path/to/project","capabilities":["file_read","file_write","shell_exec"]}实际调用示例：在 OpenClaw 的对话中，你可以这样触发 ACP 代理：你: 帮我用 Python 写一个 RESTful API 用户认证模块OpenClaw 会自动识别这是一个编程任务，spawn 一个 ACP 子会话：{"action":"spawn","session_type":"acp","provider":"claude_code","system_prompt":"你是一个专业的后端开发工程师，擅长 Python 语言和 FastAPI 框架...","initial_message":"请帮我写一个 RESTful API 用户认证模块，包含登录、注册、JWT 令牌验证等功能","working_directory":"/workspace/my-project","capabilities":["file_read","file_write","shell_exec"]}参数详解：参数必填说明session_type是固定为 “acp”provider是AI 提供商：claude_code / codex / geminimodel否具体模型名称，默认使用 provider 的 default_modelsystem_prompt否给 AI 的系统提示词，定义其角色和能力initial_message是初始任务描述working_directory否AI 工作的目录，AI 会在此目录下读写文件capabilities否授予 AI 的能力列表2.3 resumeSessionId 实现会话恢复ACP 的强大之处在于其会话保持能力。通过resumeSessionId，你可以恢复之前的对话上下文，继续之前未完成的任务。使用场景：长任务中断恢复：代码生成任务因时间限制中断，下次继续多轮迭代：对生成的代码进行多轮修改跨会话协作：在主会话中引用子会话的结果工作原理：主会话 ACP 子会话 | | |--- spawn (创建新会话) ---------| | | |-- sessionId: acp-xxx --------| | | |--- resumeSessionId: acp-xxx --| | (继续之前的会话) | | |实际示例：你: 帮我写一个数据处理脚本 [ACP 子会话创建，开始生成代码...] [生成完成，但你觉得需要调整] 你: 把输出格式改成 JSON [主会话将新的消息发送给同一个 ACP 会话] [AI 记得之前生成的所有代码，只修改了输出格式部分]在代码中，这对应为：# 第一次调用：创建会话result=awaitsessions_spawn(session_type="acp",