让开源，少一点语言距离。
npm包中文文档

@clawling/clawchat-plugin-install-cli

中文文档
0.4.8发布于 2026/10/24MITTypeScriptES Module零依赖近 30 天下载 1699

CLI for ClawChat plugin installation and updates.

原始使用文档
中文原文

@clawling/clawchat-plugin-install-cli

CLI for installing and updating ClawChat plugins in supported agents.

Install

npx -y @clawling/clawchat-plugin-install-cli@latest install --target openclaw

npx -y @clawling/clawchat-plugin-install-cli@latest install --target hermes

For OpenClaw, install delegates to openclaw plugins install @clawling/clawchat-plugin-openclaw --force --dangerously-force-unsafe-install. --force is unconditional on install; the CLI also appends --accept-capabilities when the host's install help advertises it. ClawChat is a third-party (non-catalog) plugin: on older OpenClaw the unsafe-install flag bypasses the install-time safety scan that would block it, and on newer OpenClaw it is a deprecated no-op (installs allowed by default; operator gating via security.installPolicy) — safe on both. For Hermes, install first fetches the remote plugin.yaml, validates that hermes --version satisfies the declared requirement, and only then installs or updates the plugin. ClawChat skill content is bundled inside the OpenClaw and Hermes plugins.

Both commands accept --force to reinstall the plugin even when the host reports it as current.

For Hermes, both install and update accept --install-timeout <seconds> for the canonical remote hermes plugins install step (including --force reinstalls). The flag overrides CLAWCHAT_INSTALL_TIMEOUT_SECONDS; both accept integers from 1 to 3600 seconds, with a default of 120 seconds (120_000 ms). Invalid values fail validation. The progress line shows the limit; on timeout the command is stopped with SIGKILL and the error explains how to raise it. Other Hermes steps keep their existing budgets, and OpenClaw ignores this setting.

install also accepts --activate <code> (Hermes only): after a successful install the CLI runs hermes clawchat activate <code> once, so installing and pairing is a single command. The code is single-use and is never retried; the result line ends with + activated.

For Hermes, --profile <name> targets a specific Hermes profile: the CLI passes -p <name> to the delegated hermes calls and writes base URLs to that profile's $HERMES_HOME/.env. It resolves to <HERMES_HOME-or-platform-default>/profiles/<name>, so pass --profile or point HERMES_HOME at the profile directory — never both. On a multi-profile host, confirm the active profile before installing or activating: a mis-targeted run pairs a different agent with no error, and connect codes are single-use.

Update

npx -y @clawling/clawchat-plugin-install-cli@latest update --target openclaw

npx -y @clawling/clawchat-plugin-install-cli@latest update --target hermes

For OpenClaw, update delegates to openclaw plugins update @clawling/clawchat-plugin-openclaw --dangerously-force-unsafe-install, appending --accept-capabilities when supported by the host. For Hermes, update requires an installed plugin and delegates to hermes plugins update clawchat, even when the installed plugin.yaml version already matches the remote version, followed by hermes plugins enable clawchat unless the host reports that its scan disabled the plugin (SCAN_BLOCKED). --force lifts that requirement: update --target hermes --force on a host with no ClawChat plugin installs it instead of failing.

Use --force as an explicit repair/reinstall path. For Hermes, the first attempt is hermes plugins install clawling/clawchat-plugin-hermes-agent --enable, without the host's --force. Only after the scan passes and the host reports already exists does the CLI retry with --force --enable to replace the existing install. Scan refusals stop with SCAN_BLOCKED; the CLI's --force does not override them. For Hermes update failures caused by dirty local plugin files or Git fast-forward conflicts, repair explicitly with npx -y @clawling/clawchat-plugin-install-cli@latest update --target hermes --force.

版本与发布记录

@clawling/clawchat-plugin-install-cli 共发布 23 个版本，首次发布于 2026/05/31；过去 12 个月发布了 23 个版本。

版本发布日期距今
0.4.8latest2026/10/2416 天前
0.4.72026/10/1229 天前
0.4.62026/09/231 个月前
0.4.52026/09/221 个月前
0.4.42026/09/171 个月前
0.4.32026/09/042 个月前

其他发布通道：dev → 0.4.3-dev.0。

关于 @clawling/clawchat-plugin-install-cli 的常见问题

@clawling/clawchat-plugin-install-cli 是什么？

CLI for ClawChat plugin installation and updates.

如何安装 @clawling/clawchat-plugin-install-cli？

在项目目录运行 npm install @clawling/clawchat-plugin-install-cli，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 clawchat，可以用 npx clawchat 直接运行。

@clawling/clawchat-plugin-install-cli 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

@clawling/clawchat-plugin-install-cli 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module，更早的版本需要改用动态 import()。

@clawling/clawchat-plugin-install-cli 需要什么版本的 Node.js？

package.json 的 engines 字段要求 Node.js >=18。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

@clawling/clawchat-plugin-install-cli 可以商用吗？

@clawling/clawchat-plugin-install-cli 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

@clawling/clawchat-plugin-install-cli 的下载量有多少？

根据 npm 官方下载统计，@clawling/clawchat-plugin-install-cli 在 2026/10/10 – 2026/11/08 这 30 天内被下载 1,699 次，日均约 57 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

@clawling/clawchat-plugin-install-cli 还在维护吗？

最新版本 0.4.8 发布于 2026/10/24（16 天前）；至今共发布 23 个版本，其中过去 12 个月发布了 23 个；首次发布于 2026/05/31。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。