本文同步自影刀社区 RPA 板块(文章),作者 【耐家军】DC:原文链接
操作演示地址
🦞 微信龙虾 Bot 使用说明
一、概述
微信龙虾 Bot 是一款基于微信 (龙虾插件)的自动化工具,通过连接微信官方开放接口实现消息监听和自动回复功能,支持关键词触发、定时任务、脚本执行等强大功能。
二、功能特性
- 扫码登录:通过微信扫码登录龙虾插件接口
- 消息监听:实时监听微信消息
- 关键词规则:设置关键词触发自动回复或执行脚本
- 定时任务:基于 Cron 表达式的定时任务调度
- 脚本执行:支持执行 Python 脚本和其他可执行文件
- 本地消息 API:提供 HTTP 接口发送消息
三、快速开始
3.1 启动程序
启动程序,界面如下:
┌─────────────────────────────────────────────────────────────┐
│ 登录控制 │ 关键词规则/定时任务 │
│ ┌────────────────────────┐ │ │
│ │ 🔐扫码登录 ▶启动Bot │ │ 添加规则 / 添加定时任务 │
│ │ ⏹停止Bot 🚪退出登录 │ │ 规则列表 / 任务列表 │
│ └────────────────────────┘ │ │
│ ┌────────────────────────┐ │ │
│ │ 📋 运行日志 │ │ │
│ │ │ │ │
│ │ │ │ │
│ └────────────────────────┘ │ │
└─────────────────────────────────────────────────────────────┘3.2 登录流程
- 确保已安装微信龙虾插件
- 点击 🔐扫码登录 按钮
- 使用微信扫描弹出的二维码(需要已安装龙虾插件的微信账号)
- 在手机上确认登录
- 登录成功后,▶启动Bot 按钮变为可用
3.3 启动 Bot
点击 ▶启动Bot 按钮,Bot 将开始监听微信消息。
四、关键词规则配置
4.1 添加规则
点击 添加规则 按钮,弹出配置对话框:
| 字段 | 说明 |
|------|------|
| 关键词 | 触发规则的关键词列表,多个关键词用逗号分隔 |
| 匹配模式 | 支持精确匹配和模糊匹配 |
| 回复类型 | 自定义回复、执行脚本、调用API |
| 回复内容 | 当选择”自定义回复”时填写回复文本 |
| 脚本路径 | 当选择”执行脚本”时填写脚本文件路径 |
| API地址 | 当选择”调用API”时填写API URL |
4.2 规则列表
- 规则列表支持搜索功能,输入关键词快速过滤
- 点击规则可编辑,点击删除按钮可删除规则
- 规则支持启用/禁用状态切换
4.3 触发规则
当收到微信消息时,如果消息内容包含设置的关键词,将自动触发对应的动作:
- 自定义回复:自动回复预设文本
- 执行脚本:执行指定的脚本文件
- 调用API:向指定URL发送请求
五、定时任务配置
5.1 添加定时任务
点击 添加定时任务 按钮,弹出配置对话框:
| 字段 | 说明 |
|------|------|
| 任务名称 | 任务的标识名称 |
| Cron表达式 | 定时执行的时间规则 |
| 脚本路径 | 需要执行的脚本文件路径 |
| 启用此任务 | 任务开关 |
5.2 Cron 表达式说明
Cron 表达式格式分 时 日 月 周
| 示例 | 说明 |
|------|------|
| * * * * * | 每分钟执行 |
| 0 * * * * | 每小时整点执行 |
| 0 9 * * * | 每天9点执行 |
| 0 9,18 * * * | 每天9点和18点执行 |
| 0 9 * * 1-5 | 工作日9点执行 |
快捷复制:对话框中提供常用 Cron 表达式示例,点击右侧复制按钮即可快速复制。
5.3 任务列表
- 任务列表支持搜索功能
- 显示下次执行时间
- 任务执行后自动刷新下次执行时间
六、脚本执行
6.1 脚本类型支持
- Python脚本(.py):使用系统 Python 解释器执行
- 批处理脚本(.bat/.cmd):直接执行
- 可执行文件(.exe):直接执行
6.2 脚本示例
print("脚本执行成功!")
# 可以在这里编写任何 Python 代码6.3 注意事项
- 脚本路径支持绝对路径和相对路径
- 脚本执行超时时间默认为30秒
- 脚本输出会记录到日志中
七、本地消息 API
程序启动后,本地消息 API 会自动启动:
📡 本地消息 API 已启动: http://127.0.0.1:8080/send7.1 发送消息
请求方式:GET
请求地址http://127.0.0.1:8080/send
请求参数:
| 参数 | 类型 | 说明 |
|------|------|------|
| to | string | 接收人昵称或备注 |
| message | string | 消息内容 |
示例:
curl "http://127.0.0.1:8080/send?to=用户id&message=你好!"八、高级功能
8.1 退出登录
点击 🚪退出登录 按钮,可退出当前账号并删除登录配置,下次启动需要重新扫码登录。
8.2 日志查看
运行日志区域实时显示程序运行状态、消息处理记录、任务执行结果等信息。
8.3 配置文件
程序配置文件存储在用户目录:
登录配置C:\Users<用户名>\wxbot_config\wechat_bot_config.json关键词规则C:\Users<用户名>\wxbot_config\rules.json定时任务C:\Users<用户名>\wxbot_config\timed_tasks.json九、注意事项
- 微信龙虾插件:需要在微信中安装龙虾插件才能使用
- 网络要求:需要保持网络连接
- 登录有效期:登录状态可能会在一段时间后失效,需要重新登录
- 权限问题:确保程序有读取脚本文件和写入配置文件的权限
- 多开限制:程序支持防多开,同一时间只能运行一个实例
十、常见问题
Q1:登录失败怎么办?
A:请检查网络连接,确保已安装微信龙虾插件,尝试重启程序后重新扫码登录。
Q2:关键词规则不生效?
A:请检查规则是否已启用,关键词是否正确,Bot 是否已启动。
Q3:定时任务不执行?
A:请检查 Cron 表达式是否正确,脚本路径是否存在,任务是否已启用。