OpenClaw AI Code 场景路由器

OpenClaw AI Code Scenario Router / 开发任务选型器

> 根据你的开发任务语义，自动匹配最优 AI Code CLI 工具和模型，给出可直接执行的命令。

⚠️ 前置要求: 使用前请配置 .env 文件（复制 .env.example 并填写实际 API Key）。

一、工具能力地图

> 外网工具安装方式（内网 claude-internal → 外网 claude，以此类推）：

> 配置说明：所有 API Key 应通过 .env 文件或环境变量管理，详见 .env.example 模板。
> 工具名映射：内网 claude-internal → 外网 claude，gemini-internal → gemini，codex-internal → codex。

二、场景路由图谱

🔨 通用开发场景

🧪 测试开发场景

📐 SDD / Harness Engineering 场景

三、决策流程

Step 1：识别任务类型

用户输入 → 提取关键词：

  重构/架构/依赖      → 场景 #1, #5
  改一个地方/定点修改  → 场景 #2
  bug/竞态/并发       → 场景 #3, #19
  读大量文件/全库分析  → 场景 #4
  PR review/代码审查  → 场景 #6
  算法/数据结构        → 场景 #7
  前端/React/TS/CSS   → 场景 #8
  原型/MVP/快速实现   → 场景 #9
  百万 token/超大项目  → 场景 #10
  单测/测试生成        → 场景 #16, #22, #23
  TDD                → 场景 #17
  E2E                → 场景 #20, #21
  CI/非交互/脚本       → 场景 #12, #22, #25
  SDD/spec/验收标准   → 场景 #24, #26, #30
  Harness/hooks/规则  → 场景 #27, #28, #29
  敏感仓库/数据合规    → 场景 #13
  文档/README         → 场景 #14
  学习/查阅新技术      → 场景 #15

Step 2：确认 token 余量

> 联动 openclaw-ai-code-token-governor skill 进行额度检查（外网版本需适配为查询各平台 API quota）。
> 如 credit 不足，自动切降级模型（见 token-governor skill）。

Step 3：给出推荐

🎯 推荐：<工具> + <模型>
原因：<1句话>

▶ 即将执行：
<完整命令>

💰 预估 credit：<区间>
📦 备选（省 credit）：<备选命令>

确认执行？[y/N]

Step 4：执行

exec(
  command = "<完整命令>",
  pty     = true,       # 所有工具必须
  workdir = "<项目目录>",
  timeout = 120~600,    # 轻120s / 中300s / 重600s
)

各工具非交互命令模板

# codebuddy（最通用，非交互支持完善，CI 首选）
codebuddy -p "<任务>" -y --model <model-id>
# 需要环境变量: CODEBUDDY_API_KEY

# gemini（支持 -p 只读，-y 写文件）
gemini -p "<分析/问答任务>" -m <model-id>   # 只读
gemini -y -m <model-id> "<修改文件任务>"    # 写文件
# 需要环境变量: GEMINI_API_KEY

# claude 非交互
claude -p "<任务>"
# 需要环境变量: ANTHROPIC_API_KEY

# codex 非交互
codex exec "<任务>"
git diff | codex exec "<任务>"
# 需要环境变量: OPENAI_API_KEY

执行后处理

• ✅ 正常 → 展示摘要，询问后续
• ❌ 429 → 调用 openclaw-ai-code-token-governor skill 处理降级
• ❌ 配额不足 → 提示检查 API quota 或切换备选模型
• ❌ API Key 报错 → 提示检查 .env 配置或环境变量
• ❌ 超时 → 建议切更大上下文工具
• ❌ 乱码/卡死 → 自动切备选模型重试

四、场景快速命令手册

五、preflight 检查

执行前检查 CLI 工具安装状态和 API Key 配置：

# 检查工具是否已安装
which claude || npm install -g @anthropic-ai/claude-code
which codex || npm install -g @openai/codex-cli
which gemini || npm install -g @google/gemini-cli
which codebuddy || npm install -g codebuddy

# 检查 API Key 是否配置
source .env
echo "ANTHROPIC_API_KEY: ${ANTHROPIC_API_KEY:+已配置}"
echo "OPENAI_API_KEY: ${OPENAI_API_KEY:+已配置}"
echo "GEMINI_API_KEY: ${GEMINI_API_KEY:+已配置}"
echo "CODEBUDDY_API_KEY: ${CODEBUDDY_API_KEY:+已配置}"

> 工具未安装时自动安装；API Key 未配置时输出配置说明并中止。