用 Codex 或 Claude 帮你安装 复制这段 Prompt,粘贴到 Codex、Claude 或其他助手里,让它检查 Skill 页面并帮你完成安装。
直接命令不会经过审查 Prompt;运行前请先检查来源。
npx skills add https://github.com/Peiiii/nextclaw --skill codex-narp-runtime命令会保持在同一行。复制前请横向滚动并检查完整内容。
想先保存到本地?可下载 SkillsMP 当前能够提供的文件。
Validate, package, and submit schema v2 NextClaw Mini Apps made from Panel Apps, Service Apps, or both. Use when the user asks to publish, submit, list, or share their app in the App Marketplace, including login, personal scope, marketplace metadata, and review-status handling. Do not use for legacy schema v1 WASI NApps.
Self-manage NextClaw runtime via CLI guide. For install/start/status/doctor/service/channels/config/agents/projects/sessions/apps and App data/cron/remote/update operations, and for discovering local HTTP/API/webhook addresses.
通用开发生命周期的「交付、发布与部署」阶段 owner;当结果已经达到交付条件,或用户明确要求提交、发布、部署时使用,负责授权边界、结果交接和专项发布路由,不负责实现或 Review。
基于 SOC 职业分类
正在显示 SKILL.md
| name | codex-narp-runtime |
| description | 当用户希望把 Codex 或 Codex CLI/SDK 作为 NextClaw 正式会话类型接入,或要求安装、更新/升级 Codex NARP runtime、修复、doctor、排查版本或真实冒烟时使用。 |
| metadata | {"nextclaw":{"emoji":"C"}} |
使用这个 skill 时,目标不是让用户自己准备 PATH 或手改配置,而是把 Codex 接成 NextClaw 统一 runtime registry 里的正式会话类型。
首选产品路径固定为:
codexCodexnarp-stdioacpnextclaw-codex-narpNextClaw -> RuntimeRoute(model/apiBase/apiKey/headers) -> Codex NARP wrapper -> Codex SDK/CLI不要把 Codex 做成核心系统里的 provider 特判。NextClaw 核心、kernel、service 只感知 narp-stdio,不感知 codex。
始终区分三层:
@nextclaw/nextclaw-narp-runtime-codex-sdk,提供 nextclaw-codex-narp。安装这个 skill 不等于 Codex runtime 已经可用。skill 必须自己检测 launcher,缺失时安装或修复 wrapper,并生成 NextClaw 可稳定调用的绝对路径 shim。
nextclaw-codex-narp。${NEXTCLAW_HOME:-~/.nextclaw}/bin 下生成稳定 shim。agents.runtimes.entries.codex。nextclaw-codex-narp 放到 PATH 里”作为完成条件。config.json,除非当前 agent 没有文件写权限。当用户要求“接入 Codex”“安装 Codex runtime”“doctor Codex runtime”或类似目标时,按下面顺序执行。
先确定 NextClaw 数据目录:
NEXTCLAW_HOME="${NEXTCLAW_HOME:-$HOME/.nextclaw}"
需要写入:
$NEXTCLAW_HOME/bin/nextclaw-codex-narp$NEXTCLAW_HOME/config.json如果这是首次接入,先说明 Codex runtime 会读取本机工作区并可能执行本地工具;涉及删除、发送、提交、发布等外部可见动作时仍需用户确认。
按优先级解析真实 launcher:
packages/extensions/nextclaw-narp-runtime-codex-sdk/dist/controllers/codex-narp.controller.jspnpm --filter @nextclaw/nextclaw-narp-runtime-codex-sdk buildnextclaw-codex-narp,可作为真实 launcher 来源。mkdir -p "$NEXTCLAW_HOME/runtime/codex-narp-runtime"
npm install --prefix "$NEXTCLAW_HOME/runtime/codex-narp-runtime" @nextclaw/nextclaw-narp-runtime-codex-sdk@latest
安装后解析:
"$NEXTCLAW_HOME/runtime/codex-narp-runtime/node_modules/.bin/nextclaw-codex-narp" --help
解析系统 launcher 时必须解析真实路径,并排除 $NEXTCLAW_HOME/bin/nextclaw-codex-narp 自身,禁止生成指回自己的递归 shim。
如果包未发布、npm 不可用或安装失败,报告具体 blocker。不要退化成要求用户手动放 PATH。
把 runtime entry 的 command 固定成绝对 shim 路径,而不是裸命令名。
Unix shim 内容形态:
#!/usr/bin/env sh
exec "/absolute/path/to/nextclaw-codex-narp-or-js" "$@"
如果真实 launcher 是 .js 文件或没有执行位,则 shim 应改为:
#!/usr/bin/env sh
exec node "/absolute/path/to/codex-narp.controller.js" "$@"
写入后执行:
chmod +x "$NEXTCLAW_HOME/bin/nextclaw-codex-narp"
用 JSON parser 读写 $NEXTCLAW_HOME/config.json,保留现有配置,只补齐或修复 agents.runtimes.entries.codex:
{
"enabled": true,
"label": "Codex",
"icon": {
"kind": "image",
"src": "app://runtime-icons/codex-openai.svg",
"alt": "Codex"
},
"type": "narp-stdio",
"config": {
"wireDialect": "acp",
"processScope": "per-session",
"command": "/absolute/NEXTCLAW_HOME/bin/nextclaw-codex-narp",
"args": [],
"env": {},
"startupTimeoutMs": 10000
不要把 provider route、api key、model 写进 runtime entry。模型和 provider 仍由 NextClaw 的 provider/route 配置决定。
接入完成必须同时满足:
agents.runtimes.entries.codex.type 是 narp-stdio。wireDialect 是 acp。command 是可执行的绝对 shim 路径。Codex ready。开发仓库里优先使用已有 smoke 脚本或 NCP chat smoke;不在源码仓库时,使用当前 NextClaw 实例或 CLI 能提供的最近真实会话路径。验证不是看配置文件长得对,而是看真实会话返回。
能力验收至少分三档:
如果用户说“跑通”或“完成”,默认至少跑文本;如果用户明确要求工具/思考或这是 agent runtime 新接入,必须覆盖“思考 + 工具 + 最终文本”的同轮冒烟。
只在用户明确提出“更新/升级 Codex runtime”“更新到最新版”或指定 wrapper 版本时进入本流程。普通接入、启动、doctor 和故障排查不得顺带升级。
这里的更新对象是 @nextclaw/nextclaw-narp-runtime-codex-sdk 及其 NPM 依赖闭包,不是重新安装 NextClaw,也不是擅自更新系统全局 Codex CLI。
--help 成功代替版本识别。npm view @nextclaw/nextclaw-narp-runtime-codex-sdk@latest version 查询目标,并校验返回值是合法 semver。CODEX_NARP_PACKAGE="@nextclaw/nextclaw-narp-runtime-codex-sdk"
CODEX_NARP_TARGET_VERSION="<validated-target-version>"
CODEX_NARP_RELEASE_DIR="$NEXTCLAW_HOME/runtime/codex-narp-runtime/releases/$CODEX_NARP_TARGET_VERSION"
npm install --prefix "$CODEX_NARP_RELEASE_DIR" "$CODEX_NARP_PACKAGE@$CODEX_NARP_TARGET_VERSION"
node_modules/.bin/nextclaw-codex-narp 执行 --help。同时记录实际安装的 @nextclaw/nextclaw-ncp-runtime-codex-sdk 版本,确认依赖闭包已经落盘。$NEXTCLAW_HOME/bin/nextclaw-codex-narp。processScope 是 per-session,已运行的子进程不会热替换。不要擅自中断现有会话;通过新建 Codex 会话启动新进程,完成 runtime probe 和真实回复冒烟。原版本 -> 目标版本、shim 真实目标、probe 与冒烟结果。只有最终 package version 等于目标版本,才能说“更新完成”。如果当前已经是目标版本但 shim 仍指向全局安装或源码 dist,仍要安装/复用受管版本目录并切换 shim;只有“版本相等 + shim 已指向该受管版本 + 验证通过”时才可以跳过安装。
任何查询、安装或切换前验证失败,都必须保留原 shim,不得报告更新成功。可以明确报告“旧版本仍可用,更新失败在第 N 步”,但不要自动回退到全局 launcher、源码 dist 或另一个版本。
当用户要求 doctor 或报错时,按顺序检查:
$NEXTCLAW_HOME/config.json 是否存在且 JSON 可解析。agents.runtimes.entries.codex 是否存在、enabled 是否为 true。type、wireDialect、processScope 是否符合合同。command 是否是绝对路径、文件是否存在且可执行。--help 是否能启动。根据第一个失败点修复。不要在下游事件层伪造成功。
Doctor 可以报告当前 wrapper 版本;除非用户同时明确要求更新,否则不要查询最新版或安装新版本。发现已知版本问题时先建议更新并等待用户确认。
command_missing:重新生成 shim;如果真实 launcher 缺失,安装 wrapper 包。删除 runtime entry、shim 或 wrapper 安装目录属于破坏性配置变更。除非用户明确要求“移除 Codex runtime”,否则只做 disable/repair,不删除文件。
只有在以下条件全部满足后,才能说 Codex NARP runtime 已可用:
Codex 是统一 runtime registry 里的正式 session type。narp-stdio(acp) 接入。