Python基于Wechaty构建一个简单的微信机器人

 更新时间:2025年06月06日 09:54:21   作者:阿福不是狗  
Wechaty 是一个跨平台的聊天机器人 SDK,支持多语言开发,包括 JavaScript,Python,Go,Rust等,本文就来和大家讲讲Python如何基于Wechaty构建一个简单的微信机器人吧

在当今自动化和智能化需求日益增长的时代,企业微信、公众号、小助手等自动聊天工具层出不穷。Wechaty 是一个跨平台的聊天机器人 SDK,支持多语言开发,包括 JavaScript、Python、Go、Rust 等,帮助开发者快速构建微信机器人。

本文将介绍如何基于 Python 语言使用 Wechaty,构建一个简单的微信机器人。

一、什么是 Wechaty

Wechaty 是一个专为微信生态设计的聊天机器人框架,它支持私有部署、云端服务,并提供多种 Puppet 插件接入微信协议,如:

  • wechaty-puppet-wechat4u(个人微信网页版)
  • wechaty-puppet-padplus(已停用)
  • wechaty-puppet-service(推荐,官方提供 token 服务接入)
  • wechaty-puppet-wecom(企业微信)

二、环境准备

1. 安装 Python 环境

确保本地已安装 Python3.7+,推荐使用 Python3.9 版本:

python3 --version
pip3 --version

建议创建虚拟环境:

python3 -m venv .venv
source .venv/bin/activate

2. 安装 Wechaty Python SDK

pip install wechaty

三、获取 puppet token

以 wechaty-puppet-service 为例

访问 https://wechaty.js.org/docs/puppet-services/ 并注册一个账号,获取免费的 puppet_service_token。这是连接微信服务的关键凭据。

四、编写机器人代码

from wechaty import Wechaty, Message, Contact

class MyBot(Wechaty):

    async def on_message(self, msg: Message):
        text = msg.text()
        talker = msg.talker()

        print(f'Message from {talker.name}: {text}')

        if text.lower() == 'ping':
            await msg.say('pong')

if __name__ == '__main__':
    import asyncio
    asyncio.run(MyBot().start())

上述代码会监听微信消息,如果有人发“ping”,机器人会回复“pong”。

五、配置 Puppet token 运行

你可以通过环境变量指定你的 puppet_service_token:

export WECHATY_PUPPET=wechaty-puppet-service
export WECHATY_PUPPET_SERVICE_TOKEN=your_token_here
python bot.py

或者直接在代码中指定:

bot = MyBot()
bot.options.puppet = 'wechaty-puppet-service'
bot.options.puppet_token = 'your_token_here'
asyncio.run(bot.start())

六、使用 Docker 本地运行(可选)

如果你不想本地安装所有依赖,可以用 Docker 来运行 Wechaty:

docker run -e WECHATY_PUPPET=wechaty-puppet-service \
           -e WECHATY_PUPPET_SERVICE_TOKEN=your_token \
           wechaty/wechaty

七、常见问题与排查

1.无法连接服务端

错误:WechatyPuppetGrpcError: service server is invalid

原因:puppet_token 不正确或网络不通

2.消息接收不到

请检查是否扫码登录成功,或是否被微信屏蔽

3.Docker 拉取失败

使用国内代理,如 dockerproxy.com 或配置镜像加速器

八、方法补充

python wechaty实现微信机器人,完成定时群发功能

步骤:(必须要python3.7以上版本,我用的python3.7)

1.安装wechaty

pip install wechaty

2.导入申请的token

export WECHATY_PUPPET_HOSTIE_TOKEN='your-token'

3.编写代码

最基础功能:发送ding会返回给你一张图片

import asyncio
from wechaty import Wechaty, Message

class MyBot(Wechaty):
    async def on_message(self, msg: Message):
        talker = msg.talker()
        await talker.ready()
        if msg.text() == "ding":
            await talker.say('dong')
        elif msg.text() == 'image':
            file_box = FileBox.from_url(
                'https://ss3.bdstatic.com/70cFv8Sh_Q1YnxGkpoWK1HF6hhy/it/'
                'u=1116676390,2305043183&fm=26&gp=0.jpg',
                name='ding-dong.jpg')
            await talker.say(file_box)

async def main():
    bot = MyBot()
    await bot.start()

asyncio.run(main())

完成定时群发功能

#encoding = utf-8                                                                                                                                                                                            
from wechaty import Wechaty
from wechaty.plugin import WechatyPlugin
from apscheduler.schedulers.asyncio import AsyncIOScheduler
import asyncio
import datetime
#from wechaty import get_room_id

