skills.rest
diazMelgarejo
diazMelgarejoCOMMUNITY
Explore all skills by this author →
Website𝕏@Melgarejo_yDiazGitHub

codex-openclaw-agent

Configure and reconcile a dedicated Codex sub-agent in OpenClaw using the native codex/gpt-5.5 model catalog.

Updated Mar 22, 2026
Search Tags:#devops#codex#idempotent#agent configuration#sub-agent#openclaw#gpt-5.5
One-click install
npx skills add https://github.com/diazMelgarejo/orama-system --skill codex-openclaw-agent-diazmelgarejo
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: codex-openclaw-agent
Source: https://github.com/diazMelgarejo/orama-system/tree/main/bin/orama-system/skills/openclaw-skills/codex-openclaw-agent
Command: npx skills add https://github.com/diazMelgarejo/orama-system --skill codex-openclaw-agent-diazmelgarejo

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve? Setting up a dedicated Codex coding sub-agent in OpenClaw involves fragile manual edits to openclaw.json, plugin management, workspace scaffolding, and credential routing. This Skill automates that reconciliation idempotently, so the codex-agent is created or repaired without touching the Main Agent, global routing, or the existing coder agent. ## Core Features & Use Cases - Idempotent Agent Binding: Creates or reconciles the codex-agent with the canonical workspace, codex/gpt-5.5 model, coding tool profile, and delegation allowlist, writing nothing when state already matches. - Workspace Profile Generation: Updates only marker-owned regions in CODEX.md, IDENTITY.md, AGENTS.md, and TOOLS.md while preserving all operator-authored content, and scaffolds SECURITY.md only when absent. - Provider and Auth Handling: Installs and enables the bundled openai provider plugin, preserves existing plugin allowlists, and reports needs_auth or needs_plugin statuses instead of failing silently. - Use Case: An operator wants a dedicated Codex execution sub-agent for coding tasks without changing default routing; they run the binder script once, then authenticate via the openai-codex login flow and invoke the agent explicitly. ## Quick Start Ask the agent to bind the Codex OpenClaw sub-agent by running the bind_codex_backend.sh script with the desired thinking effort, then verify with openclaw models status.

Frequently Asked Questions about codex-openclaw-agent

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I set up a Codex sub-agent in OpenClaw?▼

Run the bind_codex_backend.sh script from the skill directory, optionally with --effort medium, high, or xhigh. It creates the codex-agent with the canonical workspace, codex/gpt-5.5 model, and coding tool profile, then reports whether authentication is still needed.

How do I authenticate the OpenClaw Codex provider?▼

Run openclaw models auth login --provider openai-codex after configuration completes. This interactive flow creates the managed credential profile; the binder reports needs_auth and never copies existing tokens or API keys.

Does binding codex-agent change my default OpenClaw routing?▼

No. The binder only reconciles the codex-agent entry and appends it to the subagent delegation allowlist. It never modifies the Main Agent, global default model, the coder agent, channel bindings, or gateway service settings.

Is the Codex agent binding script safe to re-run?▼

Yes, the binder is idempotent. When configuration and workspace files already match the desired state, it writes nothing and exits with an ok status; use --dry-run to preview changes before applying them.

Why does the binder report needs_plugin for the openai provider?▼

The native openai-codex login route requires the official bundled openai provider plugin. If automated installation via openclaw plugins install openai fails, the binder reports needs_plugin so you can install an approved provider plugin manually.

Will the profile generator overwrite my custom workspace notes?▼

No. The generator only rewrites content inside paired oramaclaw:generated marker regions in CODEX.md, IDENTITY.md, AGENTS.md, and TOOLS.md. All operator-authored content outside those markers is preserved, and SECURITY.md is created only when missing.

Related Skills

Explore More Software Engineering Skills→
ElvinOuyangElvinOuyang

openclaw-config

Configures OpenClaw gateway JSON5 to connect Docker services to messaging channels and AI providers.

Community
Intermediate
saxyguy81saxyguy81

Agent Watchdog Skill

Monitor AI agent responsiveness and activity through Matrix messages.

Community
Intermediate
Huddle01Huddle01
2

hudl-model-switch

Switch OpenClaw's active model via the hudl provider and restart the gateway.

Official
Advanced
haryelramalhoharyelramalho

openai-docs

Retrieve official OpenAI documentation and Codex manual guidance for API questions.

Community
Advanced