---
read_when:
    - Встановлення програми для macOS
    - Вибір між локальним і віддаленим режимами Gateway у macOS
    - Пошук завантажень випусків застосунку для macOS
summary: Установлення та використання застосунку OpenClaw у смузі меню macOS
title: застосунок для macOS
x-i18n:
    generated_at: "2026-07-16T18:14:54Z"
    model: gpt-5.6
    postprocess_version: locale-links-v1
    prompt_version: 32
    provider: openai
    source_hash: c6aaf107eb564dd8a444069fee31bb190efe41da9f26b3c52f42fdbbcaf8690c
    source_path: platforms/macos.md
    workflow: 16
---

Застосунок macOS — це **компаньйон OpenClaw у смузі меню**: нативний інтерфейс у системному лотку, запити дозволів macOS, сповіщення, WebChat, голосове введення, Canvas і
розміщені на Mac інструменти Node, як-от `system.run`.

Потрібні лише CLI та Gateway? Почніть із розділу [Початок роботи](/uk/start/getting-started).

## Завантаження

Збірки застосунку macOS доступні у [випусках OpenClaw на GitHub](https://github.com/openclaw/openclaw/releases).
Якщо випуск містить ресурси застосунку macOS, шукайте:

- `OpenClaw-<version>.dmg` (рекомендовано)
- `OpenClaw-<version>.zip`

Деякі випуски містять лише CLI, докази або ресурси Windows. Якщо найновіший випуск
не містить ресурсу застосунку macOS, скористайтеся найновішим випуском, у якому він є, або зберіть застосунок із вихідного коду за допомогою
[налаштування середовища розробки macOS](/uk/platforms/mac/dev-setup).

## Перший запуск

1. Установіть і запустіть **OpenClaw.app**.
2. Виберіть **This Mac** для локального Gateway або підключіться до віддаленого Gateway.
3. Зачекайте, доки застосунок установить відповідне середовище виконання CLI. У локальному режимі він також
   установлює та запускає Gateway.
4. Установіть підключення до моделі за допомогою перевірки активної моделі. Після успішної перевірки OpenClaw
   виконає решту налаштування.
5. Виконайте контрольний список дозволів macOS і надішліть тестове повідомлення початкового налаштування.

Якщо застосунок підключається до наявного Gateway, для типового агента якого налаштовано
модель, він вважає цей Gateway уже налаштованим, пропускає початкове налаштування постачальника й
OpenClaw та відкриває панель керування. Якщо підключитися до Gateway не вдається або для його
типового агента не налаштовано модель, початкове налаштування моделі залишається доступним для
відновлення.

Для налаштування через CLI/Gateway скористайтеся розділом [Початок роботи](/uk/start/getting-started).
Для відновлення дозволів скористайтеся розділом [Дозволи macOS](/uk/platforms/mac/permissions).

## Оновлення

На картці оновлення панелі керування зазначено, що саме оновить застосунок:

- **Оновити застосунок Mac і Gateway** означає, що підписаний застосунок керує локальним Gateway через launchd.
  Sparkle спочатку оновлює застосунок; після повторного запуску застосунок автоматично
  оновлює й перезапускає свій Gateway до відповідної версії, а потім перевіряє
  підключення.
- **Оновити Gateway** означає, що застосунок підключено до віддаленого Gateway, локального Gateway
  з ручним керуванням або іншої інсталяції, якою застосунок не керує. Кнопка
  запускає звичайний процес оновлення цього Gateway замість оновлення застосунку Mac.

Після невдалого скоординованого оновлення вікно початкового налаштування залишається відкритим і містить дії для повторної спроби,
[посібник з оновлення](/uk/install/updating) та Discord. Автоматичне відновлення ніколи
не повертає Gateway до старішої версії та не перевизначає закріплення каналу `extended-stable`.

Після успішного оновлення застосунок знаходить найновіший сеанс верхнього рівня
з безпосередньою взаємодією користувача й надсилає відповідному агенту одноразову подію оновлення. Активність Heartbeat
і Cron не впливає на цей вибір. Після цього агент може привітати користувача з поверненням
у розмові, яку він, найімовірніше, використовував. У віддаленому режимі застосунок
оновлює лише локальне середовище виконання Node на Mac і не надсилає сповіщення, якщо
віддалений Gateway старіший за застосунок.

Sparkle використовує налаштування `update.channel` Gateway. `beta` і `dev` вмикають
бета-збірки застосунку; `stable`, `extended-stable`, а також відсутні чи невідомі значення
залишають застосунок на стабільних збірках.

## Відкриття посилань у панелі керування

Якщо у вбудованій панелі керування застосунку macOS натиснути зовнішнє вебпосилання, воно відкриється в бічній панелі браузера зі змінним розміром, що займає половину ширини вікна, а навігація панелі керування залишиться видимою. Перетягніть роздільник, щоб вибрати іншу ширину; застосунок запам’ятає її. Кожне посилання відкривається в окремій вкладці, смуга вкладок з’являється, коли відкрито кілька сторінок, а повторне натискання того самого посилання використовує наявну вкладку. Перетягуйте вкладки, щоб змінити їх порядок, закривайте їх кнопкою закриття вкладки або натисканням середньої кнопки миші, а клацання правою кнопкою миші на вкладці відкриває команди **Open in Default Browser**, **Copy Link**, **Reload**, **Close Tab** і **Close Other Tabs**. Кнопки «назад» і «вперед» у смузі заголовка вікна та жести гортання на трекпаді переміщують історією панелі керування; власні кнопки «назад» і «вперед» бічної панелі переміщують історією активної вкладки. Бічна панель також містить елементи керування для перезавантаження, відкриття в типовому браузері та закриття.

Елементи керування у смузі заголовка відповідають стану бічної панелі застосунку: коли її розгорнуто, кнопки «назад» і «вперед» розташовані біля її правого краю поруч із перемикачем бічної панелі; коли її згорнуто, замість них відображаються кнопка пошуку (відкриває палітру команд) і кнопка нового сеансу.

Клацніть зовнішнє посилання правою кнопкою миші, щоб вибрати **Open in Sidebar**, **Open in Default Browser** або **Copy Link**. Клацання з клавішами-модифікаторами та активовані користувачем посилання для відкриття нового вікна з панелі керування й надалі відкриватимуться в типовому браузері; посилання для нового вікна всередині бічної панелі відкриваються як нові вкладки бічної панелі. Звичайні сторінки Control UI, відкриті в браузері, зберігають стандартну поведінку браузера для посилань і контекстного меню.

## Імпортування даних входу з браузера

Коли бічна панель браузера відкривається вперше, а застосунок працює з локальним Gateway, панель керування показує банер, який можна закрити, якщо на Mac існує профіль браузера сімейства Chrome з файлами cookie. Банер пропонує скопіювати ці файли cookie в ізольований керований профіль, який агенти використовують для перегляду вебсторінок. Виберіть профіль за допомогою елемента керування **Import** (може знадобитися Touch ID); перебіг і кількість імпортованих файлів cookie відображаються безпосередньо, а копіюються лише файли cookie — паролі ніколи не залишають вихідний браузер. Закриття банера зберігає цей вибір; **Settings → General → Browser login → Import…** дає змогу повторити імпортування будь-коли. Докладніше про базовий процес імпортування та обмеження `browser.allowSystemProfileImport` див. у розділі [Браузер](/uk/cli/browser).

## Вибір режиму Gateway

| Режим     | Коли використовувати                                                           | Сторінка з подробицями                              |
| --------- | ------------------------------------------------------------------------------ | -------------------------------------------------- |
| Локальний | Цей Mac має запускати Gateway і підтримувати його роботу за допомогою launchd. | [Gateway у macOS](/uk/platforms/mac/bundled-gateway)  |
| Віддалений | Gateway працює на іншому хості; цей Mac керує ним через SSH, LAN або Tailnet. | [Віддалене керування](/uk/platforms/mac/remote)        |

Для обох режимів потрібен установлений CLI `openclaw`, оскільки застосунок повторно використовує його
середовище виконання хоста Node. На новому Mac застосунок автоматично встановлює відповідний CLI; у локальному
режимі він потім запускає майстер Gateway, а у віддаленому режимі підключається до вибраного
Gateway, не запускаючи другий локальний Gateway.
Відомості про відновлення вручну див. у розділі [Gateway у macOS](/uk/platforms/mac/bundled-gateway).

## За що відповідає застосунок

- Стан у смузі меню, сповіщення, справність і WebChat.
- Запити дозволів macOS для екрана, мікрофона, мовлення, автоматизації та доступності.
- Один Node Mac, що поєднує нативний Canvas, захоплення зображення з камери/екрана, сповіщення,
  геолокацію та керування комп’ютером із системними, браузерними,
  Plugin, Skills і MCP-командами хоста Node CLI.
- Запити підтвердження виконання команд, розміщених на Mac.
- Виконання схвалених команд оболонки в контексті застосунку зі збереженням прив’язки дозволів macOS
  до застосунку, тоді як середовище виконання CLI керує спільною політикою Node.
- SSH-тунелі у віддаленому режимі або прямі підключення до Gateway.

Застосунок **не** замінює документацію Gateway або загальну документацію CLI. Конфігурація Gateway,
постачальники, плагіни, канали, інструменти та безпека описані у відповідних
розділах документації.

## Сторінки з подробицями про macOS

| Завдання                                       | Документація                                                                                |
| ---------------------------------------------- | ------------------------------------------------------------------------------------------- |
| Установлення або налагодження служби CLI/Gateway | [Gateway у macOS](/uk/platforms/mac/bundled-gateway)                                         |
| Зберігання стану поза синхронізованими з хмарою папками | [Gateway у macOS](/uk/platforms/mac/bundled-gateway#state-directory-on-macos)          |
| Налагодження виявлення застосунку та підключення | [Gateway у macOS](/uk/platforms/mac/bundled-gateway#debug-app-connectivity)                   |
| Розуміння поведінки launchd                    | [Життєвий цикл Gateway](/uk/platforms/mac/child-process)                                       |
| Виправлення проблем із дозволами, підписуванням або TCC | [Дозволи macOS](/uk/platforms/mac/permissions)                                         |
| Виявлення Mac, який використовувався останнім  | [Присутність активного комп’ютера](/uk/nodes/presence)                                         |
| Підключення до віддаленого Gateway             | [Віддалене керування](/uk/platforms/mac/remote)                                                 |
| Перегляд стану в смузі меню та перевірок справності | [Смуга меню](/uk/platforms/mac/menu-bar), [Перевірки справності](/uk/platforms/mac/health)    |
| Використання вбудованого інтерфейсу чату       | [WebChat](/uk/platforms/mac/webchat)                                                            |
| Використання голосової активації або режиму «натисни й говори» | [Голосова активація](/uk/platforms/mac/voicewake)                                |
| Використання Canvas і глибинних посилань Canvas | [Canvas](/uk/platforms/mac/canvas)                                                             |
| Розміщення PeekabooBridge для автоматизації інтерфейсу | [Міст Peekaboo](/uk/platforms/mac/peekaboo)                                             |
| Налаштування схвалення команд                  | [Схвалення виконання](/uk/tools/exec-approvals), [розширені відомості](/uk/tools/exec-approvals-advanced) |
| Перегляд команд Node Mac і IPC застосунку      | [IPC macOS](/uk/platforms/mac/xpc)                                                              |
| Збирання журналів                              | [Журналювання macOS](/uk/platforms/mac/logging)                                                 |
| Збирання з вихідного коду                      | [Налаштування середовища розробки macOS](/uk/platforms/mac/dev-setup)                           |

## Пов’язані матеріали

- [Платформи](/uk/platforms)
- [Початок роботи](/uk/start/getting-started)
- [Gateway](/uk/gateway)
- [Схвалення виконання](/uk/tools/exec-approvals)
