메인 콘텐츠로 건너뛰기

​
업데이트

OpenClaw를 최신 상태로 유지하세요.

​
권장: openclaw update

가장 빠른 업데이트 방법입니다. 설치 유형(npm 또는 git)을 감지하고, 최신 버전을 가져오고, openclaw doctor를 실행한 다음 Gateway를 재시작합니다. 
openclaw update
채널을 전환하거나 특정 버전을 대상으로 하려면: 
openclaw update --channel beta
openclaw update --tag main
openclaw update --dry-run   # 적용 없이 미리 보기
--channel beta는 beta를 우선 사용하지만, beta 태그가 없거나 최신 stable 릴리스보다 오래된 경우 런타임은 stable/latest로 대체합니다. 일회성 패키지 업데이트에 원시 npm beta dist-tag를 사용하려면 --tag beta를 사용하세요. 채널 의미는 Development channels를 참조하세요.

​
대안: 설치 프로그램 다시 실행

curl -fsSL https://openclaw.ai/install.sh | bash
온보딩을 건너뛰려면 --no-onboard를 추가하세요. 소스 설치의 경우 --install-method git --no-onboard를 전달하세요.

​
대안: 수동 npm, pnpm 또는 bun

npm i -g openclaw@latest

pnpm add -g openclaw@latest

bun add -g openclaw@latest

​
자동 업데이트 도구

자동 업데이트 도구는 기본적으로 꺼져 있습니다. ~/.openclaw/openclaw.json에서 활성화하세요. 
{
  update: {
    channel: "stable",
    auto: {
      enabled: true,
      stableDelayHours: 6,
      stableJitterHours: 12,
      betaCheckIntervalHours: 1,
    },
  },
}
Channel동작
stablestableDelayHours만큼 기다린 후, stableJitterHours 전반에 걸쳐 결정적 지터와 함께 적용합니다(점진적 롤아웃).
betabetaCheckIntervalHours마다(기본값: 매시간) 확인하고 즉시 적용합니다.
dev자동 적용 없음. openclaw update를 수동으로 사용하세요.
Gateway는 시작 시 업데이트 힌트도 로그에 남깁니다(update.checkOnStart: false로 비활성화).

​
업데이트 후

1
doctor 실행
2
openclaw doctor
3
config를 마이그레이션하고, DM 정책을 감사하며, gateway 상태를 확인합니다. 자세한 내용: Doctor
4
Gateway 재시작
5
openclaw gateway restart
6
확인
7
openclaw health

​
롤백

​
버전 고정(npm)

npm i -g openclaw@<version>
openclaw doctor
openclaw gateway restart
팁: npm view openclaw version은 현재 게시된 버전을 보여줍니다.

​
커밋 고정(소스)

git fetch origin
git checkout "$(git rev-list -n 1 --before=\"2026-01-01\" origin/main)"
pnpm install && pnpm build
openclaw gateway restart
최신으로 돌아가려면: git checkout main && git pull.

​
막혔을 때

​
관련