Сполучення

1. Сполучення в приватних повідомленнях (хто може спілкуватися з ботом)
2. Сполучення Node (яким пристроям/вузлам дозволено приєднуватися до мережі Gateway)

​

1) Сполучення в приватних повідомленнях (доступ до вхідного чату)

• 8 символів, верхній регістр, без неоднозначних символів (0O1I).
• Термін дії спливає через 1 годину. Бот надсилає повідомлення про сполучення лише після створення нового запиту (приблизно раз на годину для кожного відправника).
• Кількість нерозглянутих запитів на сполучення в приватних повідомленнях обмежена до 3 на обліковий запис каналу; додаткові запити ігноруються, доки термін дії одного з них не спливе або його не буде схвалено.

​

Схвалення відправника

openclaw pairing list telegram
openclaw pairing approve telegram <CODE>

​

Групи відправників для повторного використання

{
  accessGroups: {
    operators: {
      type: "message.senders",
      members: {
        discord: ["discord:123456789012345678"],
        telegram: ["987654321"],
        whatsapp: ["+15551234567"],
      },
    },
  },
  channels: {
    telegram: { dmPolicy: "allowlist", allowFrom: ["accessGroup:operators"] },
    whatsapp: { groupPolicy: "allowlist", groupAllowFrom: ["accessGroup:operators"] },
  },
}

​

Де зберігається стан

• нерозглянуті запити в channel_pairing_requests
• схвалені відправники в channel_pairing_allow_entries

• кожен запит і схвалений відправник мають ключ за каналом та обліковим записом
• середовище виконання зчитує лише канонічні рядки SQLite; воно не об’єднує застарілі файли

​

2) Сполучення пристроїв Node (вузли iOS/Android/macOS/без інтерфейсу)

​

Сполучення через Control UI (рекомендовано)

1. Відкрийте Control UI і перейдіть до Settings → Devices.
2. На сторінці Devices натисніть Pair mobile device.
3. Залиште Full access (recommended) або виберіть Limited access, щоб виключити адміністративні засоби керування Gateway.
4. Натисніть Create setup code.
5. На телефоні відкрийте застосунок OpenClaw → Settings → Gateway.
6. Відскануйте QR-код або вставте код налаштування, а потім підключіться.

​

Сполучення через Telegram

1. У Telegram надішліть своєму боту повідомлення: /pair
2. Бот відповість двома повідомленнями: повідомленням з інструкціями та окремим повідомленням із кодом налаштування (його легко скопіювати й вставити в Telegram).
3. На телефоні відкрийте застосунок OpenClaw для iOS → Settings → Gateway.
4. Відскануйте QR-код (/pair qr) або вставте код налаштування та підключіться.
5. Офіційний мобільний застосунок підключається автоматично. Якщо /pair pending показує запит, перевірте його роль і області дії перед схваленням.

• url: URL WebSocket для Gateway (ws://... або wss://...)
• urls: за наявності, упорядковані маршрути LAN/Tailnet, які може спробувати мобільний застосунок
• bootstrapToken: одноразовий початковий токен для першого рукостискання сполучення; Gateway робить його недійсним через 10 хвилин

• безпечне налаштування wss:// (або loopback на тому самому хості) типово надає node і повний нативний мобільний доступ operator
• переданий токен node залишається scopes: []
• типовий переданий токен operator містить operator.admin, operator.approvals, operator.read, operator.talk.secrets і operator.write
• Режим Limited access у Control UI та openclaw qr --limited не містять operator.admin, зберігаючи інші області дії оператора
• налаштування через незашифрований LAN ws:// автоматично використовує той самий обмежений профіль; налаштуйте wss:// або Tailscale Serve і створіть новий код для повного доступу
• подальша ротація/відкликання токена залишається обмеженою як договором схваленої ролі пристрою, так і областями дії оператора в сеансі виклику

​

Схвалення пристрою Node

openclaw devices list
openclaw devices approve <requestId>
openclaw devices reject <requestId>

​

Необов’язкове автоматичне схвалення вузлів за довіреним CIDR

{
  gateway: {
    nodes: {
      pairing: {
        autoApproveCidrs: ["192.168.1.0/24"],
      },
    },
  },
}

​

Зберігання стану сполучення Node

• нерозглянуті запити на сполучення пристроїв (короткочасні; термін їхньої дії спливає через 5 хвилин)
• спарені пристрої та токени

​

Примітки

• API node.pair.* (CLI: openclaw nodes pending|approve|reject|remove|rename) керує схваленнями можливостей вузлів, що зберігаються в тих самих записах спарених пристроїв. Вузли WS все одно потребують сполучення пристрою; див. Сполучення Node.
• Запис сполучення є довготривалим джерелом істини для схвалених ролей. Активні токени пристроїв залишаються обмеженими цим схваленим набором ролей; сторонній запис токена поза схваленими ролями не створює нового доступу.

​

Пов’язані документи

• Модель безпеки та ін’єкція промптів: Безпека
• Безпечне оновлення (запустіть doctor): Оновлення
• Конфігурації каналів:
  • Telegram: Telegram
  • WhatsApp: WhatsApp
  • Signal: Signal
  • iMessage: iMessage
  • Discord: Discord
  • Slack: Slack