# @clawling/clawchat-plugin-install-cli 中文文档

规范地址：https://npmcn.com/package/%40clawling/clawchat-plugin-install-cli/

版本：0\.4\.8
npm 元数据更新时间：2026-10-24T10:39:00.684Z
中文译文更新时间：2026-11-10T00:28:31.433Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40clawling/clawchat-plugin-install-cli
原文对照：https://npmcn.com/package/%40clawling/clawchat-plugin-install-cli/?lang=original
项目主页：https://github.com/clawling/clawchat-plugin-install-cli#readme
源码仓库：https://github.com/clawling/clawchat-plugin-install-cli

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：90.6 kB，4 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：\>=18
- 运行依赖：0 个
- 首次发布：2026-05-31T03:56:46.090Z
- 最新版本发布：2026-10-24T10:39:00.483Z
- 近 30 天下载量：1699（2026-10-10 至 2026-11-08，npm 官方下载统计）
- 已发布版本数：23（近 12 个月 23 个）

## 中文简介

ClawChat插件安装和更新的 CLI.

## 安装

```sh
npm install @clawling/clawchat-plugin-install-cli
```

也可以使用：`pnpm add @clawling/clawchat-plugin-install-cli`、`yarn add @clawling/clawchat-plugin-install-cli`、`bun add @clawling/clawchat-plugin-install-cli`

## README

# @clawling/clawchat-plugin-install-cli (英语)

用于安装和更新支持代理的 ClawChat 插件的 CLI .

## 安装

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

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

对于OpenClaw, `install` 代表团 `openclaw plugins install @clawling/clawchat-plugin-openclaw --force --dangerously-force-unsafe-install`。 。 。 . `--force` 安装时为无条件; CLI 也为附件 `--accept-capabilities` 当主机的安装帮助广告。 ClawChat是第三方(非目录)插件:在更古老的OpenClaw上,不安全的安装旗会绕过会屏蔽它的安装时间安全扫描,在更新的OpenClaw上,它是被贬损的禁用(默认允许的安装;操作员通过 `security.installPolicy`)——两地安全. 对于赫尔墨斯, `install` 首先获取远程 `plugin.yaml`,验证 `hermes --version` 满足已声明的要求, 并只安装或更新插件 。 ClawChat技能内容被捆绑在OpenClaw和Hermes插件内部.

两个命令都接受 `--force` 重新安装插件,即使主机报告为当前.

对于赫尔墨斯,两者 `install` 财务报告和审定财务报表 `update` 接受 `--install-timeout <seconds>` 用于克尼克遥控器 `hermes plugins install` 步骤(包括 `--force` )). 国旗会覆盖 `CLAWCHAT_INSTALL_TIMEOUT_SECONDS`;两者接受从1到3600秒的整数,默认为120秒(120 000ms). 无效的值失败验证 。 进度行显示极限;在超时时命令会用SIGKILL停止,错误解释如何提升. 其他赫尔梅斯步骤保留了现有的预算,而OpenClaw忽略了这个设置.

`install` 还接受 `--activate <code>` (只有Hermes):成功安装 CLI 运行后 `hermes clawchat activate <code>` 一次,所以安装和配对是一个单一的命令。 代码为单用并永不重试;结果行以 `+ activated`。 。 。 .

对于赫尔墨斯, `--profile <name>` 特定赫尔墨斯简介:CLI通过 `-p <name>` 授权 `hermes` 调用并写入该配置文件的基础 URL `$HERMES_HOME/.env`它决心 `<HERMES_HOME-or-platform-default>/profiles/<name>`,所以通过 `--profile` **或者说** 点 `HERMES_HOME` 在剖面目录中——从不同时。 在多可视主机上,在安装或激活前确认活性配置:一个被错误瞄准的运行对一个没有出错的不同代理,连接代码是单用.

## 更新

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

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

对于OpenClaw, `update` 代表团 `openclaw plugins update @clawling/clawchat-plugin-openclaw --dangerously-force-unsafe-install`,附件 `--accept-capabilities` 当支持主机。 对于赫尔墨斯, `update` 需要安装插件和代表 `hermes plugins update clawchat`,即使安装了 `plugin.yaml` 版本已经匹配远程版本, 之后是 `hermes plugins enable clawchat` 除非主机报告其扫描功能已禁用插件(`SCAN_BLOCKED`) (中文(简体) ). `--force` 取消这一要求: `update --target hermes --force` 在没有 ClawChat 插件的主机上安装,而不是失败.

使用 `--force` 作为明确的修复/重新安装路径。 对赫尔墨斯来说,第一次尝试是 `hermes plugins install clawling/clawchat-plugin-hermes-agent --enable`,没有主机 `--force`。只有在扫描通过和主机报告之后 `already exists` cLI 是否用 `--force --enable` 以替换现有的安装。 扫描拒绝停止 `SCAN_BLOCKED`;CLI's `--force` 不可推翻它们。 对于由肮脏的本地插件文件或 Git 快速前向冲突引起的更新失败, 明确使用 `npx -y @clawling/clawchat-plugin-install-cli@latest update --target hermes --force`。 。 。 .

## 常见问题

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

ClawChat插件安装和更新的 CLI\.

### 如何安装 @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 和提交记录判断。