OpenClaw + Claude Code 编程指南#

让你的 OpenClaw 龙虾变成编程助手——通过消息平台直接驱动 Claude Code 写代码。

两种集成模式#

模式适合场景优点要求ACP 模式（推荐）日常编程、持久会话在飞书/Discord 里直接聊天编程，支持持久会话安装 acpx 插件PTY 后台模式一次性任务、CI/CD灵活，不需要额外插件Claude Code CLI 已安装

---

一、ACP 模式（推荐）#

前提安装#

bash

# 1. 安装 Claude Code CLI
npm install -g @anthropic-ai/claude-code

# 2. 配置 API Key（二选一）
# 方式 A：Anthropic 官方 API（按量付费）
export ANTHROPIC_API_KEY="sk-ant-xxxxx"

# 方式 B：AWS Bedrock（如果有免费额度）
# Claude Code 支持 Bedrock，需配置 AWS 凭证
export ANTHROPIC_MODEL="us.anthropic.claude-sonnet-4-20250514"
export CLAUDE_CODE_USE_BEDROCK=1

# 3. 安装 OpenClaw acpx 插件
openclaw plugins install acpx
openclaw config set plugins.entries.acpx.enabled true

# 4. 配置 ACP
openclaw config set acp.enabled true
openclaw config set acp.backend acpx
openclaw config set acp.defaultAgent claude
openclaw config set acp.allowedAgents '["claude","codex"]'

# 5. 设置权限（ACP 是非交互的，必须设）
openclaw config set plugins.entries.acpx.config.permissionMode approve-all

# 6. 重启 gateway
openclaw gateway restart

使用方式#

方式 1：从聊天界面直接 spawn

text

/acp spawn claude --bind here --cwd /path/to/project

之后在这个对话里说的所有话都会发给 Claude Code。

方式 2：agent 自动调用

json

{
  "task": "修复 src/api.js 里的 404 错误",
  "runtime": "acp",
  "agentId": "claude",
  "mode": "run"
}

方式 3：持久会话 + 线程绑定（Discord/Telegram）

text

/acp spawn claude --thread auto --mode persistent

创建一个线程，所有后续消息都在 Claude Code 会话里。

ACP 常用命令#

命令用途/acp spawn claude --bind here把当前对话绑定到 Claude Code/acp status查看当前会话状态/acp model anthropic/claude-sonnet-4-6切换模型（省钱用 Sonnet！）/acp cancel取消当前正在跑的任务/acp close关闭会话/acp steer 专注修 bug，不要重构给正在跑的任务加指令

---

二、PTY 后台模式#

不需要 acpx 插件，直接通过 exec 控制 Claude Code CLI。

前提#

bash

# 安装 Claude Code CLI
npm install -g @anthropic-ai/claude-code

# 配置 API Key
export ANTHROPIC_API_KEY="sk-ant-xxxxx"

一次性任务#

bash

# 用 PTY 模式运行（必须！）
exec pty=true workdir=/path/to/project command="claude 'Fix the failing test in auth.test.js'"

后台长任务#

bash

# 1. 启动后台任务
exec pty=true workdir=/path/to/project background=true command="claude 'Refactor the payment module to use async/await'"

# 2. 查看进度
process action=log sessionId=<id>

# 3. 发送输入（如果 Claude Code 在等确认）
process action=submit sessionId=<id> data="yes"

# 4. 任务完成通知（加在 prompt 末尾）
exec pty=true workdir=/project background=true command="claude 'Your task here. When done, run: openclaw gateway wake --text \"Done: summary\" --mode now'"

非交互模式（适合 CI/CD 和脚本）#

bash

# -p 参数 = print mode，单次输出后退出
claude -p "Analyze this code for security issues" --output-format json

# 限制预算（防止跑飞）
claude -p --max-budget-usd 5.00 "Run tests and fix failures"

---

三、省钱策略 💰#

核心思路：用 Sonnet 干活，Opus 只做关键决策。

模型选择#

任务类型推荐模型大约费用写新功能、重构Sonnet 4$3/MTok in, $15/MTok outBug 修复、简单改动Sonnet 4同上架构设计、复杂推理Opus 4$15/MTok in, $75/MTok outPR ReviewSonnet 4足够了测试生成Haiku 4$0.25/MTok in, $1.25/MTok out

省钱技巧#

1. 默认用 Sonnet：80% 的编程任务 Sonnet 完全够用 text

   /acp model anthropic/claude-sonnet-4-6
   
   

2. 用 Bedrock 走 AWS 免费额度：如果你有 AWS 账号 bash

   export CLAUDE_CODE_USE_BEDROCK=1
   export AWS_REGION=us-east-1
   
   

3. 设预算上限：防止 Claude Code 陷入死循环 bash

   claude -p --max-budget-usd 2.00 "Your task"
   
   

4. 用 compact 命令：长会话时主动压缩上下文 text

   /compact
   
   

5. 任务拆细：一个大任务拆成几个小任务，每个独立会话，避免上下文膨胀

费用对比参考#

场景OpusSonnet省多少修一个 bug（10K token）$0.90~$0.1880%写一个 API endpoint（50K）$4.50~$0.9080%大型重构（200K）$18.00~$3.6080%一天编程（500K）$45.00~$9.0080%

---

四、项目配置建议#

Claude Code 的 CLAUDE.md#

在项目根目录放一个 CLAUDE.md（类似 OpenClaw 的 AGENTS.md），Claude Code 每次启动会自动读取：

markdown

# CLAUDE.md

## 项目概述
这是一个 XXX 项目，用 React + Node.js + PostgreSQL。

## 代码规范
- 用 TypeScript strict mode
- 函数用 JSDoc 注释
- 测试用 Jest
- commit message 用 conventional commits

## 重要提醒
- 不要修改 migrations/ 目录下已有的迁移文件
- API 路由在 src/routes/ 下
- 环境变量在 .env.example 里有模板

与 OpenClaw 的协作模式#

text

用户 → 飞书/Telegram 消息
  → OpenClaw 主 agent（Sonnet/Opus）
    → 判断是否需要编程
      → 是 → spawn Claude Code ACP session
      → 否 → 直接回答

OpenClaw 主 agent 可以：

1. 接收用户需求
2. 分析需求，拆解任务
3. spawn Claude Code 去写代码
4. 检查 Claude Code 的输出
5. 汇报结果给用户

---

五、常见问题#

Q: Claude Code 和 OpenClaw 主 agent 有什么区别？#

A: OpenClaw 主 agent 是你的全能助手（聊天、搜索、文档、日程等）。Claude Code 是专门的编程工具（读代码、写代码、跑命令）。通过 ACP，OpenClaw 可以在需要时调用 Claude Code。

Q: 我没有 Anthropic API Key，能用吗？#

A: 可以，有几个选项：

• AWS Bedrock：如果你有 AWS 账号，Claude 模型在 Bedrock 上可用
• Claude Pro/Max 订阅：Claude Code 支持用订阅额度（有使用上限）
• OpenClaw ACP + 其他 harness：也可以用 Codex（OpenAI）或 Gemini CLI（Google）

Q: ACP 模式和 PTY 模式哪个好？#

A: ACP 更好——持久会话、模型切换、权限控制、线程绑定都开箱即用。PTY 模式适合快速一次性任务或不想装 acpx 的场景。

Q: 如何限制花费？#

A: 三层防护：

1. Claude Code 的 --max-budget-usd 参数
2. Anthropic API 后台设置月度预算上限
3. 默认用 Sonnet，Opus 只在关键时刻用