OpenClaw Menu Bar Companion 2026: деплой на удалённом Mac через VNC без Node.js

OpenClaw Menu Bar Companion (v1.0.0, релиз 18 февраля 2026) — нативное Swift-приложение, выводящее управление AI-агентом в строку меню macOS. Без браузера, без окна терминала. Но большинство новичков спотыкается на зависимостях Node.js, конфигурации секретов и запуске Gateway. Данное руководство решает проблему: полный деплой выполняется на удалённом Mac VNCMac, где графический десктоп полностью заменяет CLI. От нуля до горящей иконки лобстера в меню — менее чем за 30 минут, без локальной установки Node.js и без запоминания ни одной shell-команды.

Новое в OpenClaw v2026.2.26: Menu Bar Companion + External Secrets

Февральский релиз OpenClaw 2026 добавил две важные функции, меняющие повседневный опыт для новичков: Menu Bar Companion App (проект сообщества, v1.0.0) и встроенное External Secrets Management (v2026.2.26). Вместе они превращают OpenClaw из headless CLI-демона в видимый интерактивный резидент macOS.

Menu Bar Companion — что делает

Companion — нативный Swift universal binary (Apple Silicon + Intel), отображающийся в строке меню macOS как иконка лобстера. Основные возможности:

• Управление Gateway одним кликом: запуск, остановка и перезапуск OpenClaw Gateway без окна терминала.
• Индикатор статуса в реальном времени: иконка обновляется каждые 5 секунд — зелёная (работает), жёлтая (запуск), красная (остановлен или ошибка).
• Глобальный хоткей: ⌘⇧Space вызывает плавающее окно чата из любого приложения (Xcode, Finder и т.д.).
• Маршрутизация прав iMessage: автоматически направляет команды iMessage через Terminal.app (Full Disk Access), поэтому Companion не требует повышенных прав.
• Ярлык Dashboard: один клик на веб-панель OpenClaw по адресу localhost:18789.
• Автозапуск Gateway: опциональный запуск Gateway при старте приложения — удалённый Mac превращается в always-on хост AI-агента.

External Secrets — зачем новичкам

До v2026.2.26 API-ключи хранились в plaintext в ~/.openclaw/openclaw.json или .env. Новая система External Secrets поддерживает три провайдера учётных данных:

• env: чтение из переменных окружения macOS (например, OPENAI_API_KEY).
• file: ссылка на JSON-файл секретов с RFC 6901 pointers (например, /providers/openai/apiKey).
• exec: вызов внешней утилиты (1Password CLI, HashiCorp Vault Agent, sops) в момент активации.

Секреты разрешаются в in-memory snapshot при старте. При сбое разрешения любого учётного credentials Gateway отказывается стартовать — безопаснее, но в чисто терминальном workflow сложнее отлаживать. Графический десктоп упрощает: откройте файл в TextEdit, проверьте значение, повторите попытку.

Почему деплой на удалённом Mac? Препятствия локальной настройки

Большинство пользователей OpenClaw впервые сталкиваются с одними и теми же тремя стенами до появления иконки в меню. Понимание этих препятствий объясняет, почему удалённый Mac с полным VNC быстрее локальной возни.

Препятствие 1: Управление runtime Node.js

Gateway OpenClaw построен на Node.js. На чистой машине нужна правильная версия Node (сейчас Node 20 LTS), соответствующий npm или pnpm и глобальный бинарник openclaw в PATH. На macOS это обычно означает nvm или Homebrew, nvm use 20, установку пакета и экспорт PATH в shell init. Одна несовместимость даёт криптические ошибки вроде Error: Cannot find module 'openclaw' без GUI-индикации причины.

На удалённом Mac VNCMac: машина поставляется с предустановленным Homebrew и Node 20 LTS. Один раз откройте Terminal, выполните node --version и openclaw --version — управление Node на этом заканчивается.

Препятствие 2: Диалоги разрешений macOS

Companion требует разрешение Automation для управления Terminal.app. iMessage — Full Disk Access. Screen recording — тоже. На новом Mac или после обновления ОС эти диалоги идут последовательно, и при неправильном закрытии права оказываются в «полусломанном» состоянии, требующем System Settings → Privacy & Security для сброса.

Через VNC-десктоп все диалоги видны на экране. Нажимаете Allow, диалог закрывается, в System Settings видите переключатель — без неопределённости.

Препятствие 3: Ошибки конфигурации Secrets блокируют запуск Gateway

Валидация External Secrets — eager и синхронная. Неверный путь в secrets.json, неопределённая переменная окружения или отсутствующий exec-бинарник приводят к отказу Gateway со стартом. Ошибку легко пропустить в прокручиваемой сессии терминала. Частая ошибка новичков — путь вроде ~/.openclaw/secrets.json, корректно резолвящийся в интерактивном shell, но падающий при чтении OpenClaw из launchd, так как ~ может не раскрываться в non-login контекстах.

