在微信里使唤 Claude Code，现在只要一行命令

把 AI agent 接进微信，过去要么自己啃微信的协议，要么忍受各种不稳定第三方方案。wong2 的 weixin-agent-sdk 换了个思路：它不碰协议细节，只留一个极简的 Agent 接口，微信这头的收发、解密、格式转换全部由 SDK 兜住。仓库 1.3 千星，MIT 协议，代码基于腾讯官方放出的 openclaw-weixin 改造而来，作者特别标注非官方项目、仅供学习交流。

项目简介

这个仓库的正式名字是微信 AI Agent 桥接框架，monorepo 里分三块：sdk 是微信桥接本体，weixin-acp 是 ACP 协议适配器，example-openai 是基于 OpenAI 的完整示例。它的设计哲学是「微信侧全包，agent 侧留白」，不管你的 AI 后端是 Claude Code、Codex、kimi-cli 还是自己写的服务，接入方式都收敛到一个函数。

核心功能

ACP 适配器，零代码接入现成 agent。 ACP（Agent Client Protocol）是开放的 agent 通信协议，如果你的 agent 已兼容 ACP，装都不用装：

npx weixin-acp claude-code
npx weixin-acp codex
npx weixin-acp start -- kimi acp

第三条的写法是通式：-- 后面换成任意 ACP agent 的启动命令，适配器会把它作为子进程拉起，走 JSON-RPC over stdio 通信。也就是说，Claude Code 和 Codex 两大主力都是一行命令的事。

自定义 Agent 接口，一个函数起步。 想接自己的 AI 服务，实现 chat(request) 就完了：请求里带 conversationId（维护多轮对话）、文本和已下载解密好的媒体附件（图片、语音、视频、文件），响应支持文本加媒体回传。SDK 的 README 里给了回声机器人和自管对话历史的完整示例，都是二十行以内。

消息循环与主动推送。 login() 扫码登录，start(agent) 启动消息循环并立即返回 Bot 实例，Bot 的 sendMessage() 可以在没人发消息时主动推送，定时提醒、监控告警这类场景直接适用，也能发完整的带附件消息。

快速上手

自定义 agent 的最简形态长这样：

import { login, start, type Agent } from "weixin-agent-sdk";

const echo: Agent = {
  async chat(req) {
    return { text: `你说了: ${req.text}` };
  },
};

await login();
const bot = start(echo);
await bot.wait();

回復文本支持 Markdown，发送前自动转纯文本，规避公众号和小程序那套富文本限制。媒体是双向的：用户发来的图片和语音会先下载解密再递给你的 agent，agent 回复里也可以带本地路径或 HTTPS 链接的图片、视频和文件。

和自己从零写一个微信机器人相比，这套框架省掉的是全部脏活：登录态维护、消息解密、附件落地、多轮对话的会话标识、Markdown 降级，这些平台细节被压进了 SDK，你的代码里只剩业务逻辑。

适合谁用

想在微信里给自己的 agent 做个随身入口的个人开发者，ACP 路线五分钟就能跑通；做团队机器人的，sendMessage 的主动推送能力加上多轮对话管理基本够用。两个注意事项：这是改造自官方开源代码的个人项目，微信对自动化消息的态度随时可能变化，自用试玩没问题，别把关键业务押上去；仓库最近一次推送停在五月初，遇到问题要有自己动手修的心理准备。

agent 的最后一公里从终端搬进聊天软件，这一步的体验差异比想象中大：消息就是最自然的任务队列。仓库地址：wong2/weixin-agent-sdk。