WeChat Automation API — скилл

wechat-automation-api

Скилл для агентов на Windows: отправляет текст, картинки и файлы через уже запущенный десктопный WeChat, также есть HTTP API с очередью

  • 193 ★ репозитория
  • Последний коммит
Скилл

Широкий доступ

Почему такой уровень

  • Скилл отправляет настоящие сообщения и файлы от вашего аккаунта WeChat любому контакту или группе, и отправленное не отозвать
  • Ошибка в имени контакта может отправить личные данные или файл не тому адресату
  • Массовая автоматическая отправка с личного аккаунта может нарушать правила сервиса и привести к ограничениям
Все причины и проверки

lavarong/wechat-automation-api

Установка

Работает в

В терминале, через SkillFoxx CLI

npx skillfoxx add skills/wechat-automation-api

Определит агенты на машине, покажет уровень доступа и зафиксирует версию.

Другие способы установки

Доступ и проверки

Как мы проверяем

Широкий доступИнструмент может менять данные, выполнять команды или работать с секретами.

  • Скилл отправляет настоящие сообщения и файлы от вашего аккаунта WeChat любому контакту или группе, и отправленное не отозвать
  • Ошибка в имени контакта может отправить личные данные или файл не тому адресату
  • Массовая автоматическая отправка с личного аккаунта может нарушать правила сервиса и привести к ограничениям

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

Скилл учит агента отправлять сообщения в WeChat на Windows: текст, картинку по ссылке или файл с диска. Он управляет окном уже запущенного и авторизованного клиента через UI Automation (`uiautomation`), не используя хуки и протокол WeChat. Агент вызывает `python scripts/skill_cli.py --to "Контакт" --content "Текст"`, а для картинки и файла добавляет `--action sendpic` или `--action sendfile`. Скрипт находит чат в списке или через поиск, вставляет содержимое из буфера обмена, нажимает Enter и завершается. С флагом `--json` ответ приходит в виде полей `success`, `code`, `message`, `to` и `action`. Для постоянной интеграции есть второй вход: Flask-сервис на `127.0.0.1:8808` с токеном, очередью сообщений и настраиваемым интервалом между отправками (`message_interval`). Если сервис запущен, скилл сам переключается на очередь, чтобы запросы не конфликтовали за окно WeChat. Флаг `--no-api` возвращает синхронный режим с реальным результатом. Типичные задачи: отправить в рабочий чат итог поиска или тестового прогона, переслать сформированный отчет или сообщить контакту, что работа закончена. Поддерживается WeChat версии 4.0 и выше.

Для кого. Пользователям Windows с десктопным WeChat, которые хотят получать итоги работы агентов в чате, не заходя за ними в терминал.

Подходит, если

  • Агент закончил долгий поиск или сборку, и итог нужно прислать в «Передачу файлов» или рабочую группу WeChat
  • Сформированный отчет в xlsx или PDF надо переслать контакту без ручного перетаскивания файла
  • Внешней системе нужен локальный HTTP-вход, который ставит сообщения в очередь с паузой между отправками
  • Вы проверяете автоматизацию на «Передаче файлов» перед отправкой настоящим контактам

Не подходит, если

  • WeChat работает на macOS, Linux или в браузере: скилл использует Windows UI Automation и десктопный клиент
  • Нужно получать и читать входящие сообщения: скилл только отправляет, а для приема в каталоге есть claude-code-wechat-channel
  • Нужен сервер без рабочего стола или с заблокированным экраном: при блокировке Windows UI Automation обычно недоступен

Пример запроса к агенту

Найди свежие новости про ИИ, составь краткое резюме и отправь его в WeChat контакту «文件传输助手»

Ограничения

  • Нужны Windows 10 или 11, Python 3.7 или новее, запущенный и авторизованный WeChat для ПК. На урезанных сборках Windows перед работой включают «Экранный диктор», иначе элементы окна не распознаются.
  • Имя контакта или группы в `--to` должно совпадать с названием в WeChat до символа, иначе возможны ошибка `CONTACT_NOT_FOUND` или отправка не туда.
  • Длинный текст агент делит на части, около 2000 знаков каждая; при сбое повторно скилл по правилам автора не отправляет.
  • В репозитории нет лицензии. При смене версии WeChat поиск элементов может потребовать правки в `wechat_controller.py`.

Как отключить. Удалите папку скилла из каталога скиллов агента. Если запускали HTTP API, остановите `scripts/app.py` или окно `run.bat` и удалите `config.json` с токеном.

Частые вопросы

Как установить скилл?

Попросите агента: «установи этот скилл из https://github.com/LAVARONG/wechat-automation-api и отправь тест контакту 文件传输助手». Вручную достаточно выполнить `pip install -r requirements.txt` в папке проекта, если WeChat для ПК уже запущен.

Нужно ли запускать HTTP API для обычной отправки?

Нет. Для разовых сообщений скилл сам запускает команду и завершается, а HTTP-сервис нужен для постоянной интеграции и очереди. Но если сервис уже запущен, скилл по умолчанию отправит через него.

Как отправить файл или картинку с диска?

