aibotk/wechat-assistant

智能微秘书-插件版 Docker镜像文档

镜像概述

本镜像基于https://github.com/wechaty/wechaty%E6%9E%84%E5%BB%BA%EF%BC%8C%E6%98%AF%E4%B8%80%E6%AC%BE%E4%B8%AA%E4%BA%BA%E5%BC%80%E6%BA%90%E6%99%BA%E8%83%BD%E5%BE%AE%E4%BF%A1%E6%9C%BA%E5%99%A8%E4%BA%BA%E8%A7%A3%E5%86%B3%E6%96%B9%E6%A1%88%E3%80%82%E9%80%9A%E8%BF%87%E5%B0%86%E9%97%B2%E7%BD%AE%E5%BE%AE%E4%BF%A1%E5%8F%B7%E8%BD%AC%E5%8C%96%E4%B8%BA%E6%99%BA%E8%83%BD%E5%BE%AE%E7%A7%98%E4%B9%A6%EF%BC%8C%E6%8F%90%E4%BE%9B%E4%B8%AA%E4%BA%BA%E6%97%A5%E5%B8%B8%E6%8F%90%E9%86%92%E3%80%81%E6%83%85%E4%BE%A3%E4%BA%92%E5%8A%A8%E3%80%81%E7%BE%A4%E7%AE%A1%E7%90%86%E7%AD%89%E5%8A%9F%E8%83%BD%EF%BC%8C%E6%94%AF%E6%8C%81%E9%9D%9Eweb%E7%89%88%E5%BE%AE%E4%BF%A1%E7%99%BB%E5%BD%95%EF%BC%88%E7%AA%81%E7%A0%B4%E4%BC%A0%E7%BB%9Fweb%E5%BE%AE%E4%BF%A1%E7%99%BB%E5%BD%95%E9%99%90%E5%88%B6%EF%BC%89%E3%80%82%E9%A1%B9%E7%9B%AE%E9%87%87%E7%94%A8Wechaty%E9%9D%A2%E6%9D%BF%E6%8F%92%E4%BB%B6%E5%AE%9E%E7%8E%B0%EF%BC%8C%E6%BA%90%E7%A0%81%E5%8F%AF%E5%8F%82%E8%80%83https://github.com/leochen-g/wechaty-web-panel%E3%80%82

核心功能与特性

个人秘书功能

• 定时任务系统：支持当日提醒（例："提醒 我 18:00 下班带物品"）、每日提醒（例："提醒 我 每天 7:00 起床"）、指定日期提醒（例："提醒 我 2024-12-25 8:00 圣诞节"）
• 多对象每日说：支持向多个联系人定时发送个性化消息（含天气、每日一句等），满足情侣互动需求
• 纪念日管理：重要日期提醒功能

***管理功能

• 群定时任务：群资讯定时发送、群规则定时提醒
• 群机器人交互：支持群内聊天互动、消息自动回复
• 群特色工具：群合影生成、多群消息同步

实用查询工具

• 生活服务：天气查询、垃圾分类（例："?香蕉皮"）、老黄历查询
• 趣味功能：土情话查询、顺口溜生成、神回复、表情包获取、美女图查询
• 知识工具：名人名言、姓氏起源（例："姓陈"）、星座运势（例："*双子座"）

系统特性

• 配置自动更新：发送指定关键词（默认"更新"）即可拉取新配置，支持自定义关键词
• 主动管理能力：主动发送消息、同步好友/群列表、更新配置
• 跨平台支持：兼容Windows、Mac、Centos系统

使用场景

• 个人日常管理：日程提醒、纪念日跟踪、习惯养成
• 情侣互动：每日天气+情话定时发送、重要日期提醒
• 社群运营：群规则提醒、行业资讯定时推送、群互动增强
• 效率工具：快速查询天气、垃圾分类、生活常识

前置准备

1. 注册智能微秘书管理账号

1. 访问智能微秘书注册页完成注册
2. 登录后进入"小助手配置->基础配置"完成初始化设置并保存
3. 在"个人中心"获取APIKEY和APISECRET（后续配置必需）

2. 注册天行数据账号

大部分资讯和接口依赖天行数据，需注册并申请接口权限：

• 必选接口：天行机器人、天气、新闻、垃圾分类
• 可选接口：土味情话、名人名言、星座运势、姓氏起源（使用天行机器人时可不单独申请） 注册地址：天行数据

Docker部署指南

推荐：直接拉取镜像

Step 1: 拉取镜像

shell
docker pull aibotk/wechat-assistant

Step 2: 配置API信息

1. 在本地创建src目录，新建index.js文件
2. 在文件中配置APIKEY和APISECRET（从智能微秘书个人中心获取）

Step 3: 启动容器

选择以下任一方式启动：

前台运行（查看实时日志）：

shell
docker run --name=wechatBot --volume="$(pwd)/src/":/bot/src aibotk/wechat-assistant

后台运行：

shell
docker run -d --name=wechatBot --volume="$(pwd)/src/":/bot/src aibotk/wechat-assistant

首次启动会下载puppet组件，可能较慢，请耐心等待。查看日志可参考Docker日志查看方法

可选：自行构建镜像（不推荐）

1. 配置src/index.js中的APIKEY和APISECRET
2. 构建镜像：

shell
docker build -t wechat-assistant .

3. 运行容器：

shell
docker run wechat-assistant

功能配置与使用

1. 容器启动后，终端会显示登录***，扫码登录微信
2. 登录智能微秘书管理面板配置所需功能
3. 向登录的微信发送"更新"关键词（或自定义更新关键词）拉取最新配置
4. 开始使用各项功能（如发送"上海天气"测试天气查询，或设置定时任务）

常见问题

• 登录问题：支持非web版微信登录，若提示登录失败请检查网络或重新扫码
• 功能不生效：确认已发送"更新"关键词同步配置，或检查天行数据接口权限
• Docker日志：使用docker logs wechatBot查看运行日志，docker logs -f wechatBot实时跟踪

免责声明

本项目基于Wechaty开源项目开发，仅供个人学习和非商业用途。使用时请遵守国家及微信使用条款，严禁用于非法活动。任何因违规使用导致的账号风险或责任，均由使用者自行承担。

更多资源

• 功能详情：智能微秘书功能介绍
• 更新日志：https://github.com/leochen-g/wechaty-web-panel/blob/master/CHANGELOG.md
• 交流群：添加微信小助手（扫描项目文档***）获取进群方式