Графический деплой через VNC: DMG → Установка → Secrets → Gateway

Шаги ниже предполагают аккаунт VNCMac. Рекомендуется Mac mini M2 или выше для стабильной работы OpenClaw Gateway. Поставка обычно до 10 минут.

Шаг 1: Подключение к удалённому Mac по VNC

# Безопасный VNC-туннель — выполните в локальном терминале
ssh -L 5900:localhost:5900 [email protected] -N
# Затем RealVNC Viewer → подключение к: localhost:5900

Шаг 2: Проверка установки OpenClaw CLI

# Версия Node (должна быть 20+)
node --version

# OpenClaw CLI
openclaw --version

# Если openclaw отсутствует:
brew install openclaw/tap/openclaw

Шаг 3: Скачивание DMG Menu Bar Companion

Шаг 4: Установка и выдача разрешений

• Automation: разрешить OpenClaw MenuBar управлять Terminal.app (нужно для iMessage и маршрутизации команд).
• Full Disk Access (при запросе для iMessage): System Settings → Privacy & Security → Full Disk Access → включить Terminal.app.

Проверка: System Settings → Privacy & Security → Automation — «OpenClaw MenuBar» с галочкой рядом с Terminal.app.

Шаг 5: Конфигурация External Secrets

# Минимальный secrets.json — пример file provider
{
  "providers": {
    "openai": {
      "apiKey": "sk-your-actual-openai-key-here"
    }
  }
}

Затем в Terminal выполните конфигурацию secrets:

# 5a: Аудит текущих secrets
openclaw secrets audit --check

# 5b: Интерактивная конфигурация
openclaw secrets configure

# 5c: При запросе типа провайдера выберите "file"
# При запросе пути введите АБСОЛЮТНЫЙ путь:
# /Users/yourname/.openclaw/secrets.json

# 5d: Перезагрузка для валидации
openclaw secrets reload

Если secrets reload возвращает OK — учётные данные разрешились. При ошибке откройте Finder, проверьте путь и имя файла, исправьте в TextEdit и снова выполните openclaw secrets reload — перезапуск всего Gateway не нужен.

Шаг 6: Запуск Gateway и подключение

Отличие от руководства v2026.2 по обходу CLI

Ранее мы публиковали руководство по обходу Node.js через GUI удалённого Mac (v2026.2). Понимание различий поможет выбрать нужный источник.

Если вы уже прошли руководство v2026.2 и Gateway работает — переходите к шагу 3 (установка DMG Menu Bar Companion) на существующем удалённом Mac.

Ежедневное использование: хоткеи, уведомления, мониторинг Agent

После установки Companion и запуска Gateway ежедневная работа переходит от терминала к жестам в меню. Ниже — как это выглядит на VNCMac удалённом десктопе.

Глобальный хоткей: вызов панели чата

Стандартный хоткей — ⌘⇧Space. Нажмите из любого приложения (Xcode, Finder, браузер) — плавающая панель OpenClaw появится из области меню. Можно ввести промпт, прочитать ответ, закрыть панель без переключения окон. Смена хоткея: иконка лобстера → Preferences → Global Shortcut → записать новую комбинацию.

Push-уведомления для долгих задач

При запуске задачи длительностью несколько секунд (сборка, рефакторинг, API-вызовы) Companion отправляет нативное уведомление macOS по завершении. Можно отойти от VNC-десктопа, работать локально — баннер придёт, когда агент закончит.

Включение: иконка лобстера → Notifications → Enable. macOS запросит разрешение — Allow. Уведомления появятся в Notification Center удалённого десктопа; при активной сессии VNC вы их увидите.

Мониторинг статуса Agent

Иконка в меню отображает состояние через цвет и анимацию:

• Зелёный лобстер: Gateway работает, агент простаивает.
• Пульсирующая анимация: агент выполняет задачу — состояния exec, read, write, edit, attach.
• Жёлтый: Gateway запускается или перезапускается.
• Красный: Gateway остановлен или упал — клик для деталей и перезапуска.

Клик по иконке в любой момент: описание текущей задачи, счётчик API за сессию, время последней активности, health соединения. Вместо tail логов или openclaw status в терминале.

Ключевые метрики (бенчмарк)

• Запуск Gateway на M2 Mac mini: 3–5 секунд cold start с External Secrets.
• Secrets reload (hot): менее 1 секунды для env/file провайдеров.
• Отклик панели по хоткею: менее 200 мс от нажатия до отображения.
• Интервал опроса статуса: 5 секунд (настраивается в Preferences → Advanced).
• Задержка уведомлений: обычно менее 2 секунд после завершения задачи.

Быстрая отладка