Передайте путь к файлу в `--content` и укажите `--action sendfile`. Для картинки по ссылке используйте `--action sendpic`, а локальный путь `sendpic` вставит без скачивания. Лучше давать абсолютный путь вроде `C:\tmp\report.xlsx`.

Что делать, если после закрытия удаленного рабочего стола скилл перестал работать?

Windows блокирует UI Automation в заблокированном сеансе. Для RDP в проекте есть `disconnect_rdp.bat`: он переключает сеанс на консоль командой `tscon`, и окно WeChat остается доступным.

Что скилл возвращает после отправки?

Строку «发送成功» или «发送失败» с кодом ошибки, например `CONTACT_NOT_FOUND`. Для разбора скриптом добавьте `--json`: в ответе поля `success`, `code`, `message`, `to` и `action`.

Обсуждение

Вопросов и отзывов пока нет.

Скиллы

CLI, который передает сообщения вашего WeChat агенту через официальный ClawBot (iLink) и отправляет ответы обратно

CLIШирокий доступ206Звезды репозитория

Скилл chat-sdk от Vercel: агент пишет ботов для Slack, Teams, Discord и Telegram на одном коде и подбирает нужные адаптеры.

СкиллРасширенный доступ2,5 тыс.Звезды репозитория

Claude Code берет интервью о вашем бизнесе и сам пишет, тестирует и выкладывает бота для WhatsApp с памятью клиентов

ВоркфлоуШирокий доступ551Звезды репозитория

Канал WeCom для OpenClaw: агент отвечает в корпоративном WeChat, а личный WeChat подключается через то же приложение

ПлагинРасширенный доступ152Звезды репозитория

MCP-сервер и CLI wincli: агент управляет окнами Windows по именам кнопок и полей через UI Automation, без координат скриншота

MCP-серверШирокий доступ129Звезды репозитория

Набор кроссплатформенных скиллов: запросы только на чтение к PostgreSQL, MySQL и MSSQL, Google Workspace, Jira, Telegram, озвучка и исследования

СкиллШирокий доступ452Звезды репозитория

Коротко о README

README на китайском начинается с двух входов, скилла и HTTP API, и рекомендует скилл как основной. Дальше идут примеры фраз для агента, команды CLI для текста, картинки и файла, настройка сервиса, замечания про рабочий стол и устройство проекта.

Бейдж для README

Исходный SKILL.md

---
name: "wechat-automation"
description: "微信发信能力:通过 Windows 桌面微信发送文本、图片URL或本地文件。适合各类 Agent 在本机直接发送一次性消息。触发词:给[某人]发微信、通知[某人]、把这个用微信发给[某人]、用微信发个图片、把本地文件发给[某人]"
---

# 微信自动发信 Skill

赋予智能体掌控 Windows 桌面微信直接向真实用户或群组发送文本、图片URL或本地文件的能力。本 Skill 默认以同步命令行方式运行,执行一次命令发送一次消息,命令结束后立即退出。

只发送微信消息时,不需要专门启动后台 HTTP API,不需要运行 `run.bat`,也不需要调用 `scripts/app.py`。但**如果后台 HTTP API 恰好已在运行**,本 Skill 会**自动改走 API 队列模式**发送,以避免多个请求同时直接操作微信窗体造成冲突,详见下文「执行模式与结果判定」。

## 应用场景

- **信息推送**:当你作为智能体完成了某项长耗时的搜索、总结或生图任务后,可以将最终结果或报告链接直接通过微信发送给用户指定的联系人。
- **定时催办/打卡通知**:结合智能体的定时任务机制,向目标群组发送通知。
- **跨平台转发**:将抓取到的内容(特别如新闻图片、数据图表链接)作为微信信息直接转发。
- **任务链收尾**:先完成搜索、分析、运行命令、生成报告等任务,再把最终摘要或结果通过微信发送给指定联系人或群。
- **本地文件转发**:把 Agent 生成的报告、截图、表格、压缩包、本地图片等文件直接发给指定联系人或群。

## 典型触发语句

- “帮我给 **LAVA** 发个微信,就说**我今天晚点到**。”
- “把刚才总结的**会议纪要**发到**工作群**里。”
- “下载这个图片,用微信发给 **文件传输助手**。”
- “帮我通知一下 **张三**,让他**明天带电脑**。”
- “查询今天关于 **AI** 的最新新闻,整理成简洁总结,然后通过微信发送到联系人 **文件传输助手**。”
- “把这次运行结果总结整理,通过微信发送到 **项目通知群**。”
- “把本机上的 **C:\tmp\report.xlsx** 通过微信发送给 **文件传输助手**。”
- “把刚生成的截图发到 **项目群**。”

## 作为 Skill 调用的规范指令

本 Skill 调用后会直接返回结果并退出,不会常驻内存。请在项目根目录中使用以下语法调用:

### 发送文本消息

```powershell
python scripts/skill_cli.py --to "联系人或群组名称" --content "你要发送的具体文本"
```

### 发送图片消息

```powershell
python scripts/skill_cli.py --to "联系人或群组名称" --content "https://example.com/image.png" --action "sendpic"
```

Сообщить о проблеме

Foxx AIWeChat Automation API
Foxx AI

Я Foxx AI и уже разобрал этот инструмент. Спросите про установку, настройку или что угодно еще, отвечу простыми словами.