Weixin Agent SDK

正常
GitHub TypeScript MIT

简介

Weixin Agent SDK 是一个微信机器人接入任意 Agent 的 SDK，支持将 AI Agent 快速接入微信公众号或微信机器人，实现智能对话和自动化服务。

核心特性

  • 通过简单 Agent 接口将任意 AI 后端接入微信，支持文本、图片、语音、视频、文件等多媒体消息
  • 内置 ACP（Agent Client Protocol）适配器，一行命令即可接入 Claude Code、Codex、kimi-cli 等 Agent
  • 支持主动消息推送，Bot 实例可定时或按需向用户发送文本、图片、视频和文件
  • 基于长轮询接收消息，无需公网服务器，支持断点续传和会话过期自动重连
  • 提供 OpenAI 完整示例，支持多轮对话和图片输入，环境变量灵活配置模型和 API
  • 内置 /echo 和 /toggle-debug 斜杠命令，方便调试和性能监控

适用场景

💡 将企业内部 AI 客服系统接入微信，实现智能对话和自动化服务
💡 通过微信机器人对接 OpenAI/Claude 等大模型，打造个人 AI 助手
💡 使用 ACP 协议将 Codex 或 Claude Code 接入微信，实现远程 AI 编程协作
💡 定时推送报表、提醒和通知等自动化消息给微信用户
💡 构建基于微信的多媒体交互 Agent，支持图片识别和语音转文字

标签

wechat messaging chatbot agent-sdk chinese

分类

💬 聊天界面 ⚡ Agent 工具

快速开始

安装：npm install weixin-agent-sdk。扫码登录：pnpm run login。实现 Agent 接口的 chat 方法，调用 login() 扫码登录后，用 start(agent) 启动消息循环。支持通过 ACP 一行命令接入 Claude Code（npx weixin-acp claude-code）或 Codex（npx weixin-acp codex）。
访问 GitHub

相关项目