@claw-link/cl-dev-codex

Part of the ClawLink platform — AI agents for your business, built and managed at claw-link.co

OpenAI Codex developer sub-agent for the ClawLink platform.

Install this package once on any machine running OpenClaw. It registers a cl-dev-codex sub-agent that your ClawLink agents can dispatch coding tasks to — scaffolding, refactoring, bug fixes, git commits, and more — all powered by OpenAI Codex CLI on a single, configured git repository.

Prerequisites

| Requirement | Install | |---|---| | OpenClaw | See openclaw.ai — must be installed and running first | | Node.js ≥ 20 | nodejs.org or nvm install 20 | | Codex CLI | npm install -g @openai/codex | | A git repository | Local path, remote URL (auto-cloned), or created during install |

Install

Step 1 — Install OpenClaw (if not already installed)

Follow the instructions at openclaw.ai and make sure it is running.

Step 2 — Install Codex CLI

npm install -g @openai/codex

Step 3 — Run the sub-agent installer

npx @claw-link/cl-dev-codex

The installer asks three questions, copies workspace files to ~/.openclaw/workspace-cl-dev-codex/, patches openclaw.json, and restarts OpenClaw.

Install options

| Flag | Description | |---|---| | --agent-id <id> | Custom agent ID (default: cl-dev-codex). Use multiple instances: cl-dev-codex-api | | --repo <path> | Local path or git URL for the repository this agent works on | | --stack <id> | Pre-select a stack: react-vite-firebase, react-vite-supabase, react-native-postgres, flutter-firebase, flutter-supabase, docker-clom-local | | --non-interactive | Skip all prompts (requires --repo and --stack) |

What the installer does

1. Verifies OpenClaw is installed at ~/.openclaw/
2. Asks for an agent ID, repository path, tech stack, and Codex authentication
3. Copies the workspace template to ~/.openclaw/workspace-{agentId}/
4. Writes PROJECT.md with your repo path and stack
5. Creates ~/.openclaw/workspace-{agentId}/projects/ if no repo path was given
6. Patches ~/.openclaw/openclaw.json to register the agent and add it to allowAgents for all existing agents
7. Restarts OpenClaw (launchd / systemd / SCM)

Authentication

Codex CLI supports two auth modes:

OAuth (recommended)

# The installer offers to run this for you, or run it manually:
codex auth login

API key The installer prompts for your OPENAI_API_KEY and writes it to ~/.openclaw/workspace-{agentId}/.env.

Supported stacks

| Stack ID | Description | Deploy | |---|---|---| | react-vite-firebase | React 18 + Vite + Firebase Auth + Firestore | Firebase Hosting | | react-vite-supabase | React 18 + Vite + Supabase Auth + Postgres | Vercel | | react-native-postgres | React Native + Postgres (via REST/Supabase) | App stores | | flutter-firebase | Flutter + Firebase Auth + Firestore | Firebase App Dist. | | flutter-supabase | Flutter + Supabase | App stores | | docker-clom-local | Docker Postgres/Mongo + CLOM UI — no dedicated frontend app | Self-hosted |

Stack files live at ~/.openclaw/workspace-{agentId}/stacks/{stack}.md and are read by the agent at runtime.

Skip at install time — stack can be applied or changed later from the ClawLink dashboard: Sub-agents → Configure → Quick Stack Config.

Workspace files

After install, ~/.openclaw/workspace-{agentId}/ contains:

| File | Purpose | |---|---| | IDENTITY.md | Agent name, role, emoji — who this agent is | | BOOTSTRAP.md | Operational loop: how to read the project, run tasks, and return results | | TOOLS.md | CLI commands, git operations, return format | | MEMORY.md | Persistent project notes: last tasks, known issues, TODOs | | AGENTS.md | This agent's identity as a sub-agent: role, return contract, tool rules | | PROJECT.md | Repo path, tech stack, derived commands — written at install time | | stacks/ | Stack-specific conventions, commands, and data persistence patterns |

The ClawLink platform

This package is one piece of the ClawLink platform — a complete system for building AI-powered business agents.

| Package | What it does | Install | |---|---|---| | @claw-link/cl-dev-claude | Coding sub-agent — scaffolds and builds your app using Claude Code | npx @claw-link/cl-dev-claude | | cl-dev-codex ← you are here | Same as above, powered by OpenAI Codex | npx @claw-link/cl-dev-codex | | @claw-link/clom | UI orchestration sub-agent — generates rich in-chat UI (forms, booking flows, card grids) | npx @claw-link/clom |

How they work together:
All three packages register as sub-agents inside your OpenClaw instance. Any OpenClaw agent can dispatch to them directly. If you use ClawLink, you get a hosted dashboard to connect, test, and configure every sub-agent visually — stack presets, live connectivity tests, and in-chat corrections — without touching config files.

Use OpenClaw directly, or let claw-link.co manage it for you.

Connecting and configuring

Option A — OpenClaw directly

The agent is already registered in ~/.openclaw/openclaw.json after install. Any agent with cl-dev-codex in its allowAgents list can dispatch to it immediately. No further setup needed.

Option B — ClawLink dashboard (recommended)

claw-link.co gives you a visual interface to connect, test, and configure sub-agents without editing config files:

1. Sign in at claw-link.co
2. Go to Sub-agents → Add Sub-agent → select Codex Dev Agent
3. Click Test — verifies direct ping and gateway connectivity in two steps
4. Click Configure → Quick Stack Config — apply a stack preset with one click
5. Use the Configure chat to send corrections directly to the agent at any time

Multiple instances

Each instance works on exactly one repository. To manage multiple projects, install with different agent IDs:

npx @claw-link/cl-dev-codex --agent-id cl-dev-codex-api     --repo ~/projects/my-api
npx @claw-link/cl-dev-codex --agent-id cl-dev-codex-mobile  --repo ~/projects/my-mobile

Uninstall

npx @claw-link/cl-dev-codex --uninstall

License

MIT — see LICENSE