OpenClaw Coding Agent Playbook

编码智能体（Coding Agent）

当你需要另一个编码智能体在代码仓库中实现或审查变更时，请使用此技能。

适用场景

• 需要跨多个文件修改的功能开发。
• 规模较大的重构任务，希望并行开展多个工作流。
• 在隔离的代码检出环境中进行 PR 审查或问题分诊（issue triage）。
• 可重复执行的“运行 → 修复 → 验证”循环，且该过程能从后台异步执行中获益。

不适用场景

• 可直接手动完成的微小单行修改。
• 仅需读取代码的查找类任务（read-only code lookup）。
• 在 ~/.openclaw 目录下对外部仓库执行审查任务。

执行模式对照表

• Codex：需启用 pty:true。
• Pi：需启用 pty:true。
• OpenCode：需启用 pty:true。
• Claude Code：使用 --print --permission-mode bypassPermissions（无需 PTY）。

示例：

# Codex（必须启用 PTY）
bash pty:true workdir:~/project command:"codex exec --full-auto '为 API 客户端添加请求超时处理，并更新对应测试。'"

# Claude Code（打印模式，无需 PTY）
bash workdir:~/project command:"claude --permission-mode bypassPermissions --print '重构认证中间件，并说明潜在风险区域。'"

# OpenCode（必须启用 PTY）
bash pty:true workdir:~/project command:"opencode run '为 Webhook 投递添加重试与退避机制。'"

# Pi（必须启用 PTY）
bash pty:true workdir:~/project command:"pi '修复 src/api 下失败的 Vitest 测试套件，确保行为保持不变。'"

后台会话模式（Background Session Pattern）

# 启动后台会话
bash pty:true workdir:~/project background:true command:"codex exec --full-auto '实现 issue #142 并运行全部测试。'"

# 查看实时输出日志
process action:log sessionId:XXX

# 查询会话运行状态
process action:poll sessionId:XXX

# 当智能体提示输入时，提交响应
process action:submit sessionId:XXX data:"yes"

# 终止会话
process action:kill sessionId:XXX

安全审查工作流（Safe Review Workflow）

切勿在你正在使用的活跃 OpenClaw 仓库中直接执行 PR 审查。请始终使用临时克隆（temp clone）或 Git worktree。

# 使用临时克隆进行审查
REVIEW_DIR=$(mktemp -d)
git clone https://github.com/org/repo.git "$REVIEW_DIR"
cd "$REVIEW_DIR" && gh pr checkout 130
bash pty:true workdir:"$REVIEW_DIR" command:"codex review --base origin/main"

# 使用 worktree 进行审查
git worktree add /tmp/pr-130-review pr-130-branch
bash pty:true workdir:/tmp/pr-130-review command:"codex review --base main"

长周期任务的提示词模板（Prompt Template for Long Tasks）

任务：
- [明确的任务范围]
- [约束条件]
- [必需执行的检查项]

完成后：
1) 汇总被修改的文件及其修改原因；
2) 报告所执行的测试/代码检查（lint）命令及其结果；
3) 执行以下命令：
openclaw system event --text "Done: [简明结果摘要]" --mode now

故障恢复检查清单（Failure Recovery Checklist）

• 若输出停滞，请先执行一次 process action:poll，再考虑终止会话；
• 若智能体要求补充缺失上下文，请直接提供所需信息，并继续当前会话；
• 若会话提前中断，请使用更精确的提示词（tighter prompt）及显式限定文件范围重新启动；
• 若多次重试仍失败，请切换至全新的 worktree，以排除本地状态干扰。

行为准则（Rules）

1. 当用户明确指定了目标智能体（如 Codex / Pi / Claude Code 等）时，必须严格匹配该智能体；
2. 每个会话应严格限定于单一仓库和单一目标；
3. 实现类任务优先使用 --full-auto；审查类任务则应采用保守参数（conservative flags）；
4. 必须在任务启动、关键里程碑、遇到阻塞点以及最终完成时，主动向用户发送进度更新；
5. 若用户请求的是编排（orchestration）模式，则不得静默接管编码工作——所有操作均需明确告知并获得确认。

命令行