只有用水将心上的雾气淘洗干净,荣光才会照亮最初的梦想。——《百年孤独》

https://github.com/wangrongding/wechat-bot

如果你正在寻找一种高效的方式来管理你的微信,自动回复消息,或者组织群聊,WeChat Bot 可能会是一个很好的选择。这个项目是基于 chatgptwechaty 搭建的微信机器人,能够帮助你自动化地回复微信消息,或是管理群聊和好友。它的设置非常简单,几乎可以在 2 分钟内完成,只需 4 个简单的步骤。

贡献者

感谢所有贡献者的支持和帮助,大家可以提交 PR 接入更多的 AI 服务,或者优化现有功能,使得 WeChat Bot 变得更加强大。这个项目一直在持续改进,欢迎大家参与其中。

配置 AI 服务

在开始使用 WeChat Bot 之前,需要配置 AI 服务。目前,我们提供了 9 种不同的 AI 服务供你选择,可以根据你的需求选择其中一个。

  1. ChatGPT
    如果你选择使用 ChatGPT,需要先获取一个 API 密钥,创建过程请参考这里
    配置好 API 密钥后,在 .env 文件中添加你的密钥,如下所示:

    1
    OPENAI_API_KEY='你的API密钥'
  2. 通义千问
    这是阿里云提供的 AI 服务,配置方式与 ChatGPT 类似。你可以在阿里云的控制台中获取 API 密钥,配置方法请参考以下步骤:

    1
    2
    3
    TONGYI_URL='https://dashscope.aliyuncs.com/compatible-mode/v1'
    TONGYI_API_KEY='你的API密钥'
    TONGYI_MODEL='qwen-plus'
  3. deepseek
    获取 API 密钥后,将其填入 .env 文件中的 DEEPSEEK_FREE_TOKEN,然后即可使用。

  4. 科大讯飞
    科大讯飞为你提供免费的 200 万 token,注册并获取 API 密钥后进行配置:科大讯飞

  5. Kimi
    Kimi 是一个支持文件上传和 AI 服务的平台,可以通过 kimi apikey 获取密钥并配置。

  6. Dify
    dify 注册后创建应用并获取 API 密钥,配置 .env 文件即可。

  7. Ollama
    Ollama 提供本地化的 AI 服务,配置方法如下:

    1
    2
    3
    OLLAMA_URL='http://127.0.0.1:11434/api/chat'
    OLLAMA_MODEL='qwen2.5:7b'
    OLLAMA_SYSTEM_MESSAGE='You are a personal assistant.'
  8. 302.AI
    302.AI 提供多种 AI 模型和服务,你可以通过 添加API 获取 API 密钥,并进行配置。

  9. Claude
    Claude 是 Anthropic 提供的 AI 服务,注册并获取 API 密钥后,配置 .env 文件即可:官网

开发环境配置

在开发环境中,确保已经安装了 nodejs,建议版本 >= v18.0。你可以使用以下命令来安装依赖:

1
2
3
npm install
# 或者使用 yarn
yarn install

启动服务:

1
2
3
npm run dev
# 或者使用 yarn
yarn dev

使用 Docker 部署

如果你希望使用 Docker 部署,执行以下命令:

1
2
docker build . -t wechat-bot
docker run -d --rm --name wechat-bot -v $(pwd)/.env:/app/.env wechat-bot

处理常见问题

  1. 运行报错
    首先,确保你安装了正确的依赖,并且配置好了代理。如果你在中国大陆,建议使用 taobao 镜像源进行安装:

    1
    npm config set registry https://registry.npmmirror.com
  2. 自动回复问题
    如果你遇到自动回复不起作用的情况,确保你在 .env 文件中配置了正确的白名单,添加了需要自动回复的好友和群聊。

  3. 设置代理
    如果你使用了代理,确保你的终端设置了正确的代理地址,可以参考下面的配置:

    1
    2
    export https_proxy=http://127.0.0.1:你的代理服务端口号
    export http_proxy=http://127.0.0.1:你的代理服务端口号

使用建议

  • 在群聊中,只要群成员 @ 机器人,就会触发自动回复。
  • 在私聊中,只有在联系人名单中的人发送消息时,才会触发自动回复。

总结

WeChat Bot 是一个简洁且功能强大的微信机器人,通过简单的配置,你可以快速地实现自动回复功能,帮助你高效管理微信。希望这个工具能为你的工作或生活带来更多便利。如果你遇到问题,欢迎加入我们的讨论社区,一起分享经验和解决方案。