Codex Claw

Codex Claw is an OpenClaw code plugin for people who want native Codex Desktop to carry selected OpenClaw workspace context into new sessions. It installs a local Codex Desktop marketplace payload, points that payload at your chosen AGENTS.md and SOUL.md files, and keeps that context explicitly lower priority than native Codex system, developer, safety, tool, and direct user instructions.

Use it when you want the native Codex Desktop app to inherit OpenClaw workspace context, collaboration preferences, and personality notes without manually copying private files into a separate plugin repository.

Capabilities

• Adds the openclaw codex-claw CLI command.
• Writes a local Codex Desktop marketplace payload under ~/.codex/openclaw-codex-claw-marketplace.
• Writes ~/.codex/codex-claw.json with explicit agentsPath and soulPath values.
• Loads the configured files through Codex Desktop SessionStart hooks as lower-priority session bootstrap context.
• Supports post-compaction reinjection through a UserPromptSubmit hook that defaults to after_compact.
• Provides a compatibility review prompt for cleaning AGENTS.md and SOUL.md before using them as always-on Codex context.
• Provides a status command that checks local bridge files and configured source paths without reading private file contents.

Codex Claw does not copy your real AGENTS.md or SOUL.md into the generated payload. The generated plugin reads the explicit local paths from ~/.codex/codex-claw.json.

ClawHub Install

Install from ClawHub:

openclaw plugins install clawhub:@openclaw/codex-claw

Then install the Codex Desktop bridge payload from your OpenClaw workspace:

openclaw codex-claw install \
  --agents ~/.openclaw/workspace/AGENTS.md \
  --soul ~/.openclaw/workspace/SOUL.md

Install

If you already have the package installed locally, run:

openclaw codex-claw install

Pass explicit source files when your workspace uses custom paths:

openclaw codex-claw install \
  --agents ~/.openclaw/workspace/AGENTS.md \
  --soul ~/.openclaw/workspace/SOUL.md

Register the generated marketplace with Codex Desktop:

codex plugin marketplace add ~/.codex/openclaw-codex-claw-marketplace

If the codex binary is not on your PATH on macOS, use:

/Applications/Codex.app/Contents/Resources/codex plugin marketplace add ~/.codex/openclaw-codex-claw-marketplace

Make sure ~/.codex/config.toml enables plugins and hooks:

[features]
plugins = true
codex_hooks = true
plugin_hooks = true

[plugins."codex-claw@codex-claw"]
enabled = true

Restart Codex Desktop after changing plugin settings.

Commands

openclaw codex-claw install
openclaw codex-claw status
openclaw codex-claw review-prompt

status checks the generated marketplace payload, config file, and configured source paths without reading private file contents.

review-prompt prints questions for finding instructions that conflict with native Codex behavior, unavailable tools, safety boundaries, or normal reliability reporting.

Verification

After restarting Codex Desktop, ask a fresh Codex session:

Do not use tools. If Codex Claw context was loaded into this session, reply FOUND CODEX_CLAW_CONTEXT and name the two source file headings you can see. If it was not loaded, reply NOT FOUND.

For local diagnostics:

openclaw codex-claw status
tail -n 20 ~/.codex/codex-claw-hook.log

Safety Model

The hook output explicitly tells Codex that native system, developer, safety, tool, and direct user instructions take priority over loaded context files.

The plugin does not require API keys, network credentials, browser sessions, or remote services. It reads only the configured local AGENTS.md and SOUL.md paths at Codex Desktop hook time.

Before enabling full context, review both files for instructions that:

• claim higher priority than native Codex instructions
• require OpenClaw, Claude, Eva, gateway, ACP, voice, or memory tools without scoping those requirements
• ask the agent to hide uncertainty or pretend unavailable capabilities exist
• include secrets, credentials, private customer data, or memories that should not appear in every Codex Desktop session

Good material to keep includes stable collaboration preferences, coding style, project conventions, and personality guidance that is clearly framed as lower-priority user context.

What This Package Contains

The ClawHub artifact includes:

• the OpenClaw plugin entrypoint and compiled runtime
• the openclaw codex-claw CLI implementation
• the root and bundled codex-claw skill instructions
• the Codex Desktop hook payload generator
• README and package metadata for search, review, and install clarity