---
read_when:
    - Налаштування або налагодження віддаленого керування з Mac
summary: Потік macOS-застосунку для керування віддаленим шлюзом OpenClaw через SSH
title: Віддалене керування
x-i18n:
    generated_at: "2026-04-05T18:10:47Z"
    model: gpt-5.4
    provider: openai
    source_hash: 96e46e603c2275d04596b5d1ae0fb6858bd1a102a727dc13924ffcd9808fdf7e
    source_path: platforms/mac/remote.md
    workflow: 15
---

# Віддалений OpenClaw (macOS ⇄ віддалений хост)

Цей сценарій дає змогу macOS-застосунку працювати як повноцінний засіб віддаленого керування для шлюзу OpenClaw, що працює на іншому хості (настільному ПК/сервері). Це функція застосунку **Remote over SSH** (віддалений запуск). Усі функції — перевірки стану, переспрямування Voice Wake і Web Chat — повторно використовують ту саму віддалену SSH-конфігурацію з _Settings → General_.

## Режими

- **Local (this Mac)**: Усе працює на ноутбуці. SSH не використовується.
- **Remote over SSH (default)**: Команди OpenClaw виконуються на віддаленому хості. Mac-застосунок відкриває SSH-з’єднання з `-o BatchMode`, вашим вибраним ідентифікатором/ключем і локальним перенаправленням порту.
- **Remote direct (ws/wss)**: Без SSH-тунелю. Mac-застосунок підключається безпосередньо до URL шлюзу (наприклад, через Tailscale Serve або публічний зворотний HTTPS-проксі).

## Віддалені транспорти

Віддалений режим підтримує два транспорти:

- **SSH tunnel** (типово): Використовує `ssh -N -L ...` для перенаправлення порту шлюзу на localhost. Шлюз бачитиме IP вузла як `127.0.0.1`, оскільки тунель працює через loopback.
- **Direct (ws/wss)**: Підключається безпосередньо до URL шлюзу. Шлюз бачить реальну IP-адресу клієнта.

## Передумови на віддаленому хості

1. Установіть Node + pnpm і зберіть/установіть CLI OpenClaw (`pnpm install && pnpm build && pnpm link --global`).
2. Переконайтеся, що `openclaw` доступний у PATH для неінтерактивних оболонок (за потреби створіть символьне посилання в `/usr/local/bin` або `/opt/homebrew/bin`).
3. Налаштуйте SSH з автентифікацією ключем. Ми рекомендуємо IP-адреси **Tailscale** для стабільної доступності поза локальною мережею.

## Налаштування macOS-застосунку

1. Відкрийте _Settings → General_.
2. У розділі **OpenClaw runs** виберіть **Remote over SSH** і задайте:
   - **Transport**: **SSH tunnel** або **Direct (ws/wss)**.
   - **SSH target**: `user@host` (необов’язково `:port`).
     - Якщо шлюз перебуває в тій самій локальній мережі й анонсує себе через Bonjour, виберіть його зі списку виявлених, щоб автоматично заповнити це поле.
   - **Gateway URL** (лише Direct): `wss://gateway.example.ts.net` (або `ws://...` для локальної мережі/LAN).
   - **Identity file** (додатково): шлях до вашого ключа.
   - **Project root** (додатково): шлях до віддаленого checkout, який використовується для команд.
   - **CLI path** (додатково): необов’язковий шлях до виконуваного entrypoint/бінарного файлу `openclaw` (автоматично заповнюється, якщо анонсовано).
3. Натисніть **Test remote**. Успіх означає, що віддалена команда `openclaw status --json` виконується коректно. Невдачі зазвичай означають проблеми з PATH/CLI; код виходу 127 означає, що CLI не знайдено на віддаленому хості.
4. Перевірки стану та Web Chat тепер автоматично працюватимуть через цей SSH-тунель.

## Web Chat

- **SSH tunnel**: Web Chat підключається до шлюзу через переспрямований керувальний порт WebSocket (типово 18789).
- **Direct (ws/wss)**: Web Chat підключається безпосередньо до налаштованого URL шлюзу.
- Окремого HTTP-сервера WebChat більше немає.

## Дозволи

- Віддалений хост потребує таких самих дозволів TCC, як і локальний: Automation, Accessibility, Screen Recording, Microphone, Speech Recognition, Notifications. Запустіть онбординг на цій машині, щоб надати їх один раз.
- Вузли анонсують свій стан дозволів через `node.list` / `node.describe`, щоб агенти знали, що доступно.

## Примітки щодо безпеки

- Віддавайте перевагу прив’язці до loopback на віддаленому хості та підключенню через SSH або Tailscale.
- SSH-тунелювання використовує сувору перевірку ключа хоста; спочатку довіртеся ключу хоста, щоб він з’явився в `~/.ssh/known_hosts`.
- Якщо ви прив’язуєте Gateway до інтерфейсу, відмінного від loopback, вимагайте дійсну автентифікацію Gateway: token, password або reverse proxy з перевіркою ідентичності з `gateway.auth.mode: "trusted-proxy"`.
- Див. [Security](/uk/gateway/security) і [Tailscale](/uk/gateway/tailscale).

## Потік входу WhatsApp (віддалено)

- Виконайте `openclaw channels login --verbose` **на віддаленому хості**. Проскануйте QR-код за допомогою WhatsApp на телефоні.
- Повторно виконайте вхід на цьому хості, якщо автентифікація закінчиться. Перевірка стану покаже проблеми зі з’єднанням.

## Усунення проблем

- **exit 127 / not found**: `openclaw` недоступний у PATH для оболонок без входу в систему. Додайте його до `/etc/paths`, конфігурації вашої оболонки або створіть символьне посилання в `/usr/local/bin`/`/opt/homebrew/bin`.
- **Health probe failed**: перевірте доступність SSH, PATH і те, що Baileys увійшов у систему (`openclaw status --json`).
- **Web Chat stuck**: переконайтеся, що шлюз запущено на віддаленому хості й що переспрямований порт відповідає WS-порту шлюзу; інтерфейсу потрібне справне WS-з’єднання.
- **Node IP shows 127.0.0.1**: це очікувано при використанні SSH-тунелю. Перемкніть **Transport** на **Direct (ws/wss)**, якщо хочете, щоб шлюз бачив реальну IP-адресу клієнта.
- **Voice Wake**: фрази активації автоматично переспрямовуються у віддаленому режимі; окремий переспрямовувач не потрібен.

## Звуки сповіщень

Вибирайте звуки для кожного сповіщення зі скриптів за допомогою `openclaw` і `node.invoke`, наприклад:

```bash
openclaw nodes notify --node <id> --title "Ping" --body "Remote gateway ready" --sound Glass
```

Глобального перемикача «звук за замовчуванням» у застосунку більше немає; ініціатор вибирає звук (або його відсутність) для кожного запиту окремо.
