Claude Skill

whatsapp-pair

Привязать (или ПЕРЕпривязать) WhatsApp к этой машине — единственный шаг, который нельзя сделать за Антона, потому что… Триггеры «/whatsapp-pair», «/wa-pair», «подключи ватсап», «привяжи ватсап», «спарь ватсап», «ватсап отвалился», «ватсап не спарен», «перепривяжи whatsapp», «пока

LLM Mart · 0 points · 0 views 0 listing impressions 0 install-command copies
Download tonydzi-second-brain-starter-kit-skills_whatsapp-pair-7bc2efa.zip · 5 KB

Install

skills CLI npx skills add https://github.com/tonydzi/second-brain-starter-kit/tree/master/skills/whatsapp-pair
Claude Code claude plugin marketplace add https://llmmart.ai/marketplace.json && claude plugin install tonydzi-second-brain-starter-kit@llmmart
Git git clone https://github.com/tonydzi/second-brain-starter-kit.git

The skills CLI installs just this skill, for any of its supported agents. Claude Code installs the whole tonydzi/second-brain-starter-kit collection as a plugin from our marketplace. Git is the plain clone.

Skill manifest

OBJECTIVE: за один заход вернуть WhatsApp из RED в GREEN. Мою часть (мост, QR, страница, детект, проверка) делаю сам; от Антона нужен ровно один физический жест — поднести телефон к экрану. Финал = не «страница открылась», а зелёный вердикт независимого пробника.

