Gateway на удалённом Mac не запускается после выбора Node.js или ведёт себя иначе, чем CI.
Быстрое решение: для нового постоянно работающего Gateway сначала проверяйте рекомендованный OpenClaw Node 26 и требуемую проверку SQLite; если вам важна точная согласованность с CI и выпуском OpenClaw, оценивайте Node 24 LTS. Окончательный выбор делайте по требованиям именно вашей версии и по результату проверки того Node.js, который реально запускает Gateway, а не только по версии в терминале.
Эта инструкция пригодится разработчикам, которые разворачивают OpenClaw Gateway на удалённом Mac и хотят оставить его работающим постоянно. Инженеры CI и выпуска смогут сопоставить рабочую среду с используемым в OpenClaw Node 24 LTS. DevOps-специалисты найдут порядок проверки установщика, SQLite и перезапуска службы.
Сначала сопоставьте Node с задачей Gateway
Для нового узла без требования повторять CI выберите Node 26 только после того, как текущая документация OpenClaw подтвердит его для целевой версии, а проверка SQLite завершится успешно. Если ваша задача — воспроизводить среду CI и выпуска OpenClaw, оценивайте Node 24 LTS при условии, что он отвечает текущим требованиям OpenClaw. Именно такое разделение — рекомендованный Node 26 для запуска и Node 24 LTS для CI и выпуска — указано в документации OpenClaw по Node.js.
Это выбор серверного runtime, а не универсальное требование для любого приложения OpenClaw на Mac. Условия для macOS-приложения, CLI и Gateway нужно проверять раздельно: документация платформы macOS описывает приложение, а серверный Gateway и CLI зависят от выбранного пути установки и Node.js. Не переносите требование к одному компоненту на другой без проверки документации OpenClaw для macOS и описания Gateway, поставляемого с приложением.
Какой Node выбрать для OpenClaw на удалённом Mac? Если Gateway будет отдельной постоянно работающей службой, начните с Node 26 и проверки совместимости, указанной для вашей версии OpenClaw. Если задача требует максимально близко воспроизводить CI OpenClaw, сравнивайте конфигурацию с Node 24 LTS. Если ни один вариант не проходит официальные проверки, не запускайте узел постоянно, пока не выясните причину.
| Сценарий | Что оценивать | Условная оценка соответствия | Что подтвердить перед запуском |
|---|---|---|---|
| Новый постоянно работающий OpenClaw Gateway на Mac | Node 26 как рекомендованный runtime OpenClaw | Высокая, если требования версии и проверка SQLite выполнены | Фактическую версию Node у Gateway, результат проверки SQLite и успешный перезапуск. [Требования OpenClaw](https://docs.openclaw.ai/install/node) |
| Воспроизведение CI и процесса выпуска OpenClaw | Node 24 LTS, который OpenClaw использует для CI и выпуска | Высокая для соответствия этому окружению; не означает, что это универсальный выбор для любого Gateway | Требования целевой версии OpenClaw и различия между CI и удалённым узлом. [Документация OpenClaw по Node.js](https://docs.openclaw.ai/install/node) |
| Старый Mac, нестандартный установочный путь или проверка SQLite завершается ошибкой | Не выбирать runtime только по номеру основного релиза | Низкая до выяснения ограничений | Поддержку системы, используемую установщиком версию, обновления безопасности и диагностику SQLite. [Совместимость Node.js в OpenClaw](https://docs.openclaw.ai/install/node-compatibility) |
**Важно:** если Node 26 доступен в интерактивной оболочке, это ещё не доказывает, что служба Gateway использует именно его. Для решения важны исполняемый файл и версия в контексте запущенной службы.
Проверьте, какой Node использует ваш сценарий установки
Автоматическая установка, уже существующий Node.js и установка с локальным префиксом могут приводить к разным выбранным runtime. Поэтому значение по умолчанию в одном пути установки не следует считать обязательным правилом для всех вариантов. Сверяйте фактическое поведение с документацией установщика OpenClaw: выбор версии зависит от способа установки и уже имеющейся среды.
При самостоятельном управлении Node проверьте не только оболочку, из которой вы подключились по SSH, но и окружение процесса Gateway. Интерактивная сессия может находить один исполняемый файл, тогда как запуск службы настроен на другой путь. Это особенно важно, если версия задаётся менеджером runtime или локальным префиксом: PATH команды в SSH-сеансе и PATH службы могут различаться.
Как проверить runtime, не полагаясь на версию в терминале? Зафиксируйте результат команды node --version и путь к node в той среде, где вы выполняете установку. Затем подтвердите, какой исполняемый файл и какая версия относятся к самому процессу Gateway. Если диагностические средства OpenClaw показывают runtime службы, сохраните эти данные; иначе выясните конфигурацию запуска и сопоставьте её с фактическим путём. Не считайте проверку из SSH достаточной, пока не проверили именно фоновый процесс.
В протоколе установки полезно сохранить:
- выбранный способ установки OpenClaw и его параметры;
- версию OpenClaw, для которой проводится проверка;
- версию Node в оболочке и версию Node, используемую Gateway;
- путь к исполняемому файлу Node, если он доступен;
- сообщения установщика и результат диагностики SQLite;
- состояние Gateway после запуска и после перезапуска службы.
Сверьте удалённый Mac с CI без догадок о причинах
OpenClaw указывает Node 24 LTS для CI и выпуска. Если тесты в CI проходят, а Gateway на удалённом Mac ведёт себя иначе, не заменяйте runtime наугад. Сначала установите, совпадают ли версия Node, версия OpenClaw, способ установки и результаты проверки SQLite. Различие в одном из этих пунктов ещё не доказывает, что именно оно вызвало проблему, но даёт проверяемое направление диагностики.
Для сравнения сохраните оба набора данных в одинаковой структуре: идентификатор сборки или развёртывания, версию OpenClaw, версию Node, источник установки, результат проверки SQLite и итог запуска. Укажите, какая конфигурация относится к CI, а какая — к Gateway. Если в CI используется Node 24, а на узле выбран Node 26, фиксируйте это как различие среды, а не как подтверждённую причину сбоя.
Как согласовать версию Node на Mac с CI? Если приоритет — воспроизводимость CI OpenClaw, проверяйте Node 24 LTS и на целевом узле, но только после подтверждения его соответствия требованиям вашей версии OpenClaw. Если на Mac остаётся Node 26, сохраняйте в результатах теста точную версию и проверку SQLite, чтобы отличие было явным, а не скрытым. Такой отчёт позволит команде повторить проверку и отдельно решить, нужно ли выравнивать среды.
Не смешивайте «соответствует runtime CI» и «подходит для постоянного Gateway». Это разные критерии: первый помогает воспроизвести процесс выпуска, второй требует успешной проверки установки и стабильного запуска службы в конкретном окружении удалённого Mac.
Проверьте Node.js и SQLite как единый набор условий
Основной номер версии Node сам по себе не подтверждает совместимость OpenClaw с базой данных. Документация OpenClaw отдельно описывает совместимость Node.js и требования к SQLite. Перед развёртыванием сверьте эти условия с целевой версией OpenClaw и выполните предусмотренную для неё проверку. Не подменяйте её предположением вида «Node новее, значит всё совместимо».
Как подтвердить совместимость Node.js и SQLite? Проверьте требования версии OpenClaw, запустите её официальную проверку совместимости и сохраните результат вместе с версией Node, которой пользуется Gateway. Если проверка сообщает об ограничении SQLite, разбирайте именно это сообщение и подтверждайте диагноз по документации и фактическому состоянию процесса. Не объявляйте проблему решённой только из-за смены Node 24 на Node 26 или наоборот.
SQLite может использовать WAL для ведения журнала. При диагностике учитывайте назначение этого режима и сведения из документации SQLite о WAL. Не удаляйте файлы WAL или SHM у работающего экземпляра как универсальный способ исправления: сначала остановите службу безопасным способом, сохраните данные диагностики и выясните, что именно указывает OpenClaw. Само наличие таких файлов не является достаточным доказательством повреждения базы.
Если результат проверки непонятен, сохраните исходный вывод и остановитесь до изменения данных. Сопоставьте его с документацией именно вашей версии OpenClaw; не применяйте советы для другой версии как безусловную инструкцию.
Учтите обновления безопасности и ограничения старого Mac
Даже если Node уже установлен и OpenClaw запускается, проверьте уровень обновлений безопасности, который требуется в актуальной документации. Минимальные версии и рекомендации могут меняться вместе с OpenClaw и Node.js. Поэтому не переносите порог из старой инструкции на новую установку: сверяйте его с текущими требованиями Node.js в OpenClaw и совместимостью для целевого выпуска.
Отдельно оцените возраст и состояние macOS. Если старый хост не поддерживает требуемую версию runtime или обновление системы невозможно, не пытайтесь компенсировать это выбором Node только по номеру релиза. Зафиксируйте ограничение платформы, сравните доступный вариант с текущей матрицей совместимости и решите, стоит ли временно отложить развёртывание или перенести Gateway на поддерживаемый Mac.
Для команд с требованием фиксированной и воспроизводимой версии заведите явную запись о runtime и пути запуска. Обновление Node должно проходить как изменение окружения: проверьте установку OpenClaw, SQLite и работу службы после перезапуска до того, как считать новую конфигурацию принятой. При этом фиксировать нужно не устаревший номер навсегда, а проверенную конфигурацию вместе с датой и версией OpenClaw.
Примите решение по результатам проверки на целевом узле
Ниже — процедура для вашего удалённого Mac, а не результат испытаний MACGPU. В ней нет заявлений о протестированных узлах или сравнительной скорости: она помогает собрать подтверждения для собственного решения и не заменяет диагностику OpenClaw.
- [ ] Запишите версию OpenClaw и способ её установки; проверьте требования именно этого выпуска.
- [ ] Зафиксируйте, какая задача важнее: постоянная работа Gateway или совпадение с CI и выпуском.
- [ ] Для постоянного Gateway проверьте вариант Node 26; для воспроизведения CI OpenClaw — Node 24 LTS. Сверьте оба варианта с официальными требованиями.
- [ ] Запустите предусмотренную OpenClaw проверку SQLite и сохраните полный результат.
- [ ] Сопоставьте Node в интерактивной оболочке с исполняемым файлом и версией, используемыми Gateway.
- [ ] Запустите службу и зафиксируйте её фактическое состояние и диагностические сообщения.
- [ ] Перезапустите Gateway штатным для вашей установки способом и повторите проверку процесса и SQLite.
- [ ] Сравните запись удалённого Mac с данными CI, если команде важна воспроизводимость; отмечайте различия, не выдавая их за доказанную причину.
- [ ] Если требования не выполнены или после перезапуска результат не подтверждён, отложите постоянное развёртывание и устраните несоответствие.
Подготовьте среду до постоянного развёртывания
Перед испытанием полезно отделить проверку от рабочего экземпляра: так вы сможете подтвердить выбранный runtime и перезапуск, не меняя текущую конфигурацию вслепую. Если вам нужно разобраться с доступом и подготовкой удалённого Mac, начните с руководства по Mac M4, а при планировании временной среды изучите варианты аренды Mac.
Если у вас уже есть подходящий Mac и нагрузка постоянная, собственный узел может быть рациональным вариантом, особенно когда вам нужны физический доступ или фиксированная инфраструктура. Но он не избавляет от обслуживания системы, контроля runtime и проверки после обновлений. CI на Linux тоже не заменит Mac-среду там, где необходимы компоненты OpenClaw или инструменты, зависящие от macOS.
Если же текущий Mac занят, его система не подходит или вы не хотите проверять экспериментальную конфигурацию на рабочем узле, временная удалённая среда MACGPU позволит отдельно пройти установку, проверку Node и SQLite и испытание перезапуска. Это удобнее, чем сразу покупать оборудование для краткого теста, но не отменяет необходимости проверить требования и соответствие реальной рабочей нагрузке. Выберите сценарий Node по фактической цели, сохраните результаты проверки, а постоянный Gateway вводите только после подтверждённого запуска и восстановления после перезапуска.