메인 콘텐츠로 건너뛰기

​
업데이트

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/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,
    },
  },
}
채널동작
stablestableDelayHours만큼 기다린 뒤, stableJitterHours 전체에 걸쳐 결정론적 지터를 적용해 배포를 분산하며 적용합니다.
betabetaCheckIntervalHours마다(기본값: 1시간) 확인하고 즉시 적용합니다.
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.

​
문제가 해결되지 않을 때

  • openclaw doctor를 다시 실행하고 출력을 주의 깊게 읽으세요.
  • 소스 체크아웃에서 openclaw update --channel dev를 실행할 때, 업데이터는 필요하면 자동으로 pnpm을 부트스트랩합니다. pnpm/corepack 부트스트랩 오류가 보이면 pnpm을 수동으로 설치하거나(corepack을 다시 활성화한 뒤) 업데이트를 다시 실행하세요.
  • 확인: Troubleshooting
  • Discord에서 문의: https://discord.gg/clawd

​
관련 문서