openclaw-wechat — плагин
Канал WeCom для OpenClaw: агент отвечает в корпоративном WeChat, а личный WeChat подключается через то же приложение
- 152 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Публичный адрес принимает сообщения пользователей WeCom, а Secret и ключ шифрования лежат в конфигурации OpenClaw.
- Агент отвечает от имени приложения компании и может отправлять в чат файлы и картинки.
Установка
- Работает в
Ручная установка
openclaw plugin install --path /path/to/openclaw-wechatСначала клонируйте репозиторий и выполните `npm install`, затем укажите путь к папке. Есть и ручная регистрация в `~/.openclaw/openclaw.json`.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Публичный адрес принимает сообщения пользователей WeCom, а Secret и ключ шифрования лежат в конфигурации OpenClaw.
- Агент отвечает от имени приложения компании и может отправлять в чат файлы и картинки.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
openclaw-wechat — плагин канала для OpenClaw. Через самописное приложение WeCom (корпоративный WeChat) агент принимает сообщения людей и отвечает им. Личный WeChat работает через то же приложение: в админке WeCom, в разделе «Моя компания», пункте «Плагин WeChat», аккаунт привязывают по QR-коду, и человек пишет агенту из обычного мессенджера. Плагин принимает текст, картинки, голос, видео, файлы и ссылки, а отправляет текст, картинки, видео и файлы. Голос превращается в текст через встроенное распознавание WeCom, удаленный сервер Qwen3-ASR или локальный FunASR с автоматическим переходом на запасной вариант. Агент помнит последние 20 сообщений диалога, команды `/help`, `/status` и `/clear` управляют сессией. Длинные ответы режутся по 2048 байт, а Markdown переводится в обычный текст: WeCom его не отображает. В репозитории лежит и скилл `wecom-notify`: скрипт `send_wecom.py` отправляет в WeCom текст, картинку или файл, например уведомление об окончании долгой задачи.
Для кого. Администраторам WeCom и разработчикам на OpenClaw, которым нужен чат-канал агента в корпоративном и личном WeChat.
Подходит, если
- Сотрудники компании пишут агенту OpenClaw в WeCom и получают ответы в том же чате.
- Клиент или коллега пишет из личного WeChat, а ответ готовит агент через связанное приложение WeCom.
- Голосовые сообщения в чате превращаются в текст перед тем, как агент ответит.
- После долгой задачи агент присылает в WeCom сводку, картинку графика или файл отчета через скилл `wecom-notify`.
- Один OpenClaw обслуживает несколько приложений WeCom, настройки каждого задают по схеме `WECOM_<ACCOUNT>_*`.
Не подходит, если
- Агента нужно подключить к другому мессенджеру: для Telegram и Discord у OpenClaw есть собственные каналы.
- Администратора WeCom под рукой нет, а без него не создать приложение и не привязать личный WeChat.
- У сервера нет публичного адреса для обратного вызова и постоянного исходящего IP, поэтому WeCom не примет запросы.
- Агент должен отправлять голосовые сообщения: плагин голос только принимает.
Пример запроса к агенту
Когда сборка закончится, пришли мне в WeCom картинку графика и короткую сводку.Ограничения
Последний коммит сделан в марте 2026 года. Плагин рассчитан на OpenClaw и в версии 0.3.7 совместим с OpenClaw 2026.3 и новее. Для работы нужны права администратора WeCom, публичный адрес для обратного вызова (рекомендуется Cloudflare Tunnel) и исходящий IP сервера в списке доверенных IP приложения, иначе API отвечает ошибкой 60020. AgentId, Secret, Token и EncodingAESKey относятся к одному приложению: при смешивании агент отправляет сообщения, но не получает ответы. Скилл `wecom-notify` содержит настройки автора, получателя по умолчанию и адрес его прокси, их заменяют своими.
Как отключить. Уберите плагин `wecom` из блока `plugins` в `~/.openclaw/openclaw.json`, удалите переменные `WECOM_*` и остановите туннель. Само приложение можно отключить в админке WeCom.
Частые вопросы
Можно ли писать агенту из личного WeChat?
Да. Приложение WeCom связывают с личным WeChat по QR-коду в админке, в разделе «Моя компания», пункте «Плагин WeChat». Дальше сообщения идут через то же приложение.
Как проверить, что канал работает?
Выполните `openclaw channels status --probe`: канал должен показать состояние running. Адрес `/wecom/callback` отвечает строкой `wecom webhook ok`, а входящее сообщение оставляет в логах запись `wecom inbound:`.
Почему агент отправляет сообщения, но не получает ответы?
Скорее всего, AgentId и Secret взяты из одного приложения, а Token и EncodingAESKey из другого. Все четыре значения берут из настроек одного приложения WeCom.
Что значит ошибка 60020?
WeCom не принимает запросы с IP, которого нет в списке доверенных. Добавьте исходящий адрес сервера в «Доверенные IP» этого приложения: у каждого приложения свой список.
Как подключить несколько приложений WeCom?
Дополнительные аккаунты задают переменными по схеме `WECOM_<ACCOUNT>_*`, например `WECOM_SALES_CORP_ID`, рядом с переменными аккаунта по умолчанию.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
ПлагиныMCP-канал, который передает сообщения из WeChat в сессию Claude Code и возвращает ответы агента в тот же чат
CLI, который передает сообщения вашего WeChat агенту через официальный ClawBot (iLink) и отправляет ответы обратно
Плагин MAX для OpenClaw
openclaw-max-plus
Канал-плагин, который подключает AI-ассистента OpenClaw к мессенджеру MAX через официальный Bot API: текст, медиа, кнопки, стриминг, мультиаккаунт
WeChat Automation API
wechat-automation-api
Скилл для агентов на Windows: отправляет текст, картинки и файлы через уже запущенный десктопный WeChat, также есть HTTP API с очередью
Плагин MAX для OpenClaw
openclaw-max
Канал-плагин, который подключает ИИ-ассистента OpenClaw к мессенджеру MAX: текст, вложения, кнопки, закрепление и вебхуки
Подключает Claude Code, Cursor, Codex или OpenCode к Telegram, Slack и Discord: коллеги пишут боту, отвечает кодовый агент
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| openclaw-wechat (эта карточка) | нет | 152 | ||
| WeCom CLI | да | 3 305 | официальный CLI WeCom с навыками для сообщений, документов и календаря; здесь канал, по которому агент OpenClaw отвечает собеседникам | |
| Claude Code WeChat Channel | нет | OAuth | 311 | передает сообщения WeChat в сессию Claude Code; здесь канал для агента OpenClaw через приложение WeCom |
Коротко о README
Репозиторий — форк плагина OpenClaw-Wechat версии 0.1.0 с видео, файлами, ссылками, несколькими аккаунтами и памятью диалога. Версия 0.3.7 исправляет работу с OpenClaw 2026.3 и новее. Настройка идет по шести шагам: приложение WeCom, данные компании, прием сообщений, переменные, публичный доступ и доверенные IP.