源码构建
开发环境需准备 Rust 1.93.1 及 C 语言编译器、Node 24.22.1+ 以及 pnpm 9.15.4。官方 CI 覆盖 Linux、macOS 与 Windows 平台。
git clone https://github.com/thisnick/agent-wechat && cd agent-wechatpnpm install --frozen-lockfilepnpm native:build # 编译 Rust 工作区,包含 wx 核心二进制pnpm native:testpnpm build # 编译 TypeScript 各子包、OpenClaw 插件及当前文档站点编译生成的二进制文件位于 packages/native-client-rust/target/debug/wx。构建 Docker 镜像:
pnpm build:image # 打包镜像并打上 agent-wechat-native:local 标签正式发布构建、CI 流程与制品发布机制可参考 deploy/native/README.md。代码贡献规范请查阅 AGENTS.md。
包含的构建特性
常规构建默认包含通话 API、原生通话 Worker、Opus 编解码器以及本地麦克风/扬声器设备适配器。本地开发、CI 流水线与发布构建均采用相同的默认特性集;无需指定额外的 feature 选择标志。
cargo build --manifest-path packages/native-client-rust/Cargo.toml -p wx-native编译生成的可执行文件位于 packages/native-client-rust/target/debug/wx。从源码编译时需预先安装对应操作系统的音频开发依赖库。无界面运行的守护进程不会主动打开本地音频硬件。账号权限及微信原生连接准入依然决定了具体哪些通话功能实际可用。
体验 Web 浏览器端界面
-
启动本地模拟器及关联的浏览器 Web 客户端:
Terminal window pnpm client:dev终端将打印本地浏览器访问 URL 以及其虚拟测试数据的存储路径。
-
在浏览器中打开该地址,添加账号,随后体验 模拟扫码 (Simulate scan) 与 模拟手机确认 (Simulate phone approval)。确认授权后会话界面将自动呈现。
-
在对话窗口中打开 模拟器控制面板 (Simulator controls),可测试接收新消息、从模拟手机端发送消息,或模拟遭服务端拒绝/未决的发送场景。
-
接收一张图片以观察标准画质的自动加载。下载原图 (Download original) 会将高清原图拉取到 agent-wechat Hub 节点;就绪后,点击 保存原图 (Save original) 可将其导出存盘到你的本地设备。进入会话并在聊天历史加载完毕后将自动清空未读徽标。位于底部时新消息会保持在视野中。向上滚动会自动加载更早历史而不会丢失阅读位置,点击 最新消息 (Latest messages) 可一键触底回到最新。若分页加载失败,点击 加载更早消息 (Load older messages) 还可以手动重试。
-
通过添加附件、剪贴板粘贴或拖拽文件到输入框中。文件类型将自动识别。检查或移除暂存文件,然后点击 发送 (Send) 将文本和每个文件作为独立消息发出。在客户端开启期间,未发送的文件会按账号和会话自动暂存保留。