# @agent-wechat/cli 中文文档

规范地址：https://npmcn.com/package/%40agent-wechat/cli/

版本：1\.5\.1
npm 元数据更新时间：2026-11-05T02:53:52.301Z
中文译文更新时间：2026-11-06T02:33:03.091Z
软件包许可：MIT

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

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

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

- 包体积（解压后）：45 kB，9 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- Node.js 要求：\>=24\.16
- 运行依赖：0 个
- 首次发布：2026-02-20T23:55:28.959Z
- 最新版本发布：2026-11-05T02:53:51.606Z
- 近 30 天下载量：6267（2026-10-05 至 2026-11-03，npm 官方下载统计）
- 已发布版本数：102（近 12 个月 102 个）

## 中文简介

独立的本地 WeChat CLI 和守护进程启动器

## 安装

```sh
npm install @agent-wechat/cli
```

也可以使用：`pnpm add @agent-wechat/cli`、`yarn add @agent-wechat/cli`、`bun add @agent-wechat/cli`

## README

# @ agent-wechat/cli (英语)

`wx` 是本地 Rust 客户端和前景守护进程 。 npm 包安装匹配的放出可执行文件;它不会在 JavaScript 中执行本地协议. Linux x64/ARM64 有 glibc 2.36+ 认证. 发布矩阵还构建了macOS ARM64和原生Windows x64/ARM64等候选人;原生机账户验收待验. 穆斯尔仍然无人支持. 官方应用配置图的收购仅限Linux. 其他系统的客户端可以使用一个被支持的Linux守护进程中的HTTP API. `wx --json version` 财务报告和审定财务报表 `/v1/status` 曝光运行时间和账户能力;无支持的官方计划明显失败.

## 安装

匹配发布后 :

```bash
npm install -g @agent-wechat/cli@VERSION
wx --json version
```

Linux 可执行文件只需glibc即可启动. 交互调用本地 PulseAudio或PipeWire-Pulse服务并装入客户端库, `libpulse0`, (中文(简体) ), 当它打开麦克风和扬声器时;其他命令也不需要. 已发布的可执行文件包括麦克风/扬声器支持. 使用 `wx calls devices` 在不开始抓取或播放的情况下列出终点,以及 `wx calls dial --help` 用于设备选择。 调用参与需要守护进程 宣传相应的呼叫能力.

在原生的β系列中,使用已出版的精确版本,例如: `1.0.0-beta.0`,或 `@agent-wechat/cli@beta`. 马厩 `latest` 频道保留旧集装箱CLI直至升级. 在假设一个β发布之前参见β发布指令.

明确 npm 安装可以下载一个精确的版本资产, 超过已核实的 HTTPS 。 它的大小和SHA-256必须匹配 `native-release.json` 在npm包内,然后一个有边框的本地身份检查必须在原子安装前报告同一版本,本地后端,Rust目标和服务能力. 正常命令引用从不下载缺失的运行时间 。 缺少的表单,不支持的平台,腐败的资产或错误的后端是一个错误.

支持禁用生命周期脚本的安装者 :

```bash
npm install -g --ignore-scripts @agent-wechat/cli@VERSION
wx-native-install
```

对于离线部署,提供释放二进制及其 `wx-vVERSION-checksums.json` 输入一个本地目录,然后运行:

```bash
AGENT_WECHAT_NATIVE_ARTIFACT_DIR=/absolute/release-assets wx-native-install
```

离线清单必须与npm捆绑清单一致。 或者,提供可信任的可执行文件并设定 `AGENT_WECHAT_NATIVE_BINARY=/absolute/path/to/wx`; 发射器验证其本土身份/版本而不是下载. 这种明确的覆盖可以信任操作员提供的字节,并不断言它们与释放资产相同. `AGENT_WECHAT_SKIP_NATIVE_INSTALL=1` 在图像/包件提供时推迟安装;在提供运行时间之前,命令不可用。 不要禁用 TLS 校验 .

OpenClaw 插件使用已经安装的全局本地化 `wx` 或配置的绝对可执行文件。 它从不下载二进制,也不依靠它的插件安装器运行npm生命周期脚本. 对于被管理的流程,更喜欢实际释放可执行路径来避免额外的发射程序;npm发射器还转发了参数,标准流,出站代码和终止信号.

## 配置和存储

```bash
wx config show
wx serve --server-config /absolute/server/config.toml
```

默认服务器配置为 `$XDG_CONFIG_HOME/agent-wechat/server/config.toml`,或 `~/.config/agent-wechat/server/config.toml`。持久的根默认值为 `$XDG_DATA_HOME/agent-wechat`,或 `~/.local/share/agent-wechat`。 。 。 . `wx serve --data-dir PATH` 财务报告和审定财务报表 `AGENT_WECHAT_DATA_DIR` 超过它。 服务器配置可以选择 `listen`, (中文(简体) ), `dataDir` 财务报告和审定财务报表 `tokenFile`;相对于配置文件的相对引用解析。 路径不是证书 .

