weixin-agent-rs 微信接入

卡住了，没有体验成功

account added: xxxxxxxxxxxxx-im-bot
(base) at@vm-mint:/wechat-agent$ wechat-agent account ls
xxxxxxxxxxxxx-im-bot token=yes user_id=o9cq80_xxxxxxxxxxxxxx@im.wechat saved_at=1776429582
(base) at@vm-mint:/wechat-agent$ wechat-agent space create dev --agent opencode
space created: dev agent=opencode account=-
(base) at@vm-mint:/wechat-agent$ wechat-agent space bind-account dev
-bash: 未预期的记号 "newline" 附近有语法错误
(base) at@vm-mint:/wechat-agent$ wechat-agent space bind-account dev o9cq80_xxxxxxxxxxxxxx@im.wechat
-bash: 未预期的记号 "newline" 附近有语法错误
(base) at@vm-mint:~/wechat-agent$

概况

  • 仓库地址 https://github.com/tianrking/weixin-agent-rs 
  • 项目概述
    • 一条命令接入 Agent：claude / codex / openclaw / openai / anthropic
    • 终端与手机双视角可观测：扫码、入站日志、出站日志、回退回复全链路可见
    • 多账号可靠运行：支持强制 --account，避免旧 token 干扰
    • 发布即分发：各平台构建成功后立即上传 Release，不被单点失败阻塞
    • 跨平台交付：macOS、Windows、Ubuntu .deb 与 Linux 可移植 tar.gz 同步提供
  • 核心概念只有四个：
    • account：本地保存的微信登录凭据
    • space：一个轻量运行空间，包含账号、默认 agent、绑定、日志和 pid
    • agent：空间默认 agent 的查看和切换
    • bind：把某个微信用户固定路由到指定 agent

安装

  • 环境依赖
    • Rust 1.78+
    • Node.js / npx
    • 可访问 WeChat iLink API 的网络环境
  • sudo apt install ./wechat-agent_0.0.3_ubuntu24.04_amd64.deb

最短体验

  • 登录微信账号: wechat-agent account login
  • 查看本地账号: wechat-agent account ls
  • 创建空间: wechat-agent space create dev --agent codex
  • 绑定账号: wechat-agent space bind-account dev <account_id>
  • 启动空间: wechat-agent space start dev
  • 跟日志看运行状态: wechat-agent space logs dev --tail 100 -f

详细指令

account
管理本地微信登录凭据。

wechat-agent account login
wechat-agent account ls
wechat-agent account rm <account_id>
login：发起扫码登录，成功后输出 account_id
ls：列出已保存账号，显示 token、用户 ID、保存时间
rm：删除本地账号凭据
space
管理运行空间，是当前 CLI 的核心。

wechat-agent space create <name> --agent <agent> [--account <account_id>]
wechat-agent space ls
wechat-agent space ps
wechat-agent space inspect <name>
wechat-agent space start <name>
wechat-agent space stop <name>
wechat-agent space restart <name>
wechat-agent space logs <name> --tail 100 -f
wechat-agent space rm <name>
wechat-agent space bind-account <name> <account_id>
wechat-agent space unbind-account <name>
create：创建空间，默认 agent 不填时使用 codex
ls / ps：列出空间，显示运行状态、pid、默认 agent、账号、绑定数量
inspect：输出完整 JSON，包含空间目录、日志、pid、用户绑定
start / stop / restart：后台启动、停止、重启空间
logs：查看或跟随空间日志
rm：删除空间，运行中的空间必须先 stop
bind-account / unbind-account：绑定或解绑空间使用的微信账号
agent
查看可用 agent，或切换某个空间的默认 agent。

wechat-agent agent ls
wechat-agent agent switch <space> <agent>
当前支持： claude / codex / openclaw / openai / anthropic / echo

bind
做用户级 agent 路由。

wechat-agent bind ls <space>
wechat-agent bind set <space> <user_id> <agent>
wechat-agent bind rm <space> <user_id>
ls：列出某个空间的用户绑定
set：把某个用户固定到指定 agent
rm：移除某个用户的绑定
典型用法： 默认走 codex，某个用户固定走 claude

update
用于源码 checkout 下的自更新。

wechat-agent update
行为：

执行 git pull --ff-only
执行 cargo build --release --locked
输出新的 release 二进制路径
这是面向源码仓库用户的更新方式，不是二进制自替换升级器。