← 返回 Skills 市场
100yenadmin

Codex Claw

作者 Eva · GitHub ↗ · v1.0.1 · MIT-0
cross-platform ✓ 安全检测通过
58
总下载
0
收藏
0
当前安装
2
版本数
在 OpenClaw 中安装
/install codex-claw
功能描述
Install and verify Codex Claw for Codex Desktop AGENTS.md, Agent MD, SOUL.md, soul file, session memory, personality, and OpenClaw workspace context loading...
使用说明 (SKILL.md)

Codex Claw

Use this skill when a user wants Codex Desktop to load selected OpenClaw AGENTS.md and SOUL.md context, asks how to install the Codex Claw plugin, or needs to review those files for compatibility with native Codex behavior.

This skill is the searchable setup and safety guide. The actual runtime is the OpenClaw code plugin package @openclaw/codex-claw.

Search phrases this skill should satisfy: Codex Desktop AGENTS.md, Agent MD, SOUL.md, soul file, soul loader, Codex personality, Codex memory, OpenClaw workspace context, post-compaction context, and Codex plugin install.

Install The Plugin

Prefer the ClawHub package when the local OpenClaw build supports ClawHub plugin install routing:

openclaw plugins install clawhub:@openclaw/codex-claw

If the local installer says the ClawHub artifact is not exposed for direct plugin install yet, download the package from ClawHub and install the verified .tgz artifact directly:

clawhub package download @openclaw/codex-claw --version latest -o /tmp/codex-claw --force
openclaw plugins install /tmp/codex-claw/openclaw-codex-claw-*.tgz --force

Restart the OpenClaw gateway after plugin installation.

Configure Codex Desktop Context

Run the plugin command from the OpenClaw workspace that owns the context files:

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

The command writes:

  • ~/.codex/openclaw-codex-claw-marketplace, the local Codex Desktop marketplace payload
  • ~/.codex/codex-claw.json, the explicit source paths and reinjection mode

It does not copy the real AGENTS.md or SOUL.md files into the plugin. Codex Desktop hooks read only the configured local paths at session time.

Register the generated marketplace with Codex Desktop:

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

On macOS, if codex is not on PATH, use:

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

Enable plugins and hooks in ~/.codex/config.toml:

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

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

Restart Codex Desktop after changing the marketplace or config.

Verify

Check local bridge state without reading private file contents:

openclaw codex-claw status

Then start a fresh Codex Desktop session and ask:

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.

If verification fails, inspect diagnostics:

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

Fresh sessions are the best test. Existing sessions may not load newly added plugin context until Codex Desktop restarts or a new session starts.

Review AGENTS.md And SOUL.md

Before making these files always-on Codex Desktop context, ask the user to clean or scope anything that conflicts with native Codex behavior.

Use these questions:

  • Does either file claim priority over Codex system, developer, safety, tool, or direct user instructions?
  • Does either file require OpenClaw, Claude, Eva, gateway, ACP, TTS, memory, or browser tools that may not exist in native Codex Desktop?
  • Does either file tell the agent to hide uncertainty, suppress failed tests, or pretend unavailable capabilities are available?
  • Does either file trigger automatic publishing, messaging, browsing, file editing, or credential access without explicit user approval?
  • Does either file contain secrets, API keys, customer data, private memories, or local-only paths that should not appear in every Codex session?
  • Are personality and collaboration preferences framed as lower-priority user context rather than as system rules?
  • Are project conventions stable enough to load every session, or should they remain workspace-local and be loaded only on demand?

Keep stable collaboration preferences, coding style, repo conventions, review preferences, and personality guidance when they are clearly lower-priority user context and do not ask Codex to misrepresent its capabilities.

What Codex Claw Does Not Do

  • It does not require API keys, browser sessions, remote services, or network credentials.
  • It does not upload AGENTS.md or SOUL.md to ClawHub.
  • It does not make loaded context higher priority than native Codex instructions.
  • It does not prove that every instruction inside the loaded files is safe. Review the files before enabling them broadly.

