WeChat Automation API — скилл
wechat-automation-api
Скилл для агентов на Windows: отправляет текст, картинки и файлы через уже запущенный десктопный WeChat, также есть HTTP API с очередью
- 193 ★ репозитория
- Последний коммит
Широкий доступ
Почему такой уровень
- Скилл отправляет настоящие сообщения и файлы от вашего аккаунта WeChat любому контакту или группе, и отправленное не отозвать
- Ошибка в имени контакта может отправить личные данные или файл не тому адресату
- Массовая автоматическая отправка с личного аккаунта может нарушать правила сервиса и привести к ограничениям
Установка
- Работает в
В терминале, через 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) и отправляет ответы обратно
Скилл chat-sdk от Vercel: агент пишет ботов для Slack, Teams, Discord и Telegram на одном коде и подбирает нужные адаптеры.
Claude Code берет интервью о вашем бизнесе и сам пишет, тестирует и выкладывает бота для WhatsApp с памятью клиентов
Канал WeCom для OpenClaw: агент отвечает в корпоративном WeChat, а личный WeChat подключается через то же приложение
MCP-сервер и CLI wincli: агент управляет окнами Windows по именам кнопок и полей через UI Automation, без координат скриншота
AI Agent Skills от sanjay3290
AI Agent Skills
Набор кроссплатформенных скиллов: запросы только на чтение к PostgreSQL, MySQL и MSSQL, Google Workspace, Jira, Telegram, озвучка и исследования
Коротко о 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" ```