在微信中运行主流 AI 编程 CLI 工具 —— 通过微信 ClawBot 官方 iLink Bot API 实现。
支持的工具： Claude Code / Codex CLI / Gemini CLI / Kimi Code / OpenCode
一个运行在你电脑上的桥接服务。微信是遥控器，电脑是执行端。
微信 ClawBot (手机)
↕ iLink Bot API — 微信官方消息通道 (不封号)
桥接服务 (你的电脑)
↕ spawn / Agent SDK
claude -p / codex exec / gemini -p / kimi -p / opencode run
- 5 大 CLI 工具，通过
@前缀随时切换 - 最高权限默认开启
- AskUserQuestion：Claude Code 的交互式提问转发到微信（Agent SDK）
- 会话续接：连续对话自动保持上下文
/resume：浏览所有历史会话，选编号恢复（类似终端的/resume）- 跨通道漫游：
/session set <id>从终端接续同一会话 - 工具接力：
>>传递上条结果，@tool1>tool2链式调用 - 40+
/命令覆盖所有 CLI 核心 flag - 微信引用消息智能路由：回复哪条消息就由哪个工具接手
- Node.js >= 18
- 微信 已启用 ClawBot 插件（我 → 设置 → 插件）
- 至少一个 CLI 工具：
npm install -g @anthropic-ai/claude-code # Claude Code
npm install -g @openai/codex # Codex CLI
npm install -g @google/gemini-cli # Gemini CLI
npm install -g @moonshot-ai/kimi-code # Kimi Code (或 curl -fsSL https://code.kimi.com/kimi-code/install.sh | bash)
brew install opencode-ai/tap/opencode # OpenCodegit clone https://github.com/sgaofen/cli-in-wechat.git
cd cli-in-wechat
npm install
npm run dev # 开发模式
npm run dev:debug # 调试模式首次运行显示 QR 码，用微信扫码登录 ClawBot。
claude # Anthropic 订阅账号
codex # ChatGPT 账号
gemini # 设置 GEMINI_API_KEY 或 OAuth
kimi login # Kimi OAuth
# OpenCode: 设置 ANTHROPIC_API_KEY / OPENAI_API_KEY 等环境变量| 输入 | 行为 |
|---|---|
| 直接打字 | 发给上次使用的工具 |
@claude 写排序算法 |
Claude Code |
@codex fix the bug |
Codex CLI |
@gemini 解释代码 |
Gemini CLI |
@kimi 重构模块 |
Kimi Code |
@opencode 分析项目 |
OpenCode |
切换后后续消息默认发给该工具。
@claude 分析这个项目的架构
>> @codex 根据分析修复代码 ← Claude 输出作为 Codex 上下文
>> 继续优化 ← 继续用 Codex
@claude>codex 先分析再修复 ← 链式调用
/resume ← 列出所有历史会话 + 摘要
/resume 3 ← 恢复第 3 个
/session set <uuid> ← 从终端接续会话
Claude Code 需要你做选择时，问题自动转发到微信：
你发: @claude 帮我新建项目
微信收到:
Claude Code 需要你的回答:
❓ What language?
1. Python
2. TypeScript
3. Rust
你回复: 2
→ Claude 继续执行
| 命令 | 作用 | 工具 |
|---|---|---|
/status |
查看所有配置 | 通用 |
/model <名> |
切模型 | 所有 |
/mode <auto|safe|plan> |
权限模式 | 所有 |
/effort <low|med|high|xhigh|max> |
思考深度 | Claude |
/turns <数> |
最大轮次 | Claude |
/budget <$> |
API 预算 | Claude |
/dir <路径> |
工作目录 | 通用 |
/system <提示> |
系统提示 | Claude |
/tools <列表> |
允许工具 | Claude |
/notool <列表> |
禁用工具 | Claude |
/verbose |
已弃用（Kimi 新版无 --verbose） |
— |
/bare |
跳过配置加载 | Claude |
/adddir <路径> |
额外目录 | Claude/Codex |
/name <名> |
会话命名 | Claude |
/sandbox <ro|write|full> |
沙箱 | Codex |
/search |
web 搜索 | Codex |
/ephemeral |
临时模式 | Codex |
/profile <名> |
配置 | Codex |
/thinking |
已弃用（Kimi 新版无 --thinking） |
— |
/approval <模式> |
审批模式 | Gemini |
/include <目录> |
上下文目录 | Gemini |
/ext <名> |
Extensions | Gemini |
/thoughts |
显示 AI 思考内容 | 通用 |
/msgmode <verbose|normal|compact|default> |
消息详细度 | 通用 |
| 命令 | 作用 |
|---|---|
/diff |
查看 git 差异 |
/commit |
创建 git 提交 |
/review |
代码审查 |
/plan [描述] |
规划 / 切 plan 模式 |
/init |
创建项目配置文件 |
/files |
目录结构 |
/compact |
压缩上下文 |
/stats |
使用统计 |
/send <文件路径> |
发送本地文件到微信 |
| 命令 | 作用 |
|---|---|
/new |
新会话 |
/clear |
清除所有 |
/cancel |
取消任务 |
/fork |
分支会话 |
/resume |
浏览历史会话，选编号恢复 |
/resume <编号|uuid> |
恢复指定会话 |
/session |
查看当前会话 ID |
/session set <id> |
跨通道漫游 |
| 命令 | 等效 |
|---|---|
/yolo |
mode=auto + effort=max |
/fast |
effort=low |
/reset |
重置所有设置 |
/cc /cx /gm /km /oc |
快速切工具 |
| 模式 | Claude | Codex | Gemini | Kimi | OpenCode |
|---|---|---|---|---|---|
auto |
--dangerously-skip-permissions |
--yolo |
--approval-mode yolo |
-p（自带 auto） |
--auto |
safe |
默认权限 | --sandbox workspace-write |
--approval-mode default |
-p 恒 auto |
— |
plan |
--permission-mode plan |
--sandbox read-only |
--approval-mode plan |
— | — |
注：Kimi 非交互模式（
-p）永远是 auto 权限，--prompt不能与--yolo/--auto/--plan同用，故/mode对 Kimi 无效。
~/.wx-ai-bridge/config.json：
安全：
allowedUsers留空意味着任何能私聊机器人的微信好友都能以完整权限运行 CLI。 建议填入你自己的ilink_user_id（启动日志会提示）。
所有对微信接口的请求都带 超时 + 指数退避抖动重试 + 可读诊断。瞬时网络抖动
（如 read ECONNRESET、fetch failed）会被自动重试吞掉，不再像以前那样启动即崩
（issue #18）。
-
代理：Node 的全局
fetch默认不读代理环境变量。若你需要走代理访问微信， 设置HTTPS_PROXY（或HTTP_PROXY/ALL_PROXY）并安装可选依赖undici：npm i undici # 启用代理支持（可选依赖） export HTTPS_PROXY=http://127.0.0.1:7890 npm run dev
-
仍然
ECONNRESET/fetch failed：确认本机可访问ilinkai.weixin.qq.com； 尝试关闭/更换代理或 VPN；用npm run dev:debug查看带诊断的日志。 -
会话过期自动重登：token 失效（errcode -14/-13）时会自动重新出示 QR 码重登， 而不是直接退出。
src/
├── index.ts # 入口
├── config.ts # 配置
├── cli/ # 子命令
│ └── send.ts # wcli send：发送本地文件到微信
├── ilink/ # 微信 iLink Bot API
│ ├── types.ts # 协议类型
│ ├── auth.ts # QR 扫码登录
│ └── client.ts # 长轮询 + 发消息 + typing
├── adapters/ # CLI 工具适配器
│ ├── base.ts # 接口 + 共享 helpers (spawnCli: 绕 .cmd shim 直连 node/exe, argv 逐字)
│ ├── claude.ts # Agent SDK + CLI 降级
│ ├── codex.ts # codex exec + stdin 传参
│ ├── gemini.ts # gemini + stdin 传参 (-o json)
│ ├── kimi.ts # kimi -p (argv 传参, spawnCli 防 cmd.exe 损坏) + --continue 续会话
│ ├── opencode.ts # opencode run --format json
│ └── registry.ts # 自动检测已安装工具
├── bridge/ # 桥接逻辑
│ ├── session.ts # 会话持久化 (原子写)
│ ├── formatter.ts # 响应格式化
│ └── router.ts # @ 路由 + / 命令 + >> 接力 + 链式调用
│ # + /resume 历史会话浏览
│ # + AskUserQuestion 微信转发
└── utils/ # 工具库
├── http.ts # 带超时/重试/代理的 fetch (issue #18)
├── media.ts # 媒体下载 + AES 解密 + 文件名净化
├── crypto.ts # AES-ECB / 签名工具
└── logger.ts # 分级日志
微信 2026 年 3 月推出的 ClawBot 插件官方 API：
- 域名：
ilinkai.weixin.qq.com（腾讯官方） - 认证：QR 扫码 → Bearer token
- 收消息：HTTP 长轮询 (35s)
- 发消息：POST + context_token
- 官方通道，不封号
MIT
{ "defaultTool": "claude", "workDir": "/Users/you", "cliTimeout": 300000, "allowedUsers": [], // 见下方「安全」说明，留空 = 任何人可控制 "tools": { "claude": { "args": ["--max-turns", "50"] } } }