夜雨聆风
这本书的起点
2026 年 2 月，OpenClaw 的爆火改变了 AI 助手的格局。这个开源的多 Agent 调度平台在短短数周内获得了数十万颗 Star，各类 IM 应用——Telegram、Slack、Discord、飞书——争相接入，把自己变成 AI Agent 的前端入口。
微信，这个拥有十亿用户的最大玩家，是最晚入场的。2026 年初，微信正式开放iLink Bot API，给出了自己的答案：一套完整的长轮询消息协议、CDN 媒体加密体系、以及支持 MCP 等多种 Agent 接入方式的通信框架。这套方案的技术深度远超外界预期——但与此同时，官方文档极度匮乏，中文技术资料几乎为零。
这本书就是想把这套方案的每一个细节讲清楚，让每一位开发者都能把各类智能体接入微信，打造属于自己的个人 AI 助手。
真正动手之后
把 AI 接进微信，听起来只是一行 API 调用的距离。真正动手才发现拦路虎接踵而至：context_token 怎么回传才能正确投递回复？ sync_buf 游标断线之后如何续传？媒体文件为什么必须用 AES-128-ECB 加密才能上传 CDN？这些问题，只能靠啃英文源码和反复试错。
搞定微信这一侧，还有 Agent 协议的世界等着你：MCP 的 stdio 双向通信、ACP 的JSON-RPC 2.0 Session 管理、CLI 子进程编排、HTTP OpenAI 兼容 API——四种模式各有适用场景，却没有一本书把它们放在一起比较，告诉你在什么情况下该选哪种。
本书基于三个经过生产验证的开源项目：claude-code-wechat-channel（MCP 协议实现）、weclaw（多 Agent 桥接平台）、weixin-bot（多语言 SDK）。所有协议细节与工程模式均来自这三个项目的真实源码，不是臆造，不是过时截图。
读完之后，你能做到什么
独立搭建生产级微信 AI 助手：从 QR 码登录、多轮流式对话，到图片 CDN 加解密、Agent 切换指令，全链路打通，可直接作为生产起点。
真正读懂 iLink 协议：理解每个 API 字段背后的设计意图，知道“为什么”而不只是“能跑”。
掌握四种 Agent 接入模式的选型判断力：清楚说出 MCP、ACP、CLI、HTTP 各自的适用场景——这种判断力比会写代码更值钱。
三种语言的完整工程参考：TypeScript 零依赖 SDK、Go 七层分层架构、Python asyncio 装饰器模式。无论你的主力语言是哪个，都能找到可直接借鉴的实现。
谁适合读这本书
适合你，如果你有一定编程基础，想把 Claude、GPT 或其他 AI Agent 接入微信；你想深入理解iLink 协议和 Agent 通信协议的底层机制；你正在评估或构建基于微信的 AI 产品方案。
可能不适合如果你只对公众号或小程序感兴趣（iLink Bot 是完全不同的体系），或者期望零编程基础的入门教程，本书假设你有动手调 API 的经验。
如何使用本书
全书四部分递进：协议基础（第 1—3 章）拆解 iLink 协议的每一个细节；Agent 协议（第 4—6 章）深入四种接入模式与 OpenClaw 架构；三语言工程实现（第 7—10 章）分别用 TypeScript、Go、Python 实现完整 Bot；生产化与端到端实战（第 11—12 章）覆盖部署、运维，并以一个完整项目收尾。每章开头有知识地图，标明前置依赖；每章结尾有动手练习，引导你在自己的微信上验证所学。你只需要一个微信账号和一台能运行 Node.js 22+ / Go 1.22+ / Python 3.11+的机器。
祝你的微信 AI 助手顺利上线。
需要书的PDF，请在后台发送openclaw，就会得到下载链接，谢谢！
