Codex Cli Dispatch

Codex CLI Dispatch

An [OpenClaw](https://github.com/openclaw/openclaw) skill that dispatches coding tasks to [OpenAI Codex CLI](https://github.com/openai/codex) (`codex exec`) in background mode, with **automatic Telegram notification** on completion.

No polling. No blocking. Fire and forget — get notified when it's done.

Features

• 🚀 Background execution — dispatches Codex CLI as a background process, never blocks your agent
• 📲 Auto Telegram notification — sends task result summary to a Telegram chat when done
• 🔄 Agent wake hook — wakes your OpenClaw agent on completion for follow-up actions
• 🛡️ Sandbox modes — supports read-only, workspace-write, and danger-full-access
• 📊 Result tracking — writes structured JSON results for downstream processing
• 🖼️ Image support — attach images to the Codex prompt for visual context

Prerequisites

• OpenClaw installed and running
• Codex CLI installed (npm i -g @openai/codex)
• Codex authenticated (codex login or ~/.codex/config.toml)
• (Optional) Telegram bot configured in OpenClaw for notifications

Installation

As an OpenClaw Skill

Copy the skill folder into your OpenClaw workspace:

cp -r codex-cli-dispatch /path/to/your/clawd/skills/

OpenClaw will auto-discover the skill from `SKILL.md`.

Standalone

You can also use `scripts/dispatch.sh` independently:

git clone https://github.com/win4r/codex-cli-dispatch.git
cd codex-cli-dispatch
chmod +x scripts/dispatch.sh

Configuration

The script auto-detects paths, but you can override them via environment variables:

Variable	Default	Description
OPENCLAW_WORKSPACE	Parent of scripts/ dir	OpenClaw workspace root (e.g., ~/clawd)
OPENCLAW_BIN	Auto-detect via $PATH	Path to openclaw binary
CODEX_BIN	Auto-detect via $PATH	Path to `c