Почему скилл вообще есть (замеры, не теория)

  • ⚠️ 21.09.2026, замер хаба: read-only mode — это НЕ «ватсап отвалился», и перепривязка тут не лечит. Оба MCP (mcp__whatsapp__* и mcp__whatsapp2__*) вернули «another process holds the WhatsApp connection» с PID 47960 и 44656 — то есть рельса ЗАНЯТА чужой живой сессией, мост при этом здоров. Чужие PID НЕ убиваем. Прежде чем звать Антона с телефоном, отличи одно от другого: python ~/.claude/scripts/wa_broker.py --status.
  • ⚠️ Порт owner-брокера = 8791, а не 8768. Документированный в старых сидах 127.0.0.1:8768 на хабе закрыт (Test-NetConnection → False), а owner слушает на 8791 и отвечает {"error":"Unauthorized"} на голый GET; токена в открытых конфигах (~/.claude/*.json, scripts/*.py) нет, значит HTTP-дверь без токена бесполезна и «порт закрыт» про 8768 — не доказательство смерти рельсы. Проверять надо ОБА порта и называть в отчёте именно поверхность.
  • ⚠️ LEGACY stdio инстансы = лок-война, а не один занявший. 20.09 их было 2, 21.09 — 34. Растущий список в --status означает, что процессы-сироты плодятся и отбирают лок друг у друга; это отдельный класс поломки (кандидат в reaper), а не повод перепривязывать аккаунт.
  • 01.07 → 05.08.2026 мост стоял мёртвым 35 суток: auth_info/creds.json пуст, входящие не доходили (возможны потерянные лиды). Рецепт починки каждый раз добывался заново — по кускам из трёх заметок и двух скриптов. Теперь он один и исполняемый.
  • Терминальный ASCII-QR на Windows = мозаика, телефон её не берёт (видно в server.log живьём).
  • QR живёт ~20с. Антон сканировал протухший и получал «check your connection and try again later» — это НЕ проблема сети, это старый код. Отсюда страница, которая сама берёт свежий.
  • Антон не работает в терминале: ему нужно окно, куда просто смотришь.

Движок (вся логика там, скилл — тонкая обёртка)

python "$USERPROFILE\.claude\scripts\wa_qr_live.py" · паспорт: ~/.claude/scripts/docs/wa_qr_live.md

команда что делает
--check диагноз без побочек: привязан? среда цела? сколько живых клиентов?
(без флагов) боевой заход: мост + QR + живая страница http://127.0.0.1:8799
--selftest проверка детали без телефона (гоняется в регресс-сетке)
--heal-patch вернуть вендору печать сырого QR (её сносит любой npm update)
--force погасить чужих whatsapp-клиентов и стартовать всё равно
--account wa2 работать со ВТОРЫМ аккаунтом (комбинируется с любой командой выше)

Коды выхода: 0 привязан · 1 таймаут/QR не пришёл · 2 уже привязан · 3 среда не готова · 4 крэш. Дефолтный таймаут 900с; --port если дефолтный занят.

Два аккаунта на одной машине (с 03.09.2026)

Вендор кладёт ВСЁ состояние (auth_info, store, lock) под $XDG_DATA_HOME/whatsapp-mcp, поэтому второй аккаунт = тот же вендор с другим XDG. Изоляция полная: свой линк, свой лок, AUTH_KEY_DUPLICATED МЕЖДУ аккаунтами невозможен — блокирует только второй клиент ТОГО ЖЕ аккаунта (движок различает их по argv-маркеру --wa-account=<имя>).

main wa2
auth/store ~\.local\share\whatsapp-mcp\ ~\.local\share\wa-wa2\whatsapp-mcp\
страница QR порт 8799, ~\.claude\whatsapp-mcp\ порт 8809, ~\.claude\whatsapp-mcp-wa2\
MCP-сервер whatsapp whatsapp2 (env XDG_DATA_HOME зашит в .claude.json)
пробник wa_probe.py --json XDG_DATA_HOME=$USERPROFILE/.local/share/wa-wa2 python wa_probe.py --json

Спаривать оба можно ПАРАЛЛЕЛЬНО: две страницы на двух портах, Антон сканирует каждую своим телефоном/аккаунтом. Патч QR_RAW один на двоих (общий dist вендора).

Ход работы

Шаг 0. Диагноз — до всякой стройки.

python "$USERPROFILE\.claude\scripts\wa_qr_live.py" --check
  • привязан : ДА → скан НЕ нужен. Молчание канала при живых кредах — это другая болезнь (демон/лок/вендор), иди в wa_probe.py --json и wa_broker.py --status, не гоняй Антона за телефоном.
  • среда : ...патч... → сперва --heal-patch, потом заново. Без патча QR виден только кашей.
  • живых клиентов : N>0 → второй клиент на одном линке даёт AUTH_KEY_DUPLICATED и рвёт привязку у всех. Гаси их (или --force), но сперва пойми, кто это: node с живым родителем-claude.exe — легальная сессионная копия, а не зомби.

Шаг 1. Спроси, телефон в руках? Коды сгорают по одному каждые 20с, окно 15 минут. Запускать «на всякий случай» = жечь цикл впустую. Одна строка: «телефон рядом? запускаю».

Шаг 2. Подними страницу.

python "$USERPROFILE\.claude\scripts\wa_qr_live.py"

Запускать в фоне (run_in_background), иначе блокирует сессию на весь скан. Скрипт печатает адрес страницы. Дальше — обязательно доведи картинку до глаз Антона, а не просто дай URL:

  • открой http://127.0.0.1:8799 в браузере (preview) и дай скриншот — канон §2.5 «убедись, что он видит»;
  • назови вслух путь %USERPROFILE%\.claude\whatsapp-mcp\index.html — ссылки у Антона не кликаются;
  • инструкция на самой странице уже написана (Настройки → Связанные устройства → Привязка устройства).

Шаг 3. Жди и следи. Страница сама показывает поколение кода и переключается на «готово». Со стороны сессии смотри status.json: state=QR + растущий generation = живой цикл; generation не растёт больше минуты = мост встал, смотри server.log.

Шаг 4. Проверь ЧУЖИМ прибором (обязательно). Свой же скрипт не считается доказательством — сторож не живёт в том, что сторожит:

python "$USERPROFILE\.claude\scripts\wa_probe.py" --json

status:"GREEN" = готово. RED с «МОЛЧИТ N суток» сразу после привязки — нормально: креды есть, а свежих сообщений ещё нет; перепроверь после первого входящего, не объявляй победу заранее.

Шаг 5. Прибери верстак. Фоновый процесс сам гасит мост и не оставляет клиентов. Проверь --check → живых клиентов : 0. Если привязка удалась — сними задачу 10-Tasks/task-2026-08-05-wa-qr-relink.md и пни connector-health-daily, чтобы табло позеленело.

Границы

  • Скан = руки Антона. Обойти нечем: не пароль из store и не OTP. Если он НЕ у экрана хаба — это не «жди», а другая рельса: node "$USERPROFILE\.claude\scripts\wa_pair.mjs" <телефон без +> просит у WhatsApp 8-значный код (телефон → Связанные устройства → «Связать по номеру телефона»). Код доезжает текстом в Telegram, QR — нет. Страница для этой рельсы не нужна.
  • Ничего наружу. Скилл не шлёт ни одного сообщения в WhatsApp; привязка устройства обратима (телефон → Связанные устройства → выйти) и не Tier-2.
  • Не чинит доставку. Спаренный мост ≠ работающая рассылка: тем занимается wa_broker.py (один владелец линка на машину) и связка демонов MCP.

Грабли, за которые уже платили

  1. npm update сносит патч QR_RAW_BEGIN → QR исчезает молча. --check это ловит.
  2. terminate()/kill() на Windows не валит node надёжно → накапливаются клиенты → следующий заход ловит AUTH_KEY_DUPLICATED. Движок гасит через taskkill /F /T.
  3. stdio-сервер гасит сам себя, как только закрыт stdin. Движок держит трубу открытой, поэтому отдельный keepalive.js больше не нужен.
  4. «Профиль отвечает, чаты видны» ≠ мост жив: это локальный кэш, он врал нам 26 дней. Доказательство живости = свежесть данных + наличие кредов, и только оно.

Канон: память [[whatsapp-mcp-integration]] (стек, пути, патчи), [[whatsapp-dead-since-july-and-watchdog-lied]] (почему сторож молчал), [[hub-connectors]]; CLAUDE.md §2.5 (покажи экран), §5.5 (сторож), §5.8 (тест+док+счётчик).


Like this skill? It is part of second-brain-starter-kit: the second brain we built for ourselves and run every day at Palo Alto AI Research Lab. Install the whole set with npx skills add tonydzi/second-brain-starter-kit. Everything is open source and free, so take what you need.

Flagships worth a look on their own: secondop-panel (a second opinion from a panel of external models), claude-memory-tidy (stop your agent's memory from rotting), telegram-mcp-kit (your own Telegram over MCP in about 15 minutes).

Author: Anton Dziatkovskii, Palo Alto AI Research Lab. Telegram @tonydzi - WhatsApp +1 341 222 9178 - X @Tony_Stef_

Engineers: want to test-drive this setup? Message me. I hand out free starter seeds to engineers who test and report back, and custom skill requests are welcome.

Files (second-brain-starter-kit)
  • SKILL.md 13.4 KB
    ---
    name: whatsapp-pair
    description: "Привязать (или ПЕРЕпривязать) WhatsApp к этой машине — единственный шаг, который нельзя сделать за Антона, потому что… Триггеры «/whatsapp-pair», «/wa-pair», «подключи ватсап», «привяжи ватсап», «спарь ватсап», «ватсап отвалился», «ватсап не спарен», «перепривяжи whatsapp», «покажи QR ватсапа», «второй ватсап», «два ватсапа», «ватсап 2 аккаунта», «pair whatsapp», «relink whatsapp»"
    version: 1.0.0
    ---
    
    OBJECTIVE: за один заход вернуть WhatsApp из RED в GREEN. Мою часть (мост, QR, страница,
    детект, проверка) делаю сам; от Антона нужен ровно один физический жест — поднести телефон
    к экрану. Финал = не «страница открылась», а зелёный вердикт независимого пробника.
    
    ## Почему скилл вообще есть (замеры, не теория)
    - ⚠️ **21.09.2026, замер хаба: `read-only mode` — это НЕ «ватсап отвалился», и перепривязка тут не лечит.** Оба MCP (`mcp__whatsapp__*` и `mcp__whatsapp2__*`) вернули «another process holds the WhatsApp connection» с PID 47960 и 44656 — то есть рельса ЗАНЯТА чужой живой сессией, мост при этом здоров. Чужие PID НЕ убиваем. Прежде чем звать Антона с телефоном, отличи одно от другого: `python ~/.claude/scripts/wa_broker.py --status`.
    - ⚠️ **Порт owner-брокера = 8791, а не 8768.** Документированный в старых сидах `127.0.0.1:8768` на хабе закрыт (`Test-NetConnection` → False), а owner слушает на **8791** и отвечает `{"error":"Unauthorized"}` на голый GET; токена в открытых конфигах (`~/.claude/*.json`, `scripts/*.py`) нет, значит HTTP-дверь без токена бесполезна и «порт закрыт» про 8768 — не доказательство смерти рельсы. Проверять надо ОБА порта и называть в отчёте именно поверхность.
    - ⚠️ **LEGACY stdio инстансы = лок-война, а не один занявший.** 20.09 их было 2, 21.09 — **34**. Растущий список в `--status` означает, что процессы-сироты плодятся и отбирают лок друг у друга; это отдельный класс поломки (кандидат в reaper), а не повод перепривязывать аккаунт.
    - 01.07 → 05.08.2026 мост стоял мёртвым **35 суток**: `auth_info/creds.json` пуст, входящие не
      доходили (возможны потерянные лиды). Рецепт починки каждый раз добывался заново — по кускам
      из трёх заметок и двух скриптов. Теперь он один и исполняемый.
    - Терминальный ASCII-QR на Windows = мозаика, телефон её не берёт (видно в `server.log` живьём).
    - QR живёт ~20с. Антон сканировал протухший и получал «check your connection and try again
      later» — это НЕ проблема сети, это старый код. Отсюда страница, которая сама берёт свежий.
    - Антон не работает в терминале: ему нужно окно, куда просто смотришь.
    
    ## Движок (вся логика там, скилл — тонкая обёртка)
    `python "$USERPROFILE\.claude\scripts\wa_qr_live.py"` · паспорт: `~/.claude/scripts/docs/wa_qr_live.md`
    
    | команда | что делает |
    |---|---|
    | `--check` | диагноз без побочек: привязан? среда цела? сколько живых клиентов? |
    | (без флагов) | боевой заход: мост + QR + живая страница `http://127.0.0.1:8799` |
    | `--selftest` | проверка детали без телефона (гоняется в регресс-сетке) |
    | `--heal-patch` | вернуть вендору печать сырого QR (её сносит любой `npm update`) |
    | `--force` | погасить чужих whatsapp-клиентов и стартовать всё равно |
    | `--account wa2` | работать со ВТОРЫМ аккаунтом (комбинируется с любой командой выше) |
    
    Коды выхода: `0` привязан · `1` таймаут/QR не пришёл · `2` уже привязан · `3` среда не готова
    · `4` крэш. Дефолтный таймаут 900с; `--port` если дефолтный занят.
    
    ## Два аккаунта на одной машине (с 03.09.2026)
    
    Вендор кладёт ВСЁ состояние (auth_info, store, lock) под `$XDG_DATA_HOME/whatsapp-mcp`,
    поэтому второй аккаунт = тот же вендор с другим XDG. Изоляция полная: свой линк, свой лок,
    AUTH_KEY_DUPLICATED МЕЖДУ аккаунтами невозможен — блокирует только второй клиент ТОГО ЖЕ
    аккаунта (движок различает их по argv-маркеру `--wa-account=<имя>`).
    
    | | main | wa2 |
    |---|---|---|
    | auth/store | `~\.local\share\whatsapp-mcp\` | `~\.local\share\wa-wa2\whatsapp-mcp\` |
    | страница QR | порт 8799, `~\.claude\whatsapp-mcp\` | порт 8809, `~\.claude\whatsapp-mcp-wa2\` |
    | MCP-сервер | `whatsapp` | `whatsapp2` (env XDG_DATA_HOME зашит в `.claude.json`) |
    | пробник | `wa_probe.py --json` | `XDG_DATA_HOME=$USERPROFILE/.local/share/wa-wa2 python wa_probe.py --json` |
    
    Спаривать оба можно ПАРАЛЛЕЛЬНО: две страницы на двух портах, Антон сканирует каждую
    своим телефоном/аккаунтом. Патч QR_RAW один на двоих (общий dist вендора).
    
    ## Ход работы
    
    **Шаг 0. Диагноз — до всякой стройки.**
    ```bash
    python "$USERPROFILE\.claude\scripts\wa_qr_live.py" --check
    ```
    - `привязан : ДА` → скан НЕ нужен. Молчание канала при живых кредах — это другая болезнь
      (демон/лок/вендор), иди в `wa_probe.py --json` и `wa_broker.py --status`, не гоняй Антона за телефоном.
    - `среда : ...патч...` → сперва `--heal-patch`, потом заново. Без патча QR виден только кашей.
    - `живых клиентов : N>0` → второй клиент на одном линке даёт **AUTH_KEY_DUPLICATED** и рвёт
      привязку у всех. Гаси их (или `--force`), но сперва пойми, кто это: node с живым
      родителем-`claude.exe` — легальная сессионная копия, а не зомби.
    
    **Шаг 1. Спроси, телефон в руках?** Коды сгорают по одному каждые 20с, окно 15 минут. Запускать
    «на всякий случай» = жечь цикл впустую. Одна строка: «телефон рядом? запускаю».
    
    **Шаг 2. Подними страницу.**
    ```bash
    python "$USERPROFILE\.claude\scripts\wa_qr_live.py"
    ```
    Запускать **в фоне** (`run_in_background`), иначе блокирует сессию на весь скан. Скрипт печатает
    адрес страницы. Дальше — обязательно доведи картинку до глаз Антона, а не просто дай URL:
    - открой `http://127.0.0.1:8799` в браузере (preview) и **дай скриншот** — канон §2.5 «убедись,
      что он видит»;
    - назови вслух путь `%USERPROFILE%\.claude\whatsapp-mcp\index.html` — ссылки у Антона не кликаются;
    - инструкция на самой странице уже написана (Настройки → Связанные устройства → Привязка устройства).
    
    **Шаг 3. Жди и следи.** Страница сама показывает поколение кода и переключается на «готово».
    Со стороны сессии смотри `status.json`: `state=QR` + растущий `generation` = живой цикл;
    `generation` не растёт больше минуты = мост встал, смотри `server.log`.
    
    **Шаг 4. Проверь ЧУЖИМ прибором (обязательно).** Свой же скрипт не считается доказательством —
    сторож не живёт в том, что сторожит:
    ```bash
    python "$USERPROFILE\.claude\scripts\wa_probe.py" --json
    ```
    `status:"GREEN"` = готово. `RED` с «МОЛЧИТ N суток» сразу после привязки — нормально: креды есть,
    а свежих сообщений ещё нет; перепроверь после первого входящего, не объявляй победу заранее.
    
    **Шаг 5. Прибери верстак.** Фоновый процесс сам гасит мост и не оставляет клиентов. Проверь
    `--check` → `живых клиентов : 0`. Если привязка удалась — сними задачу
    `10-Tasks/task-2026-08-05-wa-qr-relink.md` и пни `connector-health-daily`, чтобы табло позеленело.
    
    ## Границы
    - **Скан = руки Антона.** Обойти нечем: не пароль из store и не OTP. Если он НЕ у экрана хаба —
      это не «жди», а другая рельса: `node "$USERPROFILE\.claude\scripts\wa_pair.mjs" <телефон без +>`
      просит у WhatsApp 8-значный код (телефон → Связанные устройства → «Связать по номеру телефона»).
      Код доезжает текстом в Telegram, QR — нет. Страница для этой рельсы не нужна.
    - **Ничего наружу.** Скилл не шлёт ни одного сообщения в WhatsApp; привязка устройства обратима
      (телефон → Связанные устройства → выйти) и не Tier-2.
    - **Не чинит доставку.** Спаренный мост ≠ работающая рассылка: тем занимается `wa_broker.py`
      (один владелец линка на машину) и связка демонов MCP.
    
    ## Грабли, за которые уже платили
    1. `npm update` сносит патч `QR_RAW_BEGIN` → QR исчезает молча. `--check` это ловит.
    2. `terminate()`/`kill()` на Windows не валит node надёжно → накапливаются клиенты → следующий
       заход ловит AUTH_KEY_DUPLICATED. Движок гасит через `taskkill /F /T`.
    3. stdio-сервер гасит сам себя, как только закрыт stdin. Движок держит трубу открытой, поэтому
       отдельный `keepalive.js` больше не нужен.
    4. «Профиль отвечает, чаты видны» ≠ мост жив: это локальный кэш, он врал нам 26 дней.
       Доказательство живости = свежесть данных + наличие кредов, и только оно.
    
    Канон: память [[whatsapp-mcp-integration]] (стек, пути, патчи), [[whatsapp-dead-since-july-and-watchdog-lied]]
    (почему сторож молчал), [[hub-connectors]]; CLAUDE.md §2.5 (покажи экран), §5.5 (сторож), §5.8 (тест+док+счётчик).
    
    <!--kit-footer-->
    
    ---
    
    **Like this skill?** It is part of [second-brain-starter-kit](https://github.com/tonydzi/second-brain-starter-kit): the second brain we built for ourselves and run every day at Palo Alto AI Research Lab. Install the whole set with `npx skills add tonydzi/second-brain-starter-kit`. Everything is open source and free, so take what you need.
    
    Flagships worth a look on their own: [secondop-panel](https://github.com/tonydzi/secondop-panel) (a second opinion from a panel of external models), [claude-memory-tidy](https://github.com/tonydzi/claude-memory-tidy) (stop your agent's memory from rotting), [telegram-mcp-kit](https://github.com/tonydzi/telegram-mcp-kit) (your own Telegram over MCP in about 15 minutes).
    
    Author: **Anton Dziatkovskii**, Palo Alto AI Research Lab. Telegram [@tonydzi](https://t.me/tonydzi) - WhatsApp [+1 341 222 9178](https://wa.me/13412229178) - X [@Tony_Stef_](https://x.com/Tony_Stef_)
    
    **Engineers: want to test-drive this setup?** Message me. I hand out free starter seeds to engineers who test and report back, and custom skill requests are welcome.
    

Comments (0)

Sign in to join the conversation.

No comments yet.

Reviews (0)

No reviews yet.