{"skill":{"slug":"codex-claw","displayName":"Codex Claw","summary":"Install and verify Codex Claw for Codex Desktop AGENTS.md, Agent MD, SOUL.md, soul file, session memory, personality, and OpenClaw workspace context loading...","description":"---\nname: codex-claw\ndescription: Install and verify Codex Claw for Codex Desktop AGENTS.md, Agent MD, SOUL.md, soul file, session memory, personality, and OpenClaw workspace context loading through the @openclaw/codex-claw plugin with post-compaction reinjection.\nmetadata:\n  short-description: Install and verify Codex Desktop AGENTS.md/SOUL.md context loading\n  tags:\n    - codex\n    - codex-desktop\n    - openclaw\n    - agents-md\n    - agent-md\n    - soul-md\n    - soul-file\n    - context\n    - memory\n    - personality\n    - plugin-install\n---\n\n# Codex Claw\n\nUse this skill when a user wants Codex Desktop to load selected OpenClaw\n`AGENTS.md` and `SOUL.md` context, asks how to install the Codex Claw plugin,\nor needs to review those files for compatibility with native Codex behavior.\n\nThis skill is the searchable setup and safety guide. The actual runtime is the\nOpenClaw code plugin package `@openclaw/codex-claw`.\n\nSearch phrases this skill should satisfy: Codex Desktop AGENTS.md, Agent MD,\nSOUL.md, soul file, soul loader, Codex personality, Codex memory, OpenClaw\nworkspace context, post-compaction context, and Codex plugin install.\n\n## Install The Plugin\n\nPrefer the ClawHub package when the local OpenClaw build supports ClawHub plugin\ninstall routing:\n\n```bash\nopenclaw plugins install clawhub:@openclaw/codex-claw\n```\n\nIf the local installer says the ClawHub artifact is not exposed for direct\nplugin install yet, download the package from ClawHub and install the verified\n`.tgz` artifact directly:\n\n```bash\nclawhub package download @openclaw/codex-claw --version latest -o /tmp/codex-claw --force\nopenclaw plugins install /tmp/codex-claw/openclaw-codex-claw-*.tgz --force\n```\n\nRestart the OpenClaw gateway after plugin installation.\n\n## Configure Codex Desktop Context\n\nRun the plugin command from the OpenClaw workspace that owns the context files:\n\n```bash\nopenclaw codex-claw install \\\n  --agents ~/.openclaw/workspace/AGENTS.md \\\n  --soul ~/.openclaw/workspace/SOUL.md\n```\n\nThe command writes:\n\n- `~/.codex/openclaw-codex-claw-marketplace`, the local Codex Desktop\n  marketplace payload\n- `~/.codex/codex-claw.json`, the explicit source paths and reinjection mode\n\nIt does not copy the real `AGENTS.md` or `SOUL.md` files into the plugin. Codex\nDesktop hooks read only the configured local paths at session time.\n\nRegister the generated marketplace with Codex Desktop:\n\n```bash\ncodex plugin marketplace add ~/.codex/openclaw-codex-claw-marketplace\n```\n\nOn macOS, if `codex` is not on `PATH`, use:\n\n```bash\n/Applications/Codex.app/Contents/Resources/codex plugin marketplace add ~/.codex/openclaw-codex-claw-marketplace\n```\n\nEnable plugins and hooks in `~/.codex/config.toml`:\n\n```toml\n[features]\nplugins = true\ncodex_hooks = true\nplugin_hooks = true\n\n[plugins.\"codex-claw@codex-claw\"]\nenabled = true\n```\n\nRestart Codex Desktop after changing the marketplace or config.\n\n## Verify\n\nCheck local bridge state without reading private file contents:\n\n```bash\nopenclaw codex-claw status\n```\n\nThen start a fresh Codex Desktop session and ask:\n\n```text\nDo 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.\n```\n\nIf verification fails, inspect diagnostics:\n\n```bash\ntail -n 50 ~/.codex/codex-claw-hook.log\nopenclaw codex-claw status\n```\n\nFresh sessions are the best test. Existing sessions may not load newly added\nplugin context until Codex Desktop restarts or a new session starts.\n\n## Review AGENTS.md And SOUL.md\n\nBefore making these files always-on Codex Desktop context, ask the user to\nclean or scope anything that conflicts with native Codex behavior.\n\nUse these questions:\n\n- Does either file claim priority over Codex system, developer, safety, tool, or\n  direct user instructions?\n- Does either file require OpenClaw, Claude, Eva, gateway, ACP, TTS, memory, or\n  browser tools that may not exist in native Codex Desktop?\n- Does either file tell the agent to hide uncertainty, suppress failed tests, or\n  pretend unavailable capabilities are available?\n- Does either file trigger automatic publishing, messaging, browsing, file\n  editing, or credential access without explicit user approval?\n- Does either file contain secrets, API keys, customer data, private memories,\n  or local-only paths that should not appear in every Codex session?\n- Are personality and collaboration preferences framed as lower-priority user\n  context rather than as system rules?\n- Are project conventions stable enough to load every session, or should they\n  remain workspace-local and be loaded only on demand?\n\nKeep stable collaboration preferences, coding style, repo conventions, review\npreferences, and personality guidance when they are clearly lower-priority user\ncontext and do not ask Codex to misrepresent its capabilities.\n\n## What Codex Claw Does Not Do\n\n- It does not require API keys, browser sessions, remote services, or network\n  credentials.\n- It does not upload `AGENTS.md` or `SOUL.md` to ClawHub.\n- It does not make loaded context higher priority than native Codex\n  instructions.\n- It does not prove that every instruction inside the loaded files is safe.\n  Review the files before enabling them broadly.\n\n## ClawHub Display Caveat\n\nIf the ClawHub package page does not show the plugin README or source files,\nverify the downloadable artifact rather than assuming the package is empty:\n\n```bash\nclawhub package download @openclaw/codex-claw --version latest -o /tmp/codex-claw --force\nclawhub package verify /tmp/codex-claw/openclaw-codex-claw-*.tgz --package @openclaw/codex-claw --version latest\ntar -tzf /tmp/codex-claw/openclaw-codex-claw-*.tgz | sort\n```\n\nCurrent ClawHub npm-pack package listings may expose only metadata files such\nas `package.json` and `openclaw.plugin.json` even when the tarball contains the\nREADME, runtime, source, and bundled skill.\n","tags":{"agent-md":"1.0.1","agents-md":"1.0.1","codex":"1.0.1","codex-desktop":"1.0.1","context":"1.0.1","latest":"1.0.1","memory":"1.0.1","openclaw":"1.0.1","personality":"1.0.1","plugin-install":"1.0.1","soul-file":"1.0.1","soul-md":"1.0.1"},"stats":{"comments":0,"downloads":349,"installsAllTime":13,"installsCurrent":0,"stars":0,"versions":2},"createdAt":1777846886625,"updatedAt":1778492842520},"latestVersion":{"version":"1.0.1","createdAt":1777846969464,"changelog":"Improve discoverability for AGENTS.md, Agent MD, SOUL.md, soul file, memory, personality, and Codex Desktop plugin install searches.","license":"MIT-0"},"metadata":null,"owner":{"handle":"100yenadmin","userId":"s17b82a1f40fwepa72qw6dhmrd8605j2","displayName":"Eva","image":"https://avatars.githubusercontent.com/u/239388517?v=4"},"moderation":null}