← 返回 Skills 市场
abeperl

Codex Bridge

作者 Abraham Perl · GitHub ↗ · v1.0.0
cross-platform ⚠ suspicious
369
总下载
0
收藏
0
当前安装
1
版本数
在 OpenClaw 中安装
/install codex-bridge
功能描述
Dispatch coding tasks to the local OpenAI Codex CLI with background execution, status polling, and answerable clarifying questions. Use when OpenClaw should...
使用说明 (SKILL.md)

Codex Bridge

Delegate coding tasks from OpenClaw to the local codex CLI and manage them asynchronously. This skill provides a file-based bridge so OpenClaw can:

  • dispatch tasks
  • poll status and recent output
  • relay clarifying questions
  • send answers
  • collect final results

When to Use

  • Build scripts (Python, Bash, etc.)
  • Implement or refactor code in an existing project
  • Run larger multi-file coding tasks in the background
  • Delegate coding work while keeping OpenClaw responsive
  • Handle tasks that may require clarifying questions mid-run

When NOT to Use

  • Quick factual questions or explanations
  • Small code snippets that OpenClaw can write directly
  • Non-coding tasks
  • Tasks that should not invoke a local coding agent/CLI

Dispatch a Task

~/.openclaw/skills/codex-bridge/codex-bridge-dispatch.sh \
  --task-id \x3Cdescriptive-name> \
  --workdir \x3Cproject-directory> \
  --prompt "\x3Cdetailed coding task>"

Prompt Writing

Include:

  • what to build/fix
  • file paths if known
  • expected behavior/output
  • language/framework preferences
  • constraints (tests, style, no new deps, etc.)

Example:

~/.openclaw/skills/codex-bridge/codex-bridge-dispatch.sh \
  --task-id scripts-csv-parser \
  --workdir ~/projects/data-tools \
  --prompt "Create parse_orders.py. Read orders CSV, keep shipped rows, group by customer_id, and write summary CSV with columns customer_id, order_count, total_amount. Use pandas. Add basic CLI args and error handling."

Check Status

~/.openclaw/skills/codex-bridge/codex-bridge-status.sh --task-id \x3Cid>

Common status commands:

~/.openclaw/skills/codex-bridge/codex-bridge-status.sh --list
~/.openclaw/skills/codex-bridge/codex-bridge-status.sh --task-id \x3Cid> --output
~/.openclaw/skills/codex-bridge/codex-bridge-status.sh --task-id \x3Cid> --question
~/.openclaw/skills/codex-bridge/codex-bridge-status.sh --task-id \x3Cid> --result
~/.openclaw/skills/codex-bridge/codex-bridge-status.sh --task-id \x3Cid> --log

Answer Clarifying Questions

When status is waiting_for_answer, read the pending question and send a response:

~/.openclaw/skills/codex-bridge/codex-bridge-status.sh --task-id \x3Cid> --question
~/.openclaw/skills/codex-bridge/codex-bridge-answer.sh --task-id \x3Cid> --answer "\x3Canswer text>"

The bridge resumes the same Codex session after the answer is written.

Workflow

  1. Dispatch task with a clear prompt.
  2. Report the task ID.
  3. Poll status/output periodically.
  4. If status becomes waiting_for_answer, read --question, relay to user, then write answer with --answer.
  5. When status is complete, read --result and summarize outcomes.
  6. If status is error, inspect --log and --output.

Notes and Limits

  • Uses the local codex CLI (codex exec and codex exec resume).
  • Clarifying questions are implemented via a lightweight text marker protocol in the prompt wrapper.
  • Bridge state is stored in ~/.codex-bridge/tasks/\x3Ctask-id>/.
  • Commands run via Codex in the specified --workdir.
  • For unattended runs, the bridge times out after 10 minutes waiting for an answer and resumes with a default/sensible fallback.