class DailyPlugin(WechatyPlugin):
  @property
  def name(self) -> str:
    return 'dayily'

  async def tick(self):
    rooms = await self.bot.Room.find_all()
    for currRoom in rooms:
        print(f'room pay load topic: {currRoom.payload.topic}, topic: {currRoom.topic}, currRoom.room_id: {currRoom.room_id}')

        topic =  currRoom.payload.topic
        if(topic.startswith("ding") or topic.startswith("曼玲-食神券坊外卖")):
            room = currRoom
            await room.say(f'您好,我是食神券坊智能机器人,今天正式上线! -> {datetime.datetime.now()}')

  async def init_plugin(self, wechaty: Wechaty):
    await super().init_plugin(wechaty)
    scheduler = AsyncIOScheduler()
    scheduler.add_job(self.tick, 'cron', hour=9, minute=43, second=55)
    scheduler.start()

async def main():
  bot = Wechaty().use(DailyPlugin())
  await bot.start()

asyncio.run(main())

小结

通过 Wechaty Python SDK,我们可以快速构建一个可响应消息的微信机器人。借助 puppet-service 的云服务,我们无需逆向协议,即可专注于业务逻辑开发。

到此这篇关于Python基于Wechaty构建一个简单的微信机器人的文章就介绍到这了,更多相关Python Wechaty构建微信机器人内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家!

相关文章

  • 浅谈Keras中fit()和fit_generator()的区别及其参数的坑

    浅谈Keras中fit()和fit_generator()的区别及其参数的坑

    这篇文章主要介绍了Keras中fit()和fit_generator()的区别及其参数的坑,具有很好的参考价值,希望对大家有所帮助。如有错误或未考虑完全的地方,望不吝赐教
    2021-05-05
  • 浅谈OpenCV中的新函数connectedComponentsWithStats用法

    浅谈OpenCV中的新函数connectedComponentsWithStats用法

    这篇文章主要介绍了浅谈OpenCV中的新函数connectedComponentsWithStats用法,具有很好的参考价值,希望对大家有所帮助。一起跟随小编过来看看吧
    2020-07-07
  • python用户评论标签匹配的解决方法

    python用户评论标签匹配的解决方法

    这篇文章主要为大家详细介绍了python用户评论标签匹配的解决方法,具有一定的参考价值,感兴趣的小伙伴们可以参考一下
    2018-05-05
  • Python游戏开发之精灵和精灵组

    Python游戏开发之精灵和精灵组

    python作为当前非常受欢迎的编程语言,很大一部分原因是拥有丰富的库,这篇文章主要给大家介绍了关于Python游戏开发之精灵和精灵组的相关资料,文中通过图文介绍的非常详细,需要的朋友可以参考下
    2023-05-05
  • Pycharm创建文件时自动生成文件头注释(自定义设置作者日期)

    Pycharm创建文件时自动生成文件头注释(自定义设置作者日期)

    这篇文章主要介绍了Pycharm创建文件时自动生成文件头注释(自定义设置作者日期),文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
    2020-11-11
  • Linux 下 Python 实现按任意键退出的实现方法

    Linux 下 Python 实现按任意键退出的实现方法

    这篇文章主要介绍了Linux 下 Python 实现按任意键退出的实现方法的相关资料,本文介绍的非常详细,具有参考借鉴价值,需要的朋友可以参考下
    2016-09-09
  • Python向MySQL批量插数据的实例讲解

    Python向MySQL批量插数据的实例讲解

    下面小编就为大家分享一篇Python向MySQL批量插数据的实例讲解,具有很好的参考价值,希望对大家有所帮助。一起跟随小编过来看看吧
    2018-03-03
  • Python记录详细调用堆栈日志的方法

    Python记录详细调用堆栈日志的方法

    这篇文章主要介绍了Python记录详细调用堆栈日志的方法,涉及Python调用堆栈日志的相关技巧,具有一定参考借鉴价值,需要的朋友可以参考下
    2015-05-05
  • 利用Python检测URL状态

    利用Python检测URL状态

    最近小编接到这样的需求,Python检测URL状态,并追加保存200的URL。接下来通过实例代码给大家分析讲解,需要的朋友跟随小编一起看看吧
    2019-07-07
  • Python中关于列表的常规操作范例以及介绍

    Python中关于列表的常规操作范例以及介绍

    列表是一种有序的集合,可以随时添加和删除其中的元素。在python中使用的频率非常高,本篇文章对大家的学习或工作具有一定的价值,需要的朋友可以参考下
    2021-09-09

最新评论