适用于 Openclaw 的 OpenClaw Codex 协作

一种高度结构化的开发者规范和工作流协议,用于组织、执行和验证从 OpenClaw 分发给 Codex 的自主编码任务。

kmpanda011172
v1.0.0
2026年6月18日
0
413
0

安装与下载

1. ClawHub CLI

从源直接安装技能的最快方式。

npx clawhub@latest install codex-dev-collaboration

2. 手动安装

将技能文件夹复制到以下位置之一

全局模式
~/.openclaw/skills/
工作区
<project>/skills/

优先级:工作区 > 本地 > 内置

3. 提示词安装

将此提示词复制到 OpenClaw 即可自动安装。

请帮我使用 Clawhub 安装 codex-dev-collaboration。如果尚未安装 Clawhub,请先安装(npm i -g clawhub)。

更倾向于下载?

获取包含原生技能文件的ZIP压缩包。

什么是 OpenClaw Codex 协作?

OpenClaw Codex 协作规范定义了一种可靠的协议,旨在安全地编排多智能体编码工作流。该规范在协调控制器和执行智能体之间建立了强大的通信通道,提供严格的执行准则、Canary 检查、目录标准和验证步骤。通过利用这些标准化准则,开发团队可以消除导致执行阻塞的错误,系统地跟踪工作区状态,并使多智能体软件开发完全可预测。

通过 Openclaw Skills 实现结构化协议,既能保证高性能协作,又能保护本地仓库免受破坏性操作的影响。它为 AI 智能体创建了明确的障碍,规定了严格的工作区参数、依赖项准则和输出验证循环,以确保高质量的代码生成。

OpenClaw Codex 协作 应用场景

  • 建立安全的、多智能体自动化开发流水线,其中 OpenClaw 规划任务,Codex 执行仓库重构。
  • 通过飞行前执行测试,防止自动化 DevOps 和智能体网络中出现静默的命令行故障。
  • 管理复杂的工作区,对项目架构、路线图、任务执行日志和 patch diff 进行结构化跟踪。
  • 实现严格的验证检查门禁,在将任务标记为完成之前,自动根据预期合同审核 AI 修改内容。

OpenClaw Codex 协作 工作原理

  1. Canary 验证门禁:在执行写操作任务之前运行安全的只读诊断命令,验证 CLI 参数、身份验证、模型配置和连通性。
  2. 目录初始化:为简报、架构、细化任务和执行运行日志设置标准的工作区子目录。
  3. 严格参数分发:以精确的参数顺序执行开发任务,在执行命令之前显式强制执行类似 -a never 的顶级 CLI 参数。
  4. 约束强制:自动将开发者提示词包裹在包含安全限制、文件黑名单、写入范围边界和所需输出的严格模板中。
  5. 执行后零输出审核:在允许任务进入成功状态之前,验证退出代码、非空结果文档、JSON 事件流和工作区 git 状态。

OpenClaw Codex 协作 配置指南

在执行主动开发任务之前,请确保您的 CLI 工具已完全验证并获得身份验证。

# 验证您的 CLI 版本和活动帮助参数
codex --version
codex exec --help

在您的仓库路径中运行 Canary 自检,以确认 CLI 状态和参数位置:

codex -a never exec \
  -C "$REPO" \
  -s read-only \
  --json \
  -o "$JOB_DIR/canary-result.md" \
  "Just answer: Codex exec canary ok. Do not modify files." \
  > "$JOB_DIR/canary.jsonl" 2>&1
echo $? > "$JOB_DIR/canary-exit-code.txt"

通过标准:canary-exit-code.txt 中的退出代码必须为 0,且 canary-result.md 和 canary.jsonl 文件都必须包含内容。

OpenClaw Codex 协作 数据架构与分类体系

Openclaw Skills 中的协作模板组织项目工作区,以确保跨执行周期的连续性。

项目目录布局

~/.openclaw-codex/projects/{project_name}/
  ├── brief.md              # 项目摘要
  ├── architecture.md       # 目标系统架构和图表
  ├── roadmap.md            # 顺序执行步骤
  ├── tasks/                # 独立任务定义
  │   └── 001-task-name.md
  └── runs/                 # 历史执行尝试
      └── 20260618-001/
          ├── prompt.md     # 使用的输入任务提示词
          ├── result.md     # 输出代码分析/结果
          ├── codex.jsonl   # JSON 事件日志输出
          ├── diff.patch    # 工作区 patch diff
          ├── test.log      # 验证测试套件输出
          └── status.json   # 任务状态跟踪元数据

双向交接模式

结构化合同保存在 outputs/collaboration_inbox/ 路径中,用于管理规划智能体与执行智能体之间的交接:

交接步骤 发送方 接收方 关键模式内容
01 交接合同 OpenClaw Codex 端点路径、DTO 定义、文件白名单/黑名单、编译器验证、规则。
02 执行记录 Codex OpenClaw 已修改文件索引、验证指标、偏差、遗留技术问题。

OpenClaw Codex 协作 高级特性

  • 位置性 CLI 安全检查:显式强制执行参数布局规则,完全避免因配置错误的执行参数导致的解析器停止和静默超时。
  • 零输出安全处理器:检测连续的空白迭代,自动缩小任务范围或暂停工作流以寻求人工干预。
  • 双向协作收件箱:嵌入专用于结构化 API 交接的隔离目录,验证合同合规性、方法签名和模式字段。
  • 标准约束屏蔽:阻止不安全的系统配置、未经批准的依赖项、破坏性的 Git 选项和超出范围的 UI 设计编辑。

SKILL.md


加载中

Openclaw 相关技能

METADATA

Github Stars: 0
forks: 0

精选*