安全使用建议
This skill appears to do what it claims: run the local 'codex' CLI on a project directory and mediate clarifying Q&A via files under ~/.codex-bridge. Before installing, consider: 1) Ensure you trust the local 'codex' CLI and its configuration/credentials (the bridge will invoke it in the chosen workdir and the CLI could read or modify files there). 2) Run the bridge only against project directories you are willing to let the Codex CLI access; avoid pointing it at sensitive system paths or your home directory. 3) Inspect or back up any files in the chosen workdir if you are worried about automated modifications. 4) Logs and task state are stored in ~/.codex-bridge/tasks/; review or remove that directory if you uninstall. If you want additional assurance, run the scripts manually in a safe test repo and observe behavior before enabling them in production workflows.
功能分析
Type: OpenClaw Skill Name: codex-bridge Version: 1.0.0 The codex-bridge skill provides a mechanism for an AI agent to delegate arbitrary coding tasks to a local 'codex' CLI with background execution and automated status polling. While the implementation in bridge.py and the shell scripts appears to be a functional task-management wrapper, it grants the agent high-risk capabilities, including file modification and command execution via the codex CLI's --full-auto mode. Furthermore, the shell scripts (codex-bridge-status.sh, codex-bridge-answer.sh) are vulnerable to path traversal via the --task-id argument, which could be exploited by a malicious prompt to access files outside the intended tasks directory. No evidence of intentional malice or exfiltration was found, but the broad execution surface and lack of input sanitization warrant a suspicious classification.
能力评估
✓ Purpose & Capability
Name/description match the code and scripts: the bundle dispatches tasks to a local 'codex' CLI, requires python3 and codex binaries, stores state under ~/.codex-bridge, and manipulates files only within the declared task/workdir scope.
✓ Instruction Scope
SKILL.md instructs the agent to dispatch, poll, ask/answer clarifying questions, and read results. The included bridge.py and helper scripts implement exactly those behaviors. The bridge reads/writes only under ~/.codex-bridge/tasks/<task-id>/ and launches the codex CLI in the specified workdir; it does not access unrelated system paths or external endpoints.
✓ Install Mechanism
No install spec is provided (instruction-only with included scripts). Nothing is downloaded or written outside the skill's own task directory; no unexpected install sources are used.
✓ Credentials
No environment variables or external credentials are required by the skill. Declared binary requirements (python3, codex) are appropriate for the functionality. Note: the codex CLI itself may require user credentials/config which are outside this skill's scope.
✓ Persistence & Privilege
The skill does not request 'always: true', does not modify other skills or global agent settings, and keeps its state under ~/.codex-bridge. It runs background processes for dispatched tasks (normal for this purpose).
如何使用
  1. 确保已安装 OpenClaw（本地或 Docker 部署）
  2. 在对话框中输入安装命令：/install codex-bridge
  3. 安装完成后，直接呼叫该 Skill 的名称或使用 /codex-bridge 触发
  4. 根据 Skill 的参数说明提供必要输入，即可获得结构化输出
版本历史
v1.0.0
Initial release of codex-bridge skill. - Enable OpenClaw to delegate complex coding tasks to the local OpenAI Codex CLI. - Support for asynchronous task dispatch, background execution, and status polling. - Relay clarifying questions and collect user answers to keep multi-step tasks interactive. - Expose CLI commands for task dispatch, status checks, and answer submission. - Designed for use cases needing script building, code refactoring, or multi-file project work beyond simple code completion.
元数据
Slug codex-bridge
版本 1.0.0
许可证 —
累计安装 0
当前安装数 0
历史版本数 1
常见问题

Codex Bridge 是什么？

Dispatch coding tasks to the local OpenAI Codex CLI with background execution, status polling, and answerable clarifying questions. Use when OpenClaw should... 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件，目前累计下载 369 次。

如何安装 Codex Bridge？

在 OpenClaw 或 Claude Code 对话框中运行命令「/install codex-bridge」即可一键安装，无需额外配置。

Codex Bridge 是免费的吗？

是的，Codex Bridge 完全免费（开源免费），可自由下载、安装和使用。

Codex Bridge 支持哪些平台？

Codex Bridge 跨平台运行，可在任意部署了 OpenClaw / Claude Code 的环境中使用（cross-platform）。

谁开发了 Codex Bridge？

由 Abraham Perl（@abeperl）开发并维护，当前版本 v1.0.0。

推荐 Skills
self-improving agent
Captures learnings, errors, and corrections to enable continuous improvement. Use when: (1) A command or operation fails unexpectedly, (2) User corrects Clau...
⬇ 463283 · by pskoett
Skill Vetter
Security-first skill vetting for AI agents. Use before installing any skill from ClawdHub, GitHub, or other sources. Checks for red flags, permission scope, and suspicious patterns.
⬇ 259410 · by spclaudehome
Polymarket
Query Polymarket prediction markets. Check odds, find trending markets, search events, track price movements.
⬇ 232503 · by joelchance
Self-Improving + Proactive Agent
Self-reflection + Self-criticism + Self-learning + Self-organizing memory. Agent evaluates its own work, catches mistakes, and improves permanently. Use when...
⬇ 200423 · by ivangdavila
Github
Interact with GitHub using the `gh` CLI. Use `gh issue`, `gh pr`, `gh run`, and `gh api` for issues, PRs, CI runs, and advanced queries.
⬇ 191113 · by steipete
ontology
Typed knowledge graph for structured agent memory and composable skills. Use when creating/querying entities (Person, Project, Task, Event, Document), linkin...
⬇ 190156 · by oswalpalash

💬 留言讨论