ClawHub Display Caveat

If the ClawHub package page does not show the plugin README or source files, verify the downloadable artifact rather than assuming the package is empty:

clawhub package download @openclaw/codex-claw --version latest -o /tmp/codex-claw --force
clawhub package verify /tmp/codex-claw/openclaw-codex-claw-*.tgz --package @openclaw/codex-claw --version latest
tar -tzf /tmp/codex-claw/openclaw-codex-claw-*.tgz | sort

Current ClawHub npm-pack package listings may expose only metadata files such as package.json and openclaw.plugin.json even when the tarball contains the README, runtime, source, and bundled skill.

安全使用建议
Before installing, verify the @openclaw/codex-claw package artifact, consider pinning a specific version, review AGENTS.md and SOUL.md for secrets or instructions that conflict with Codex safety/user intent, and know how to disable the plugin hooks if the context loading is no longer desired.
功能分析
Type: OpenClaw Skill Name: codex-claw Version: 1.0.1 The codex-claw skill bundle provides instructions and CLI commands for installing and configuring a plugin to sync workspace context (AGENTS.md and SOUL.md) between OpenClaw and Codex Desktop. The SKILL.md file includes proactive safety guidance, advising users to review their context files for sensitive data like API keys or credentials before enabling the plugin. No evidence of malicious intent, data exfiltration, or obfuscation was found; the operations are consistent with the stated purpose of plugin management and configuration.
能力标签
crypto
能力评估
Purpose & Capability
The stated purpose matches the instructions: installing a Codex Desktop/OpenClaw context-loading plugin. The actual runtime is an external package not included in this artifact set, so this review covers only the setup guide.
Instruction Scope
The skill presents user-directed setup commands and includes a review checklist warning users to remove secrets, priority conflicts, and unsafe auto-actions from AGENTS.md/SOUL.md before enabling broad context loading.
Install Mechanism
There is no install spec or local code, but SKILL.md instructs the user to install a ClawHub plugin package, including a latest-version download and --force install path. This is purpose-aligned but should be verified and preferably pinned.
Credentials
The guide writes Codex configuration under ~/.codex and reads explicitly configured local AGENTS.md/SOUL.md paths at session time. This is proportional to the stated purpose, but those files may contain private memory or project context.
Persistence & Privilege
The setup enables Codex plugins/hooks and describes reinjection after compaction, meaning the context-loading behavior can persist across Codex sessions until disabled.
如何使用
  1. 确保已安装 OpenClaw(本地或 Docker 部署)
  2. 在对话框中输入安装命令:/install codex-claw
  3. 安装完成后,直接呼叫该 Skill 的名称或使用 /codex-claw 触发
  4. 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
v1.0.1
Improve discoverability for AGENTS.md, Agent MD, SOUL.md, soul file, memory, personality, and Codex Desktop plugin install searches.
v1.0.0
Initial companion skill for discovering, installing, verifying, and safely configuring the Codex Claw plugin.
元数据
Slug codex-claw
版本 1.0.1
许可证 MIT-0
累计安装 0
当前安装数 0
历史版本数 2
常见问题

Codex Claw 是什么?

Install and verify Codex Claw for Codex Desktop AGENTS.md, Agent MD, SOUL.md, soul file, session memory, personality, and OpenClaw workspace context loading... 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 58 次。

如何安装 Codex Claw?

在 OpenClaw 或 Claude Code 对话框中运行命令「/install codex-claw」即可一键安装,无需额外配置。

Codex Claw 是免费的吗?

是的,Codex Claw 完全免费,采用 MIT-0 许可证,可自由下载、安装和使用。

Codex Claw 支持哪些平台?

Codex Claw 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。

谁开发了 Codex Claw?

由 Eva(@100yenadmin)开发并维护,当前版本 v1.0.1。

💬 留言讨论