最初的工作流程接管了现有的官方简介。 关闭正式应用程序, 启动 `wx serve`,然后使用第二个终端:

```bash
wx auth login --official
# Or choose a specific path on the daemon host:
wx auth login --official=/absolute/official-profile
```

守护进程会绑定存储的身份,尝试保存-device登录,并在认证后获取已验证的数据库密钥. 官方的应用程序在它拥有文件的同时保持关闭状态.

使用其不透明消息 ID 和精确的小数字符串召回自己的信件 来自历史或经核实的发送收据的服务器ID :

```bash
wx --account example messages recall MESSAGE_ID --server-id SERVER_ID
wx --account example operations get OPERATION_ID
```

使用 `--detach` 立即归还持久行动。 一个私人收据是 提交前写入; 同一目标使用稳定的默认偶数 键。 未确定结果的出站8 必须检查而不是自动检查 重新提交。 WeChat 决定资格 停止监视者不会取消 那个召回的 召回的信息仍为占位符;其媒体不存在 通过守护进程。 原始日记,缓存文件和备份被保留.

还提供低级注册和实验性简介副本:

```bash
# Only use an explicitly stopped/quiescent profile; never share a writer.
wx store attach --account example --path /absolute/official-profile --source-stopped
wx store import --account copied --source /absolute/stopped-profile --source-stopped
wx store export --account copied --destination /absolute/new-export --source-stopped
```

直接模式将官方配置字节保存在所选路径和只守护进程状态下 `dataDir`. 新的创建、导出和返回到官方应用程序的文件不在初始支持的接管范围之内。 导入/导出复制相同的格式; 它们不转换图案或刷新登录信任 。 使用 `--help` 用于执行命令表面。 绝不隐含地复制或附加运行中的制作简介 .

## 不部署而建立和验证

从寄存器根 :

```bash
pnpm --filter @agent-wechat/cli... build
pnpm --filter @agent-wechat/cli test
pnpm native:build
pnpm native:test
pnpm native:release:build
node scripts/native-package-smoke.mjs artifacts/native
# Substitute the exact artifact version emitted by the build:
python3 scripts/native-cli-smoke.py artifacts/native/wx-vVERSION-linux-x64-gnu
python3 scripts/native-cli-fixture-test.py artifacts/native/wx-vVERSION-linux-x64-gnu
python3 scripts/native-export-smoke.py artifacts/native/wx-vVERSION-linux-x64-gnu
```

Source-workspace postinstall 推迟放行安装;从目标目录中运行 Rust 二进制或者使用一个明确可信任的可执行文件覆盖. 本地发行构建器测试 Rust 工作空间, 验证可执行身份并创建版本资产; 它不发布, 部署或登录账户 。 包裹烟雾测试包/解包出一实际npm焦油球并从当地文物中安装入临时目录.

部署实例和故意释放准备序列正在进行 [部署/本土](https://npmcn.com/package/deploy/native/README.md)。以前的集装箱CLI和 Wechaty 包件已退役;参见 [移徙指南](https://thisnick.github.io/agent-wechat/setup/migrate/)。 。 。 .

## 软件包帮助脚本

`native-install.mjs` 在 npm 安装期间运行,或通过 `wx-native-install` 用于离线/离线标记安装。 它选择主机架构,检查npm-bunded hash,并在原子安装前验证可执行的身份. `native-launcher.mjs` 只运行已安装的可执行文件.

`native-check-package.mjs` 是预装/预装出入口。 它检查版本/来源/目标/检查和元数据;在发布之前,它还需要既存在架构资产,又符合软件包的明细表。 本地包烟可以使用一个建筑片段;出版需要完整的矩阵. 这些帮助者属于现有的CLI包,而不是额外的npm包.

候选人平台验证和剩余配置边界在 [验收清单](https://npmcn.com/package/PLATFORM-ACCEPTANCE.md)。Windows可执行文件的名称 `wx.exe`; npm 启动器选择OS/CPU特定资产. 一个本地的ARM64节点安装选择本地的Windows ARM64可执行文件.

## 常见问题

### @agent-wechat/cli 是什么？

独立的本地 WeChat CLI 和守护进程启动器

### 如何安装 @agent-wechat/cli？

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

### @agent-wechat/cli 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/agent-wechat\_\_cli 是否存在。

### @agent-wechat/cli 支持 ESM 还是 CommonJS？

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

### @agent-wechat/cli 需要什么版本的 Node\.js？

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

### @agent-wechat/cli 可以商用吗？

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

### @agent-wechat/cli 的下载量有多少？

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

### @agent-wechat/cli 还在维护吗？

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