wx-bot CLI
CLI, который передает сообщения вашего WeChat агенту через официальный ClawBot (iLink) и отправляет ответы обратно
- 206 ★ репозитория
- Последний коммит
- MIT
Широкий доступ
Почему такой уровень
- Агент читает личные чаты WeChat и пишет в них от имени владельца аккаунта, включая голосовые сообщения, файлы и видео
- Параметр `chatlog_days` сохраняет переписку открытым текстом в файлы `<state_dir>/chatlog/`, а скрипт установки выполняется через `curl ... | bash`
Установка
- Работает в
Ручная установка
curl -fsSL https://raw.githubusercontent.com/lawrencewzen/wx-bot/main/install.sh | bashСкрипт из README. Для установки из исходников есть `./install.sh --service`, он ставит еще и автозапуск. Скрипт перед запуском стоит просмотреть.
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Агент читает личные чаты WeChat и пишет в них от имени владельца аккаунта, включая голосовые сообщения, файлы и видео
- Параметр `chatlog_days` сохраняет переписку открытым текстом в файлы `<state_dir>/chatlog/`, а скрипт установки выполняется через `curl ... | bash`
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
wx-bot подключает личный WeChat к агенту: Grok Bot, Muse или другому, который умеет принимать вебхук или забирать сообщения командой. Сообщения доходят через официальный интерфейс Tencent ClawBot (iLink), сначала попадают в локальный ящик на SQLite и только после этого подтверждаются, так что при сбое доставка повторяется. Агент получает событие в JSON с полями `event_id`, `from_wxid`, `text`, `voice_text` и списком вложений с локальными путями. Есть два режима: вебхук, когда wx-bot сам шлет POST на адрес агента, и pull, когда агент берет сообщения командой `wx-bot inbox pull`. Ответ уходит командой `wx-bot send` с текстом, картинкой, файлом или видео. Поддерживаются текст, изображения, голос с расшифровкой, файлы и видео. Порт наружу не открывается: локальный API слушает только loopback. Сервис реагирует лишь на тот аккаунт WeChat, который вошел по QR-коду, сообщения друзей не обрабатываются.
Для кого. Тем, кто ведет личного агента на Grok Bot или Muse и хочет писать ему и получать ответы в WeChat, не заходя в другое приложение.
Подходит, если
- Личный агент должен отвечать на сообщения в WeChat, а доставка не должна теряться при перезапусках
- Нужен канал для пересылки агенту голосовых сообщений, они приходят вместе с расшифровкой
- Агент работает за NAT или в облаке без входящих портов: wx-bot только исходящий, внешний порт не открывается
- Историю переписки надо разобрать позже: `chatlog_days` включает дневные файлы, а `wx-bot chatlog` ищет по ним
Не подходит, если
- Нужно отвечать друзьям и клиентам от имени бота: сервис обрабатывает только сообщения владельца аккаунта
- Нужна поддержка Windows: в README заявлены Linux и macOS
- Облачная машина агента часто засыпает или сбрасывается: wx-bot может остановиться, а вход по QR придется повторить
Пример запроса к агенту
Подключи мой WeChat к себе через wx-bot: поставь по инструкции из репозитория, покажи QR-код для входа и проверь командой wx-bot health --grace 0.Ограничения
Проект сторонний: он обращается к официальному интерфейсу Tencent ClawBot (iLink), но продуктом Tencent не считается. Сообщения можно получать и отправлять только от имени аккаунта, прошедшего вход по QR-коду, ответить можно после первого сообщения ClawBot, иначе `wx-bot send` вернет ошибку `no context_token`.
При засыпании или сбросе облачной машины агента вход слетает, и приходится снова сканировать QR. Одно событие может прийти несколько раз, поэтому агенту нужна дедупликация по `event_id`. WeChat не показывает Markdown, поэтому ответы идут простым текстом.
Как отключить. Выполните `wx-bot uninstall --yes`, флаг `--keep-data` оставит данные входа. Если ставили с автозапуском, остановите службу systemd или launchd. Автор описывает полную процедуру удаления в `docs/agents/uninstall.md`.
Частые вопросы
Как установить wx-bot?
Выполните `curl -fsSL https://raw.githubusercontent.com/lawrencewzen/wx-bot/main/install.sh | bash`, отредактируйте `~/.config/wx-bot/config.json` по примеру для вебхука или pull, затем `wx-bot login xiaox`, `wx-bot run` и `wx-bot health --grace 0`. Нулевой код последней команды означает, что установка завершена.
Чем webhook отличается от pull?
При вебхуке wx-bot сам отправляет POST на адрес агента и ждет код 2xx. При pull агент забирает сообщения командой `wx-bot inbox pull --lease 5m` и подтверждает обработку командой `wx-bot inbox ack <event_id>`.
Что делать, если сообщения не приходят?
Запустите `wx-bot health --grace 0` и выполните то, что он подскажет. Если в логах `expired` или `-14`, вход истек и нужен `wx-bot login <binding>`. Сообщения друзей не приходят по замыслу.
Хранит ли wx-bot переписку?
Входящие события лежат в локальном ящике SQLite до подтверждения. Полный лог переписки по дням включается параметром `chatlog_days`, по умолчанию он выключен, потому что это личные данные.
Это официальный продукт Tencent?
Нет. Проект обращается к официальному интерфейсу ClawBot (iLink), но, как сказано в конце README, с Tencent не связан.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыWeChat Automation API
wechat-automation-api
Скилл для агентов на Windows: отправляет текст, картинки и файлы через уже запущенный десктопный WeChat, также есть HTTP API с очередью
Канал WeCom для OpenClaw: агент отвечает в корпоративном WeChat, а личный WeChat подключается через то же приложение
MCP-канал, который передает сообщения из WeChat в сессию Claude Code и возвращает ответы агента в тот же чат
Подключает Claude Code, Cursor, Codex или OpenCode к Telegram, Slack и Discord: коллеги пишут боту, отвечает кодовый агент
Claude Code берет интервью о вашем бизнесе и сам пишет, тестирует и выкладывает бота для WhatsApp с памятью клиентов
CLI для обмена сообщениями между агентами: идентификаторы узлов, приглашения в контакты, входящие и связь через релей
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| wx-bot (эта карточка) | нет | 206 | ||
| Claude Code WeChat Channel | нет | OAuth | 311 | канал для сессии Claude Code по MCP, а не общий мост с вебхуками и pull для любых агентов |
| openclaw-wechat | нет | 152 | канал WeCom для OpenClaw, тогда как wx-bot работает с личным аккаунтом WeChat и разными агентами |
Коротко о README
README на китайском. Он описывает особенности (не терять сообщения, только исходящий трафик, только владелец аккаунта, два режима доставки), быстрый старт через сообщение агенту и ручную установку, формат событий, таблицу команд эксплуатации и частые неисправности. Агентам адресован отдельный `AGENTS.md`.