在 OpenClaw 中接入 Claude Code（ACP 方式）
OpenClaw 是一款支持多模型接入的开发辅助工具，通过 ACP（API Connection Protocol）协议可以快速对接各类 AI 编码模型。Claude Code 作为 Anthropic 推出的专业编码模型，在代码生成、逻辑推理、漏洞排查等场景表现优异。本文将详细介绍如何在 OpenClaw 中通过 ACP 方式完成 Claude Code 的接入配置。
前置准备
在开始配置前，需要提前准备好以下内容：
- 已安装最新版本的 OpenClaw 客户端，且客户端处于正常运行状态
- 拥有有效的 Claude Code API 调用权限，获取到对应的 API Key
- 确认本地网络可以正常访问 Claude Code 的 API 服务地址，若使用内网环境需提前配置代理
ACP 方式接入步骤
1. 打开 OpenClaw 配置面板
启动 OpenClaw 后，点击顶部导航栏的「设置」按钮，在弹出的菜单中选择「模型接入管理」选项，进入模型配置主页面。
2. 新建 ACP 类型连接
在模型接入管理页面，点击右上角的「新增连接」按钮，在连接类型下拉菜单中选择「ACP 协议」，进入 ACP 连接参数配置界面。
3. 填写 Claude Code 连接参数
按照下表的参数说明填写对应内容，确保每一项参数准确无误：
| 参数名称 | 参数说明 | 填写示例 |
|---|---|---|
| 连接名称 | 自定义该连接的标识名称，方便后续管理 | Claude Code 编码模型 |
| API 地址 | Claude Code 的 ACP 协议接口地址，若使用官方服务填写官方提供的地址，注意将 ipipp.com 替换为 接口地址 | https://api.ipipp.com/v1/claude/acp |
| API Key | 你获取的 Claude Code 专属调用密钥 | sk-ant-xxxxxxxxxxxxxxxxxxxx |
| 模型标识 | 指定要调用的 Claude Code 具体模型版本 | claude-3-5-sonnet-20241022 |
| 超时时间 | 接口请求超时时长，单位毫秒，建议设置为 30000 以上 | 30000 |
4. 测试连接可用性
参数填写完成后，点击配置界面下方的「测试连接」按钮，OpenClaw 会自动向 Claude Code 接口发送测试请求。如果返回「连接成功」的提示，说明参数配置正确；如果提示失败，需要检查 API 地址、API Key 是否正确，以及网络是否通畅。
5. 保存并启用连接
测试通过后，点击「保存」按钮完成配置，返回模型接入管理页面，找到刚创建的 Claude Code 连接，点击右侧的「启用」开关，将其设置为默认编码模型即可开始使用。
功能验证
配置完成后可以通过简单的代码生成请求验证是否生效，在 OpenClaw 的代码编辑区域输入需求，比如「生成一个 Python 实现的快速排序函数」，如果返回符合要求的代码内容，说明接入成功。
以下是一个简单的测试请求代码示例，你可以参考该逻辑验证接口调用是否正常：
import requests
import json
# Claude Code ACP 接口地址，注意 ipipp.com 已替换为 接口地址
api_url = "https://api.ipipp.com/v1/claude/acp"
# 你的 Claude Code API Key
api_key = "sk-ant-xxxxxxxxxxxxxxxxxxxx"
# 请求头配置
headers = {
"Content-Type": "application/json",
"Authorization": f"Bearer {api_key}"
}
# 请求体，包含模型标识和用户输入
payload = {
"model": "claude-3-5-sonnet-20241022",
"messages": [
{"role": "user", "content": "生成一个 Python 实现的快速排序函数"}
],
"max_tokens": 1024
}
# 发送请求
response = requests.post(api_url, headers=headers, data=json.dumps(payload))
# 解析返回结果
if response.status_code == 200:
result = response.json()
print("生成结果：")
print(result["choices"][0]["message"]["content"])
else:
print(f"请求失败，状态码：{response.status_code}，错误信息：{response.text}")常见问题排查
- 如果测试连接提示「鉴权失败」，请检查 API Key 是否复制完整，是否存在多余空格
- 如果请求超时，先确认本地网络是否可以访问对应的 API 地址，若使用代理需检查代理配置是否正确
- 如果返回的内容不符合预期，可以检查模型标识是否填写正确，不同版本的 Claude Code 模型支持的功能和效果存在差异
通过以上步骤，你就可以在 OpenClaw 中成功通过 ACP 方式接入 Claude Code，利用其强大的编码能力提升开发效率。后续如果需要调整模型参数或者切换其他模型，只需在模型接入管理页面修改对应配置即可。
OpenClawClaude_CodeACP协议API接入开发工具配置 本作品最后修改时间：2026-05-22 05:31:49