застосунок для macOS

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

Потрібні лише CLI та Gateway? Почніть із розділу Початок роботи.

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

Збірки застосунку macOS доступні у випусках OpenClaw на GitHub. Якщо випуск містить ресурси застосунку macOS, шукайте:

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

Деякі випуски містять лише CLI, докази або ресурси Windows. Якщо найновіший випуск не містить ресурсу застосунку macOS, скористайтеся найновішим випуском, у якому він є, або зберіть застосунок із вихідного коду за допомогою налаштування середовища розробки macOS.

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

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

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

Для налаштування через CLI/Gateway скористайтеся розділом Початок роботи. Для відновлення дозволів скористайтеся розділом Дозволи macOS.

Оновлення

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

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

Після невдалого скоординованого оновлення вікно початкового налаштування залишається відкритим і містить дії для повторної спроби, посібник з оновлення та 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 див. у розділі Браузер.

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

Для обох режимів потрібен установлений CLI openclaw, оскільки застосунок повторно використовує його середовище виконання хоста Node. На новому Mac застосунок автоматично встановлює відповідний CLI; у локальному режимі він потім запускає майстер Gateway, а у віддаленому режимі підключається до вибраного Gateway, не запускаючи другий локальний Gateway. Відомості про відновлення вручну див. у розділі Gateway у macOS.

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

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

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

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

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

• Платформи
• Початок роботи
• Gateway
• Схвалення виконання