@ 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 曝光运行时间和账户能力;无支持的官方计划明显失败.
安装
匹配发布后 :
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目标和服务能力. 正常命令引用从不下载缺失的运行时间 。 缺少的表单,不支持的平台,腐败的资产或错误的后端是一个错误.
支持禁用生命周期脚本的安装者 :
npm install -g --ignore-scripts @agent-wechat/cli@VERSION
wx-native-install
对于离线部署,提供释放二进制及其 wx-vVERSION-checksums.json 输入一个本地目录,然后运行:
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发射器还转发了参数,标准流,出站代码和终止信号.
配置和存储
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,然后使用第二个终端:
wx auth login --official
# Or choose a specific path on the daemon host:
wx auth login --official=/absolute/official-profile
守护进程会绑定存储的身份,尝试保存-device登录,并在认证后获取已验证的数据库密钥. 官方的应用程序在它拥有文件的同时保持关闭状态.
使用其不透明消息 ID 和精确的小数字符串召回自己的信件 来自历史或经核实的发送收据的服务器ID :
wx --account example messages recall MESSAGE_ID --server-id SERVER_ID
wx --account example operations get OPERATION_ID
使用 --detach 立即归还持久行动。 一个私人收据是
提交前写入; 同一目标使用稳定的默认偶数
键。 未确定结果的出站8 必须检查而不是自动检查
重新提交。 WeChat 决定资格 停止监视者不会取消
那个召回的 召回的信息仍为占位符;其媒体不存在
通过守护进程。 原始日记,缓存文件和备份被保留.
还提供低级注册和实验性简介副本:
# 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 用于执行命令表面。 绝不隐含地复制或附加运行中的制作简介 .
不部署而建立和验证
从寄存器根 :
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焦油球并从当地文物中安装入临时目录.
部署实例和故意释放准备序列正在进行 部署/本土。以前的集装箱CLI和 Wechaty 包件已退役;参见 移徙指南。 。 。 .
软件包帮助脚本
native-install.mjs 在 npm 安装期间运行,或通过 wx-native-install 用于离线/离线标记安装。 它选择主机架构,检查npm-bunded hash,并在原子安装前验证可执行的身份. native-launcher.mjs 只运行已安装的可执行文件.
native-check-package.mjs 是预装/预装出入口。 它检查版本/来源/目标/检查和元数据;在发布之前,它还需要既存在架构资产,又符合软件包的明细表。 本地包烟可以使用一个建筑片段;出版需要完整的矩阵. 这些帮助者属于现有的CLI包,而不是额外的npm包.
候选人平台验证和剩余配置边界在 验收清单。Windows可执行文件的名称 wx.exe; npm 启动器选择OS/CPU特定资产. 一个本地的ARM64节点安装选择本地的Windows ARM64可执行文件.