zixia/wechaty

Wechaty https://img.shields.io/npm/v/wechaty?color=brightgreen](https://www.npmjs.com/package/wechaty) https://github.com/wechaty/wechaty/workflows/Docker/badge.svg](https://github.com/wechaty/wechaty/actions?query=workflow%3ADocker)

镜像概述

Wechaty是面向微信个人账号的会话AI RPA聊天机器人SDK，支持JavaScript、Python、Go、Java等多语言开发，兼容Linux、Windows、MacOS及Docker环境，仅需6行代码即可快速搭建聊天机器人。

核心功能

• 微信个人账号消息收发与处理
• 好友请求、群聊邀请等社交互动管理
• 联系人、群聊、消息对象的封装与操作API
• 多协议（Web、iPad等）切换支持
• 插件扩展机制，可自定义功能

使用场景

• 自动化客服回复与智能助手
• 群聊消息监控、统计与管理
• 个人日程提醒、信息查询工具
• 跨平台消息转发（如***与微信互通）
• 社交数据采集与分析

配置说明

环境要求

• Node.js v12及以上（非Docker部署）
• Docker环境（若使用镜像部署）

Docker部署示例

运行JavaScript机器人

shell
docker run -ti --rm --volume="$(pwd)":/bot zixia/wechaty mybot.js

运行TypeScript机器人

shell
docker run -ti --rm --volume="$(pwd)":/bot zixia/wechaty mybot.ts

协议切换

通过环境变量WECHATY_PUPPET指定协议：

shell
# Web协议（默认）
export WECHATY_PUPPET=wechaty-puppet-puppeteer
# iPad协议
export WECHATY_PUPPET=wechaty-puppet-padplus

快速入门代码

以下6行JavaScript代码即可创建基础聊天机器人：

javascript
const { Wechaty } = require('wechaty')
Wechaty.instance()
  .on('scan', (qrcode, status) => console.log(`扫码登录：${status}\nhttps://wechaty.github.io/qrcode/${encodeURIComponent(qrcode)}`))
  .on('login', user => console.log(`用户 ${user} 已登录`))
  .on('message', message => console.log(`收到消息：${message}`))
  .start()