Skip to content

wx-link在微信里接入机器人、Agent 与自动化能力

用一个 stateless core SDK,接管扫码登录、消息轮询、文本/媒体发送,以及入站媒体解析下载,把微信会话接到你自己的 webhook、Agent runtime 或 Claude 能力上。

npm i wx-linkstateless corelogin / poll / send / mediawechat bot bridge

安装

bash
npm i wx-link

如果你只想先把最小链路跑通,直接看:

这个 SDK 能做什么

Webhook Bridge

把微信消息接进你自己的服务

你可以用 wx-link 轮询微信消息,再把它们转成 webhook、事件流或任务队列,接到你已有的客服系统、工单系统或内部机器人平台。

Agent Chat

直接在微信里和 Agent 聊天

把收到的文本、上下文和媒体交给你自己的 Agent runtime,生成结果后再回发到微信,就能把微信变成一个自然的 Agent 对话入口。

Claude Workflow

把 Claude 能力接到微信会话里

你可以把 wx-link 作为微信收发层,再把消息路由到 Claude Code SDK、工具调用链或自动化工作流,在微信里触发 Claude 帮你查资料、生成代码或执行任务。

Media Pipeline

不仅是聊天,还能处理图片和文件

除了文本回复,你还可以上传图片、视频、文件,也可以解析并下载收到的微信媒体,为视觉问答、文件处理和多模态 Agent 留出入口。

一条典型链路

1. 登录扫码拿到 botTokenbaseUrl
2. 轮询poll(cursor) 持续接收微信消息
3. 路由把消息交给 webhook、Agent 或 Claude 工作流
4. 回复sendText / 媒体接口把结果发回微信

快速示例

下面这个例子展示的是最小机器人链路:登录、轮询、回复。

ts
import { loginWithQR, WxLinkClient } from "wx-link";

const login = await loginWithQR({
  onQRCode: (url) => console.log("Scan QR:", url),
});

const client = new WxLinkClient({
  baseUrl: login.baseUrl,
  token: login.botToken,
});

let cursor = "";

while (true) {
  const updates = await client.poll(cursor);
  cursor = updates.nextCursor;

  for (const msg of updates.msgs ?? []) {
    if (!msg.from_user_id) {
      continue;
    }

    await client.sendText({
      toUserId: msg.from_user_id,
      text: "hello",
      contextToken: msg.context_token,
    });
  }
}

下一步看哪里

适合谁用

  • 想把微信变成业务系统消息入口的后端开发者
  • 想在微信里接入自定义机器人、客服机器人或 AI 助手的团队
  • 想把 Agent、Claude Code SDK 或内部工具链接到微信里的自动化工程师
  • 需要处理入站图片、文件、视频,而不仅是发文本消息的多模态场景

说明

wx-link 依赖 iLink 私有 HTTP / CDN 协议,不是微信官方公开 SDK。它刻意保持 stateless:账号凭证、cursor、会话和聊天记录应由你的应用自己管理。

wx-link 文档站由 VitePress 构建