Если вы уже запустилиOpenClaw шлюзс помощьюглобальный НПМ or Докер / GHCRно продолжайте спорить, стоит ли преследоватьпоследний, ли листатьстабильный / бета / разработчикнарушит сопряжение, или является ли CLI или тег изображения реальным источником истины, эта статья дает вамполитика управления версиями, готовая к изменению билетов: заморозить один рельс (npm или compose), затем используйтезакрепленные теги/дайджесты плюс шестиэтапная матрица откататак что апгрейды - это операции, а не рулетка. Он дополняет нашуруководство по кроссплатформенной установке, Начальная загрузка GHCR и пользовательский интерфейс управления, иКонтрольный список обновления и миграции .openclaw; для постоянно включенных топологий в сочетании сЛокальная переадресация SSH на выделенный удаленный шлюз Mac.
последнийкак всегда безопасно: плавающие теги реестра перемещаются с предыдущими выпусками; два хоста могут быть «последними», но при этом указывать на разные дайджесты, что приводит к фантомному дрейфу во время инцидентов.открытый коготь --версиявперед, в то время как двоичный файл контейнера отстает (или наоборот), часто проявляясь в виде отсутствующих подкоманд или неизвестных флагов, которые люди ошибочно принимают за WebSocket 1006.докер: ты меняешьсяOPENCLAW_IMAGEв то время как кэшированные слои сохраняются, поэтому операторы клянутся, что обновили среду, но все еще запускают старый дайджест.Политика канала и закрепления на самом деле сводится к замораживаниюнаблюдаемая версия тройка— Версия CLI, дайджест образа шлюза, контрольная сумма дерева конфигурации — поэтому неудачные обновления попадают в систему.одна матрица откатавместо устного фольклора. В отличие от обычных рекламных постов, эта статья намеренновзаимоисключающиес нашими статьями об установке/загрузке/миграции: предполагается, что вы уже успешно загрузились, и фокусируется науправление поверхностью изменений.
Когда гоняешься за свежими постройкамикрошечные планы VPS or on a ноутбук привязан к рабочему столу для сна, ты тоже складываешьограничения cgroup, приостановка закрытия крышки и давление на дискшум, маскирующийся под «жучки канала». Вот почему лестница ниже требуетдоктор с открытым когтемплюс шлюзы ресурсов, соответствующие именам полей всортировка врача после установки, не дублируя всю энциклопедию симптомов.
| Измерение | Глобальный npm (интерфейс командной строки хоста) | Docker/GHCR (контейнер шлюза) |
|---|---|---|
| Источник истины | npm dist-tags (семантика стабильной/бета-версии/разработчика определена в исходной версии) плюс политика кэширования файлов блокировки/CI | OPENCLAW_IMAGEссылка; приколоть:ярлык or @sha256:переваривать |
| Стоимость погони за головой | Низкое трение, но чувствительно к глобальному узлу, прокси, сертификатам, PATH | Воспроизводимые слои; цена продумана, состав + разрешения на громкость |
| Ручки отката | Предыдущая версия npm + резервная копия.openclaw; переустановите, если необходимо |
Изменить ссылку на изображение +составить -d; соединение может сохраниться, если объемы останутся (согласно примечаниям к выпуску) |
| Распространенное неправильное использование | ПроизводствоНПМ я -гбез билета и резервного копирования |
Несколько вилок компоновки используют один именованный том, поэтому откат env A подавляет env B. |
| С выделенным удаленным Mac | Хорошо на ноутбуках для разработчиков; производство все равно надо закреплять | Идеально подходит для работы 7×24 на выделенном оборудовании; соединить с пересылкой SSH или Tailnet и переварить контакты сложнее |
руководство по кроссплатформенной установкеотвечает «от нуля до бега»;настройка докера + GHCR + пользовательский интерфейс управленияотвечает «первая загрузка по официальному пути контейнера»;Контрольный список обновления и миграцииотвечает «Резервное копирование .openclaw, переключение шлюза, двухпутевой порядок отката». Эта статья только добавляетсемантика канала + стратегия закрепления + матрица npm/изображенийтаким образом, вы можете создать заявку, которая переходит от стабильной тройки → тройки кандидатов → вернуться, не перечитывая скриншоты мастера.
Если твоя боль1006/1008, два источника ТОКЕНА или соединение субагента, перейти первым кRunbook для сопряжения и конфликта токенов; здесь мы только даемпороги принятия решениядля «нужно ли мне повторно выполнить сопряжение после обновления», чтобы избежать дублирования специальных таблиц симптомов.
Берегись:точная семантикастабильный / бета / разработчик, имена dist-тегов и строки тегов изображений изменяются по мере выпуска предыдущих версий. Заполнители, такие какобновление открытого когтя or OPENCLAW_IMAGEобозначатьклассы возможностей; замените точные подкоманды и поля из официальной документации для закрепленной вами сборки.
открытый коготь --версия(или эквивалент),проверка образа Dockerдайджест, создайте файл git SHA и контрольную сумму.openclawдерево; не трогайте производственные окна, если какой-либо предмет отсутствует.обновление открытого когтя(или эквивалент) с отправкой журналов в CI; Путь Docker работаетDocker Compose Pullзатемup -d— никогда не извлекайте без воссоздания (полуобновление).статус шлюза openclaw→ дополнительный зонд → минимальный неразрушающий чат или проверка работоспособности →доктор с открытым когтем; любая неудача приводит к откату, а не к «попробуй еще раз сильнее».OPENCLAW_IMAGEвернуться к последнему заведомо удачному дайджесту,составить -dс помощью воссоздания убедитесь, что тома по-прежнему монтируются по тем же логическим путям, перезапустите лестницу и запишите новый дайджест.# Pre-change triple registration (rename fields to your ticket template)
openclaw --version 2>/dev/null || true
docker compose config | sed -n '1,120p'
docker inspect "$(docker compose images -q openclaw-gateway 2>/dev/null | head -n1)" --format '{{.RepoDigests}}' 2>/dev/null || true
# Example: move OPENCLAW_IMAGE from a floating tag to digest pinning
# export OPENCLAW_IMAGE="ghcr.io/openclaw/openclaw@sha256:<known-good digest>"
# docker compose pull && docker compose up -d
последнийдайджест изменений в производственных пулах; более одного раза должно вызвать закрепление дайджеста или семвера, а также запись примечания к выпуску.На персональных ноутбуках режим сна/бодрствования, переключение VPN, фрагментация и контекст связки ключей сочетаются с работой шлюза, поэтому инциденты выглядят как ошибки канала. Плавающийпоследнийв производстве шкурнепроверяемый дрейф дайджестаиперекос флота, что в конечном итоге маскирует проблемы с версией под ошибки модели или сети. Когда вам нужно7×24, контролируемая частота измененийи относитесь к ноутбуку как к тонкому клиенту, разместив авторитетный шлюз навыделенный удаленный Mac Apple Siliconс документированной пересылкой SSH или входом в хвостовую сеть обычно лучше, чем политика электропитания для ноутбуков -MACCOMEпредлагает Mac mini (M4 / M4 Pro) в шести регионах с гибкой арендой и естественным соединением с остальными нашими книгами OpenClaw; размер флота с помощью общественностируководство по аренде в нескольких регионахпрежде чем заморозить топологию.
Команды, которые настаивают на запуске производственного шлюза на потребительских ноутбуках, часто недооцениваютчастота внесения исправлений, тепловое регулирование во время длительных вызовов модели и невозможность присоединения детерминированных дисковых бюджетов.. Выделенные удаленные компьютеры Mac предоставляют вам стабильное технологическое пространство, предсказуемый размер твердотельного накопителя и историю операций, которую финансисты могут проверять, особенно когда закрепленные дайджест-контейнеры и окна аренды документируются вместе.
Результаты должны перечислятьканал по умолчанию, разрешенные временные окна канала, запрещенные шаблоны (например, продукт не должен запускаться без дайджеста), примеры выходных данных лестницы, владельцы/таймауты отката ветвей. Любой шаг обновления, который завершается неудачно на второй чистой машине, является незавершенной документацией. Когда ты читаешь это рядом сРабочая книга Docker, храните политику изображений и политику хранения журналов в одном и том же каталоге, чтобы никто не спрашивал: «Какой уровень мы на самом деле извлекли той ночью?»
FAQ
Должен ли я сбросить токен шлюза после временного перехода со стабильной версии на бета-версию или версию для разработчиков?
Не обязательно: сначала пройдите по лестнице и минимальному щупу; Если появляются рукопожатия или сигналы двойного токена, следуйте статье о сопряжении. Планируете выделенный хост для производства? Обзорставки арендыиподдержка и помощьдля узлов MACCOME.
Когда в образах Docker следует использовать последнюю версию, а не закрепленный дайджест?
В одиночных песочницах для повышения скорости можно использовать новейшие версии; Проверки производства и соответствия требованиям на нескольких хостах должны закреплять дайджест или семвер и хранить составление SHA + дайджеста в одном билете. Границы установки остаются в статье о начальной загрузке GHCR, указанной выше.