2026: OpenClaw на удалённом физическом Mac — переменные окружения, SecretRef, команда openclaw env, LaunchAgent и интерактивный SSH; риски Keychain и открытого plist

1. Типичные боли

(1) Расщеплённое окружение: ssh user@mac подгружает профили оболочки и часто даёт более широкий PATH; LaunchAgent — нет. Симптомы: «модуль не найден», другой бинарник Node, отсутствует SSL_CERT_FILE — до перезагрузки всё маскируется.

(2) SecretRef и удобство: вставка API-ключей в EnvironmentVariables plist быстро чинит демо, но увеличивает зону поражения на образах диска, бэкапах и общих админах — особенно в пулах удалённых Mac.

(3) Аудит и комплаенс: без описания того, кто читает ~/Library/LaunchAgents/*.plist и каталоги SecretRef, нельзя ответить на security review и анкеты заказчика о ключах на физических хостах.

2. Матрица: интерактивный SSH, LaunchAgent и вход в GUI

Перед правками конфигурации выберите одну строку как «источник истины» и подгоните остальные под неё.

3. SecretRef и openclaw env

SecretRef (или аналогичная индирекция в вашем развёртывании) выносит крупные или чувствительные значения из основного конфига, сохраняя для OpenClaw стабильный путь в ФС или инъекцию в окружение во время работы. openclaw env — самый быстрый способ увидеть, что CLI считает активным: запускайте в том же контексте, что и падающий процесс (SSH, sudo -u, launchd).

Если значения расходятся, не «чините» сначала SecretRef — сначала докажите совпадение WorkingDirectory и пользователя. Путь SecretRef, валидный для /Users/alice, упадёт для задачи, случайно запущенной под другим UID из скопированного plist.

4. Семишаговый воспроизводимый runbook

1. Зафиксировать симптом: точные строки ошибок (401, ENOENT, EACCES) и появляются ли они только после reboot или только без SSH.
2. Базовая линия SSH: по SSH выполнить openclaw env (или дамп окружения вашей версии) и сохранить вывод.
3. Базовая линия launchd: для метки LaunchAgent выполнить launchctl print gui/$(id -u)/<label> и сравнить ключи окружения.
4. Нормализовать PATH и HOME: перенести в plist только нужные ключи в EnvironmentVariables; не вставлять целиком блок export из интерактива.
5. Проверить пути SecretRef: каталоги на месте, POSIX-права позволяют UID шлюза, пути в openclaw.json совпадают между dev и удалёнкой.
6. Холодный старт: reboot или launchctl kickstart -k по задаче без входа через Screen Sharing — шлюз слушает и проходит upstream-аутентификацию.
7. Задокументировать хранение: где лежат секреты — Keychain, SecretRef или открытый plist; к приложению runbook добавить режимы файлов (ls -le).

Keychain и открытый plist: что ломается на практике?

5. Ориентиры для отчётов

• Дельта PATH: в интерактивном zsh часто больше 12 записей; у launchd — реже шести; отсутствие Homebrew или fnm — главная причина «в SSH работает».
• SLA после холодного старта: для прод-шлюзов на физических Mac разумно требовать успешный подъём в течение 5 минут после включения питания.
• Биты прав: каталоги SecretRef не должны быть world-writable и не должны принадлежать root, если шлюз — обычный пользователь — EACCES часто значит несовпадение UID, а не «плохой секрет».

6. FAQ

Почему в SSH всё ок, а под LaunchAgent падает? SSH поднимает стартовые файлы оболочки и может давать другой контекст учётных данных; launchd видит только env из plist. Выровняйте PATH, HOME и пути SecretRef — или оберните запуск в скрипт с минимальным проверенным блоком переменных.

Класть ли API-ключи в plist? Только осознанно: plist легко ищется по диску и часто попадает в бэкапы. Предпочитайте SecretRef или Keychain; если остаётесь на plist, ужесточайте chmod и фиксируйте владельцев.

Считается ли интерактивный SSH «продом»? Для отладки — да; SSH обрывается при сетевых флуктуациях. Прод-форма для шлюзов на удалённых Mac — LaunchAgent и проверки здоровья.

openclaw env показывает ключ, а шлюз всё равно отвечает 401? Разделите «переменная есть» и «выбран нужный профиль upstream»: проверьте профиль аутентификации в openclaw.json и ротируйте ключи целенаправленно, а не дублируя их в трёх местах.

7. Почему Mac mini уместен для безлюдного OpenClaw

Всё выше — стабильность launchd, предсказуемые пути SecretRef и восстановление по SSH — лучше всего раскрывается на железе, рассчитанном на месяцы тихой работы macOS. Mac mini на Apple Silicon даёт полноценный Unix userland, очень низкое энергопотребление в простое (порядка нескольких ватт), почти бесшумную работу и нативные SSH, launchd и Keychain без «сборки сервера из ноутбука». Командам с повторяемыми шлюзами в разных регионах важнее предсказуемость, чем разовый пик GHz.

Если нужна та же автоматизация на выделенном железе с предсказуемой сетью, Mac mini M4 — один из самых экономичных способов получить Apple Silicon и серверную тишину в одном корпусе — оформите узел через ZoneMac по кнопке ниже.