이미 실행 중이라면 오픈클로 게이트웨이 통해 글로벌 npm or 도커/GHCR 하지만 쫓아갈까 말까 계속 고민하다 최신, 뒤집기 여부 안정된 / 베타 / 개발자 페어링이 중단되거나 CLI 또는 이미지 태그가 실제 정보 소스인지 여부에 대해 이 문서에서 알려드립니다. 변경 티켓 준비 버전 관리 정책: 단일 레일 고정(npm 또는 compose), 그런 다음 사용 고정된 태그/다이제스트 및 6단계 롤백 매트릭스 따라서 업그레이드는 룰렛이 아니라 작업입니다. 이는 우리의 크로스 플랫폼 설치 가이드, GHCR 부트스트랩 및 제어 UI, 그리고 업그레이드 및 .openclaw 마이그레이션 체크리스트; Always-On 토폴로지 쌍의 경우 전용 원격 Mac 게이트웨이로 SSH 로컬 전달.
최신 언제나처럼 안전하다: 부동 레지스트리 태그는 업스트림 릴리스와 함께 이동합니다. 두 호스트는 모두 "최신"이지만 서로 다른 다이제스트를 가리키므로 사고 중에 유령 드리프트가 발생할 수 있습니다.openclaw --버전 컨테이너 바이너리가 지연되는 동안(또는 그 반대) 종종 누락된 하위 명령이나 알 수 없는 플래그로 나타나 사람들이 WebSocket 1006으로 잘못 읽습니다.도커 풀: 네가 변해 OPENCLAW_IMAGE 캐시된 레이어가 남아 있는 동안 운영자는 환경을 업데이트했지만 여전히 오래된 다이제스트를 실행한다고 맹세합니다.채널 및 고정 정책은 실제로 관찰 가능한 버전 트리플—CLI 버전, 게이트웨이 이미지 다이제스트, 구성 트리의 체크섬 —그래서 실패한 업그레이드는 하나의 롤백 매트릭스 구전 민속 대신. 일반적인 과대 광고 게시물과 달리 이 게시물은 의도적으로 상호 배타적 설치/부트스트랩/마이그레이션 기사: 이미 성공적으로 부팅했다고 가정하고 다음에 중점을 둡니다. 변경 표면 관리.
새로운 빌드를 추적할 때 작은 VPS 계획 or on a 데스크탑 절전 모드에 연결된 노트북, 너도 스택 cgroup 제한, 덮개 닫힘 일시 중지 및 디스크 압력 "채널 버그"로 가장하는 소음. 이것이 바로 아래 사다리가 요구하는 이유입니다. 발톱 의사 그리고 필드 이름에 맞춰 정렬된 리소스 게이트 설치 후 의사 분류, 전체 증상 백과사전을 복제하지 않고.
| 차원 | 글로벌 npm(호스트 CLI) | Docker/GHCR(게이트웨이 컨테이너) |
|---|---|---|
| 진실의 근원 | npm dist-tags(업스트림에 정의된 안정/베타/개발 의미) 및 잠금 파일/CI 캐시 정책 | OPENCLAW_IMAGE 참조; 핀 :태그 or @sha256: 다이제스트 |
| 머리를 쫓는 비용 | 마찰은 낮지만 글로벌 노드, 프록시, 인증서, PATH에 민감합니다. | 재현 가능한 레이어; 가격은 사려 깊은 작성 + 볼륨 권한입니다 |
| 롤백 핸들 | 이전 npm 버전 + 백업 .openclaw; 필요한 경우 다시 설치 |
이미지 참조 변경 + 작성 -d; 볼륨이 유지되면 페어링이 유지될 수 있습니다(릴리스 노트에 따라). |
| 일반적인 오용 | 생산 npm i -g 티켓도 백업도 없이 |
여러 개의 작성 포크가 하나의 명명된 볼륨을 공유하므로 env A가 env B를 굴러가는 경우 |
| 전용 원격 Mac 포함 | 개발용 노트북에서는 괜찮습니다. 생산은 여전히 고정되어야 합니다 | 전용 하드웨어의 7×24에 이상적입니다. SSH 전달 또는 tailnet과 쌍을 이루고 핀 다이제스트가 더 어렵습니다. |
는 크로스 플랫폼 설치 가이드 "0에서 실행까지"라고 대답합니다. docker-setup + GHCR + 제어 UI "공식 컨테이너 경로에서 첫 번째 부팅"이라고 대답합니다. 업그레이드 및 마이그레이션 체크리스트 ".openclaw 백업, 게이트웨이 컷오버, 이중 경로 롤백 순서"에 답변합니다. 이 글은 단지 추가합니다 채널 의미론 + 고정 전략 + npm/이미지 매트릭스 따라서 마법사 스크린샷을 다시 읽지 않고도 안정적인 트리플 → 후보 트리플 → 되돌리기로 이동하는 티켓을 작성할 수 있습니다.
당신의 고통이 있다면 1006/1008, 듀얼 TOKEN 소스 또는 하위 에이전트 페어링, 먼저 다음으로 이동 페어링 및 토큰 충돌 런북; 여기서 우리는 단지 제공 결정 임계값 전용 증상 표 중복을 피하기 위해 "업그레이드 후 페어링을 다시 실행해야 합니까?"
알림: 정확한 의미론 안정된 / 베타 / 개발자, dist-tag 이름 및 이미지 태그 줄은 업스트림 릴리스와 함께 발전합니다. 다음과 같은 자리 표시자 오픈클로 업데이트 or OPENCLAW_IMAGE 나타내다 능력 클래스; 고정한 빌드를 공식 문서의 정확한 하위 명령과 필드로 대체하세요.
openclaw --버전 (또는 이에 상응하는 것), 도커 이미지 검사 다이제스트, 파일 git SHA 작성 및 체크섬 .openclaw 나무; 누락된 품목이 있는 경우 생산 창을 만지지 마십시오.오픈클로 업데이트 (또는 이에 상응하는) 로그가 CI로 전송됨 Docker 경로가 실행됩니다. 도커 작성 풀 그럼 up -d—다시 생성하지 않고 당기지 마십시오(반 업그레이드).오픈클로 게이트웨이 상태 → 선택적 프로브 → 최소한의 비파괴 채팅 또는 상태 확인 → 발톱 의사; 모든 실패는 "더 열심히 다시 시도"하는 것이 아니라 롤백됩니다.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
최신 프로덕션 풀의 다이제스트를 변경합니다. 두 번 이상 다이제스트 또는 semver 고정과 릴리스 노트 항목을 트리거해야 합니다.개인용 노트북은 게이트웨이 작업 위에 절전/깨우기, VPN 플랩, 조각화, 키체인 컨텍스트를 쌓아두므로 사고가 채널 버그처럼 보입니다. 플로팅 최신 생산중인 가죽 감사할 수 없는 다이제스트 드리프트 그리고 함대 편향, 결국 버전 문제를 모델 또는 네트워크 오류로 가장합니다. 필요할 때 7×24, 감사 가능한 변경 케이던스 노트북을 씬 클라이언트로 취급하여 권한 있는 게이트웨이를 전용 Apple Silicon 원격 Mac 문서화된 SSH 전달 또는 tailnet 수신은 일반적으로 레슬링 노트북 전원 정책을 능가합니다.MACCOME유연한 임대를 통해 6개 지역에 걸쳐 Mac mini(M4/M4 Pro)를 제공하고 나머지 OpenClaw Runbook과 자연스럽게 연결됩니다. 대중을 이용하여 차량 규모를 조정합니다. 다중 지역 렌탈 가이드 토폴로지를 고정하기 전에.
소비자 노트북에서 프로덕션 게이트웨이를 실행해야 한다고 주장하는 팀은 종종 이를 과소평가합니다. 패치 흐름, 긴 모델 호출 중 열 조절, 결정론적 디스크 예산 연결 불가. 전용 원격 Mac은 안정적인 프로세스 공간, 예측 가능한 SSD 크기 조정, 재무 부서에서 감사할 수 있는 운영 스토리를 제공합니다. 특히 다이제스트 고정 컨테이너와 임대 기간이 함께 문서화되어 있는 경우 더욱 그렇습니다.
결과물이 나열되어야 함 기본 채널, 허용되는 임시 채널 창, 금지된 패턴(예: 제품은 다이제스트 없는 최신 버전을 실행하면 안 됨), 샘플 래더 출력, 롤백 분기 소유자/시간 초과. 두 번째 깨끗한 시스템에서 실패한 모든 업그레이드 단계는 완료되지 않은 문서입니다. 옆에서 이 글을 읽으면 Docker 프로덕션 런북, 이미지 정책과 로그 보존 정책을 동일한 디렉터리에 유지하여 아무도 "그날 밤 실제로 어떤 레이어를 가져왔습니까?"라고 묻지 않도록 합니다.
FAQ
일시적으로 안정 버전에서 베타/개발 버전으로 전환한 후 게이트웨이 토큰을 재설정해야 합니까?
반드시 그런 것은 아닙니다. 사다리와 최소 프로브를 먼저 실행하십시오. 악수나 듀얼 토큰 알람이 나타나면 페어링 도움말을 따르세요. 프로덕션 전용 호스트를 계획 중이신가요? 검토 임대료 그리고 지원 및 도움 MACCOME 노드의 경우.
Docker 이미지는 언제 최신 다이제스트와 고정 다이제스트를 사용해야 합니까?
솔로 샌드박스는 속도를 위해 최신 버전을 사용할 수 있습니다. 멀티 호스트 프로덕션 및 규정 준수 검토는 다이제스트 또는 서버를 고정하고 하나의 티켓에 SHA + 다이제스트를 저장해야 합니다. 설치 경계는 위에 링크된 GHCR 부트스트랩 기사에 있습니다.