Claude Code Dev Workflow

OpenClaw + Claude Code 编程工作流。当用户想用 Claude Code 写代码、调试、重构、做 PR review 时激活。支持两种模式：ACP 集成（推荐，通过飞书/Telegram/Discord 直接对话 Claude Code）和 PTY 后台模式（通过 exec 控制 Claude...

Security Scan

The skill's instructions match its stated purpose (integrating Claude Code into OpenClaw) but they request broad runtime changes and secret configuration that the registry metadata does not declare and they instruct enabling a permissive plugin mode (approve-all); these inconsistencies and privilege changes are concerning.

Purpose & Capability

The skill claims no required environment variables or credentials in registry metadata, but SKILL.md clearly tells users to set ANTHROPIC_API_KEY (or AWS Bedrock credentials) and other env vars. Installing the Claude Code CLI and enabling an ACP plugin are coherent with the stated purpose, but the missing declaration of required credentials is an inconsistency.

Instruction Scope

Instructions direct the agent/operator to install the Claude Code CLI, enable the OpenClaw acpx plugin, change OpenClaw configs, restart the gateway, and use exec/pty to run commands in arbitrary project directories. The explicit recommendation to set acpx permissionMode to 'approve-all' grants broad non-interactive approval and expands the agent's operational scope beyond simple integration.

Install Mechanism

This is an instruction-only skill (no install spec). SKILL.md asks users to run npm install -g @anthropic-ai/claude-code and openclaw plugins install acpx — these are logical for the feature but running global npm installs executes third-party code and should be verified (ensure the package is official and review versions).

Credentials

Registry metadata lists no required env vars, but the guide instructs exporting ANTHROPIC_API_KEY, CLAUDE_CODE_USE_BEDROCK, AWS_REGION and potentially AWS credentials. Requesting cloud credentials or API keys is expected for using Claude Code, but the metadata omission is a mismatch and the guidance to use Bedrock implies broader credential access than advertised.

Persistence & Privilege

The skill tells operators to enable the acpx plugin, set it enabled in OpenClaw config, set acp.enabled true, and set plugins.entries.acpx.config.permissionMode to 'approve-all', then restart the gateway. Those steps modify system config and grant persistent, broad automated permissions to ACP agents — a notable elevation of automated privilege that should not be enabled without careful review and least-privilege controls.

What to consider before installing

This skill appears to do what it says (integrate Claude Code), but review before installing: 1) The SKILL.md requires API keys / AWS credentials even though the registry lists none — do not provide secrets until you verify the skill's provenance. 2) Avoid enabling plugins with permissionMode=approve-all; prefer interactive approval or least-privilege policies. 3) Verify the npm package @anthropic-ai/claude-code is official and review the version before running npm install -g. 4) If using AWS Bedrock, create and use an IAM role with minimal permissions and budget limits rather than your root credentials. 5) Test in an isolated project or dev environment first, and audit OpenClaw plugin/config changes (backup configs, review logs). If the publisher or homepage cannot be verified, treat this integration as higher risk.

OpenClaw + Claude Code 编程指南

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

两种集成模式

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

---

一、ACP 模式（推荐）

前提安装

# 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

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

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

方式 2：agent 自动调用

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

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

/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。

前提

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

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

一次性任务

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

后台长任务

# 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 和脚本）

# -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 out
Bug 修复、简单改动	Sonnet 4	同上
架构设计、复杂推理	Opus 4	$15/MTok in, $75/MTok out
PR Review	Sonnet 4	足够了
测试生成	Haiku 4	$0.25/MTok in, $1.25/MTok out

省钱技巧

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

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

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

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

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

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

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

   /compact
   

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

费用对比参考

场景	Opus	Sonnet	省多少
修一个 bug（~10K token）	~$0.90	~$0.18	80%
写一个 API endpoint（~50K）	~$4.50	~$0.90	80%
大型重构（~200K）	~$18.00	~$3.60	80%
一天编程（~500K）	~$45.00	~$9.00	80%

---

四、项目配置建议

Claude Code 的 CLAUDE.md

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

# CLAUDE.md

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

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

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

与 OpenClaw 的协作模式

用户 → 飞书/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 只在关键时刻用