ClawJection
Use this skill when the user asks you to install or run a ClawJection.
What ClawJection Is
ClawJection is a bundle format for modifying a local OpenClaw instance so it adopts a specific role or capability set.
A ClawJection bundle has:
- - a required INLINECODE0
- an entrypoint declared by that manifest
- arbitrary bundle internals chosen by the bundle author
The entrypoint is expected to:
- - modify the OpenClaw workspace or local runtime
- install tools, skills, or auth setup when needed
- return a structured result JSON with ordered INLINECODE1
Install Flow
- 1. Get the bundle locally.
- Find the bundle root by locating
clawjection.yaml. - Read
clawjection.yaml and resolve entrypoint.path. - Run the entrypoint from the bundle root with the
apply action. - By default, let the entrypoint discover OpenClaw config from
~/.openclaw/openclaw.json. - If needed, pass
--openclaw-config-path <path>. - Treat stdout as agent-readable hints.
- Read the structured result JSON from
CLAWJECTION_RESULT_PATH. - Execute the returned ordered
followups.
Source Types
Git repository
- - Clone the repo to a temporary local directory.
- If the repo contains multiple bundles, choose the directory containing the intended
clawjection.yaml.
Archive URL or local zip
- - Download or unpack it to a temporary local directory.
- Identify the bundle root by locating
clawjection.yaml.
Local directory
- - Use it directly if it contains
clawjection.yaml.
Execution Rules
- - Run from the bundle root so relative paths in the bundle resolve correctly.
- Do not assume the bundle layout beyond
clawjection.yaml and the declared entrypoint. - If the bundle installs CLIs or skills, verify they were actually installed before claiming success.
- If the result says
needs_user_action, do not treat the setup as finished; perform the followups.
Safety
- - Review what the entrypoint appears to do before running untrusted bundles.
- Tell the user when a bundle will overwrite core OpenClaw files such as
IDENTITY.md. - Never claim a remote skill or CLI is installed unless the install command succeeded.
- Keep secrets out of workspace files unless the bundle explicitly requires that behavior and the user agrees.
References
- - Read
standard/v1.md in this repo for the full execution contract. - Read
schemas/clawjection.schema.json and schemas/result.schema.json when you need the exact manifest or result structure.
ClawJection
当用户要求您安装或运行ClawJection时，请使用此技能。
ClawJection是什么
ClawJection是一种捆绑包格式，用于修改本地OpenClaw实例，使其采用特定的角色或能力集。
一个ClawJection捆绑包包含：
- - 必需的 clawjection.yaml
- 该清单文件声明的入口点
- 由捆绑包作者选择的任意捆绑包内部内容
入口点需要：
- - 修改OpenClaw工作空间或本地运行时
- 在需要时安装工具、技能或认证配置
- 返回包含有序 followups 的结构化结果JSON
安装流程
- 1. 在本地获取捆绑包。
- 通过定位 clawjection.yaml 找到捆绑包根目录。
- 读取 clawjection.yaml 并解析 entrypoint.path。
- 使用 apply 操作从捆绑包根目录运行入口点。
- 默认情况下，让入口点从 ~/.openclaw/openclaw.json 发现OpenClaw配置。
- 如果需要，传递 --openclaw-config-path 。
- 将标准输出视为代理可读的提示信息。
- 从 CLAWJECTIONRESULTPATH 读取结构化结果JSON。
- 执行返回的有序 followups。
源类型
Git仓库
- - 将仓库克隆到临时本地目录。
- 如果仓库包含多个捆绑包，选择包含目标 clawjection.yaml 的目录。
归档URL或本地zip
- - 下载或解压到临时本地目录。
- 通过定位 clawjection.yaml 确定捆绑包根目录。
本地目录
- - 如果包含 clawjection.yaml，则直接使用。
执行规则
- - 从捆绑包根目录运行，以便捆绑包中的相对路径能够正确解析。
- 除了 clawjection.yaml 和声明的入口点外，不要假设捆绑包的结构。
- 如果捆绑包安装了CLI或技能，在声明成功前验证它们是否确实已安装。
- 如果结果返回 needsuseraction，不要将设置视为完成；执行 followups。
安全
- - 在运行不受信任的捆绑包之前，检查入口点似乎要执行的操作。
- 当捆绑包将覆盖核心OpenClaw文件（如 IDENTITY.md）时，告知用户。
- 除非安装命令成功，否则永远不要声称远程技能或CLI已安装。
- 除非捆绑包明确要求该行为且用户同意，否则将机密信息保留在工作空间文件之外。
参考
- - 阅读此仓库中的 standard/v1.md 以获取完整的执行合同。
- 当需要确切的清单或结果结构时，阅读 schemas/clawjection.schema.json 和 schemas/result.schema.json。
