Nextclaw Narp Stdio Runtime Integration
Peiiii/nextclaw
当把 Codex、Claude Code、Hermes 或其他外部 agent runtime 通过 NARP stdio 接入 NextClaw,或触达 narp-stdio entry、launcher、agent-side wrapper 和旧 runtime 插件迁移时使用。
当用户希望把 Codex 或 Codex CLI/SDK 作为 NextClaw 正式会话类型接入,或要求安装、更新/升级 Codex NARP runtime、修复、doctor、排查版本或真实冒烟时使用。
$ npx skills add Peiiii/nextclaw --skill codex-narp-runtime -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install Peiiii/nextclaw codex-narp-runtime --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/Peiiii/nextclaw.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/codex-narp-runtime .claude/skills/codex-narp-runtime && rm -rf skills-srcUse ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.
Claude Code skills documentation · loads skills from .claude/skills/
Install the "codex-narp-runtime" agent skill from https://github.com/Peiiii/nextclaw/tree/master/skills/codex-narp-runtime into .claude/skills/codex-narp-runtime/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "codex-narp-runtime", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/Peiiii/nextclaw/tree/master/skills/codex-narp-runtimeType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add Peiiii/nextclaw --skill codex-narp-runtime -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install Peiiii/nextclaw codex-narp-runtime --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/Peiiii/nextclaw.git skills-src && mkdir -p .agents/skills && cp -r skills-src/skills/codex-narp-runtime .agents/skills/codex-narp-runtime && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "codex-narp-runtime" agent skill from https://github.com/Peiiii/nextclaw/tree/master/skills/codex-narp-runtime into .agents/skills/codex-narp-runtime/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "codex-narp-runtime", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add Peiiii/nextclaw --skill codex-narp-runtime -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install Peiiii/nextclaw codex-narp-runtime --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/Peiiii/nextclaw.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/skills/codex-narp-runtime .cursor/skills/codex-narp-runtime && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "codex-narp-runtime" agent skill from https://github.com/Peiiii/nextclaw/tree/master/skills/codex-narp-runtime into .cursor/skills/codex-narp-runtime/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "codex-narp-runtime", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/Peiiii/nextclaw.git --path skills/codex-narp-runtime--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add Peiiii/nextclaw --skill codex-narp-runtime -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install Peiiii/nextclaw codex-narp-runtime --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/Peiiii/nextclaw.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/skills/codex-narp-runtime .gemini/skills/codex-narp-runtime && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "codex-narp-runtime" agent skill from https://github.com/Peiiii/nextclaw/tree/master/skills/codex-narp-runtime into .gemini/skills/codex-narp-runtime/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "codex-narp-runtime", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install Peiiii/nextclaw codex-narp-runtimeInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add Peiiii/nextclaw --skill codex-narp-runtime -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/Peiiii/nextclaw.git skills-src && mkdir -p .github/skills && cp -r skills-src/skills/codex-narp-runtime .github/skills/codex-narp-runtime && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "codex-narp-runtime" agent skill from https://github.com/Peiiii/nextclaw/tree/master/skills/codex-narp-runtime into .github/skills/codex-narp-runtime/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "codex-narp-runtime", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add Peiiii/nextclaw --skill codex-narp-runtime -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install Peiiii/nextclaw codex-narp-runtime --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/Peiiii/nextclaw.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/skills/codex-narp-runtime .opencode/skills/codex-narp-runtime && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "codex-narp-runtime" agent skill from https://github.com/Peiiii/nextclaw/tree/master/skills/codex-narp-runtime into .opencode/skills/codex-narp-runtime/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "codex-narp-runtime", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
codex-narp-runtime当用户希望把 Codex 或 Codex CLI/SDK 作为 NextClaw 正式会话类型接入,或要求安装、更新/升级 Codex NARP runtime、修复、doctor、排查版本或真实冒烟时使用。
Codex Narp Runtime is an agent skill from Peiiii/nextclaw. 当用户希望把 Codex 或 Codex CLI/SDK 作为 NextClaw 正式会话类型接入,或要求安装、更新/升级 Codex NARP runtime、修复、doctor、排查版本或真实冒烟时使用。
Its SKILL.md is about 1.8k tokens, which your agent loads only when the skill is triggered. The skill folder holds 1 other file (for example `marketplace.json`).
The repository describes itself as: A human-centered long-term AI partner—not a task-centered assistant. The licence is MIT.
5 steps, taken from the step headings in SKILL.md.
Read from SKILL.md and the folder at commit 973722e. It shows what the files ask for, not the result of running them.
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Shell commands in SKILL.md call:
npmnodepnpmFrom the folder's file list and the shell code blocks in SKILL.md.
No URLs in SKILL.md. Its commands use npm and pnpm, which can reach the network depending on how they are called.
From URLs in SKILL.md, links to its own repository left out.
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Codex Narp Runtime loads about 1.8k tokens when it runs. Until then it costs about 31 tokens; SKILL.md has 535 words of instructions outside code blocks.
Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.
The automated check found no risky patterns in SKILL.md.
Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.
The full file from Peiiii/nextclaw at commit 973722e, republished under its MIT licence (© Peiiii). 535 words, ~1,812 tokens.
.claude/skills/codex-narp-runtime/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.使用这个 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,
"probeTimeoutMs": 3000,
"requestTimeoutMs": 120000
}
}不要把 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) 接入。© Peiiii, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
SKILL.md and 1 other file in skills/codex-narp-runtime of Peiiii/nextclaw.
Open the folder on GitHubat commit 973722e
Codex Narp Runtime next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Codex Narp Runtime this skillPeiiii/nextclaw | 260 | — | ~1.8k | Automated safety check: Pass | MIT | |
| Nextclaw Narp Stdio Runtime IntegrationPeiiii/nextclaw | 260 | — | ~761 | Automated safety check: Pass | MIT | |
| Claude Code Narp RuntimePeiiii/nextclaw | 260 | — | ~1.6k | Automated safety check: Pass | MIT | |
| Clawhub NextclawPeiiii/nextclaw | 260 | — | ~1.4k | Automated safety check: Pass | MIT | |
| Nextclaw AutostartPeiiii/nextclaw | 260 | — | ~943 | Automated safety check: Notes | MIT | |
| Nextclaw Self ManagePeiiii/nextclaw | 260 | — | ~3.5k | Automated safety check: Pass | MIT |
Peiiii/nextclaw
当把 Codex、Claude Code、Hermes 或其他外部 agent runtime 通过 NARP stdio 接入 NextClaw,或触达 narp-stdio entry、launcher、agent-side wrapper 和旧 runtime 插件迁移时使用。
Peiiii/nextclaw
当用户希望把 Claude Code 作为 NextClaw 正式会话类型接入,尤其是通过 narp-stdio 配置、安装、修复、doctor、补齐 Runtime default 模型选项或真实冒烟时使用。
Peiiii/nextclaw
A skill your agent uses when the user wants to search external ClawHub skills or install a ClawHub skill into a NextClaw workspace's skills directory without treating ClawHub as the NextClaw…
Peiiii/nextclaw
A skill your agent uses when the user asks about NextClaw autostart, auto-start on login or reboot, daemon/service registration, LaunchAgent, systemd, Windows Scheduled Task, service autostart…
Peiiii/nextclaw
Self-manage NextClaw runtime via CLI guide. An agent skill from Peiiii/nextclaw.
Peiiii/nextclaw
NextClaw NPM package 与 runtime channel 发布的专项流程 owner;用于发布 NPM、NPM 测试版、NextClaw 常规正式版及其恢复,覆盖 beta/stable、真实安装和分支回流,并按当前阶段读取一个 reference。
Peiiii/nextclaw
A skill your agent uses when a user wants to browse, apply, inspect, create, refine, switch, or remove a NextClaw skin; wants a personal skin with arbitrary CSS, JavaScript, images, SVG, DOM…
Peiiii/nextclaw
A skill your agent uses when a development task needs visible phase tracing, task-level or phase-level Token measurement, model/effort comparison, or a deterministic usage report or local dashboard…
Peiiii/nextclaw
当 NextClaw 产品更新后需要生成、替换、挑毛病或检查官网、GitHub README、用户文档或社交传播中的真实截图、AI 宣传视觉、整页 HTML 宣传预览、社区二维码等对外视觉资产时使用;也用于“更新截图”“重新截一批图”“做宣传页”“生成 campaign 页面”“视觉审稿”“五星挑刺法”或发布前检查视觉资产。普通站点布局开发或只写文章不触发。
Peiiii/nextclaw
A skill your agent uses when the user wants professional UI/UX design guidance, design-system generation, UX review, or stack-specific frontend guidance through a bundled local UI/UX Pro Max dataset…
Peiiii/nextclaw
A skill your agent uses when the user wants distinctive, production-grade frontend design, anti-generic AI aesthetics, UX critique, technical UI audits, or final polish through bundled Impeccable…
Peiiii/nextclaw
Curate NextClaw skill resources, including OpenClaw and community sources.
当用户希望把 Codex 或 Codex CLI/SDK 作为 NextClaw 正式会话类型接入,或要求安装、更新/升级 Codex NARP runtime、修复、doctor、排查版本或真实冒烟时使用。. Codex Narp Runtime is an agent skill from Peiiii/nextclaw.
Run `npx skills add Peiiii/nextclaw --skill codex-narp-runtime -a claude-code`. Or copy the skill folder (skills/codex-narp-runtime in Peiiii/nextclaw) into .claude/skills/codex-narp-runtime in your project. Claude Code loads it when a task matches its description.
Run `npx skills add Peiiii/nextclaw --skill codex-narp-runtime -a codex`. Or copy the skill folder (skills/codex-narp-runtime in Peiiii/nextclaw) into .agents/skills/codex-narp-runtime in your project. Codex loads it when a task matches its description.
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add Peiiii/nextclaw --skill codex-narp-runtime -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/codex-narp-runtime, .gemini/skills/codex-narp-runtime, .github/skills/codex-narp-runtime and .opencode/skills/codex-narp-runtime in your project.
Going by SKILL.md and its folder, Codex Narp Runtime needs the command-line tools its instructions call (npm, node and pnpm). Our summary lists: Node.js.
SKILL.md contains no URLs. Its commands use npm, which can reach the network depending on how they are called. This is read from the text; nothing was executed.
Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.
Codex Narp Runtime is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.
About 1.8k tokens (SKILL.md is roughly 7.2k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.
Skills that share tags, products or a category with Codex Narp Runtime: Nextclaw Narp Stdio Runtime Integration (Peiiii/nextclaw, 260 stars), Claude Code Narp Runtime (Peiiii/nextclaw, 260 stars), Clawhub Nextclaw (Peiiii/nextclaw, 260 stars) and Nextclaw Autostart (Peiiii/nextclaw, 260 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Peiiii (a GitHub user) maintains it in Peiiii/nextclaw, which has 260 GitHub stars. The repository holds 70 skills in this directory. The repository was last updated on October 7, 2026.
Source: Peiiii/nextclaw on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.