​

업데이트

​

권장: 웹사이트 설치 프로그램 다시 실행하기(제자리 업그레이드)

curl -fsSL https://openclaw.ai/install.sh | bash

• 온보딩 마법사를 다시 실행하고 싶지 않다면 --no-onboard를 추가하세요.
• 소스 설치라면 다음을 사용하세요:
  복사

  AI에게 묻기

  curl -fsSL https://openclaw.ai/install.sh | bash -s -- --install-method git --no-onboard
  
  저장소가 깨끗할 때에만 설치 프로그램이 git pull --rebase를 수행합니다.
• 전역 설치의 경우, 내부적으로 npm install -g openclaw@latest를 사용합니다.
• 레거시 참고: clawdbot은 호환성 셸로 계속 제공됩니다.

​

업데이트 전에

• 설치 방식을 파악하세요: 전역 설치(npm/pnpm)인지 소스 설치(git clone)인지
• Gateway 실행 방식을 파악하세요: 포그라운드 터미널인지 감독 서비스(launchd/systemd)인지
• 사용자 설정을 스냅샷해 두세요:
  • 설정: ~/.openclaw/openclaw.json
  • 자격 증명: ~/.openclaw/credentials/
  • 워크스페이스: ~/.openclaw/workspace

​

업데이트(전역 설치)

npm i -g openclaw@latest

pnpm add -g openclaw@latest

openclaw update --channel beta
openclaw update --channel dev
openclaw update --channel stable

​

코어 자동 업데이터(선택 사항)

{
  "update": {
    "channel": "stable",
    "auto": {
      "enabled": true,
      "stableDelayHours": 6,
      "stableJitterHours": 12,
      "betaCheckIntervalHours": 1
    }
  }
}

• stable: 새 버전이 보이면 stableDelayHours만큼 기다린 뒤, 설치마다 결정론적인 stableJitterHours를 적용해 분산 롤아웃합니다.
• beta: betaCheckIntervalHours 간격(기본: 매시간)으로 확인하고, 업데이트가 있으면 적용합니다.
• dev: 자동 적용 없음. 수동 openclaw update를 사용하세요.

openclaw doctor
openclaw gateway restart
openclaw health

• Gateway가 서비스로 실행 중이면 PID를 죽이는 대신 openclaw gateway restart를 권장합니다.
• 특정 버전에 고정해 두었다면 아래 “롤백 / 고정”을 참고하세요.

​

업데이트 (openclaw update)

openclaw update

• 깨끗한 worktree가 필요함
• 선택한 채널(tag 또는 branch)로 전환
• 설정된 upstream을 기준으로 fetch + rebase(dev 채널)
• 의존성 설치, 빌드, Control UI 빌드, openclaw doctor 실행
• 기본적으로 Gateway 재시작(--no-restart로 생략 가능)

​

업데이트(Control UI / RPC)

1. openclaw update와 같은 소스 업데이트 흐름을 실행합니다(git checkout만 해당).
2. 구조화된 보고서(stdout/stderr tail)가 담긴 restart sentinel을 기록합니다.
3. Gateway를 재시작하고 마지막 활성 세션에 보고서를 ping합니다.

​

업데이트(소스에서)

openclaw update

git pull
pnpm install
pnpm build
pnpm ui:build # auto-installs UI deps on first run
openclaw doctor
openclaw health

• 패키징된 openclaw 바이너리(openclaw.mjs)를 실행하거나 Node로 dist/를 실행할 때는 pnpm build가 중요합니다.
• 전역 설치 없이 저장소 체크아웃에서 실행한다면 CLI 명령은 pnpm openclaw ...를 사용하세요.
• TypeScript에서 직접 실행 중이라면(pnpm openclaw ...) 보통 재빌드는 불필요하지만, 설정 마이그레이션은 여전히 적용되므로 doctor는 실행해야 합니다.
• 전역 설치와 git 설치 사이 전환은 쉽습니다. 다른 쪽을 설치한 뒤 openclaw doctor를 실행하면 게이트웨이 서비스 엔트리포인트가 현재 설치 방식으로 다시 작성됩니다.

​

항상 실행: openclaw doctor

• 더 이상 권장되지 않는 설정 키 / 레거시 설정 파일 위치 마이그레이션
• DM 정책을 감사하고 위험한 “open” 설정 경고
• Gateway 상태 점검 및 필요 시 재시작 제안
• 오래된 게이트웨이 서비스(launchd/systemd, 레거시 schtasks)를 현재 OpenClaw 서비스로 감지 및 마이그레이션
• Linux에서는 systemd user lingering 보장(로그아웃 후에도 Gateway 유지)

​

Gateway 시작 / 중지 / 재시작

openclaw gateway status
openclaw gateway stop
openclaw gateway restart
openclaw gateway --port 18789
openclaw logs --follow

• macOS launchd(앱 번들 LaunchAgent): launchctl kickstart -k gui/$UID/ai.openclaw.gateway (ai.openclaw.<profile> 사용, 레거시 com.openclaw.*도 계속 동작)
• Linux systemd 사용자 서비스: systemctl --user restart openclaw-gateway[-<profile>].service
• Windows (WSL2): systemctl --user restart openclaw-gateway[-<profile>].service
  • launchctl/systemctl은 서비스가 설치되어 있을 때만 동작합니다. 아니면 openclaw gateway install을 실행하세요.

​

롤백 / 고정(문제가 생겼을 때)

​

고정(전역 설치)

npm i -g openclaw@<version>

pnpm add -g openclaw@<version>

openclaw doctor
openclaw gateway restart

​

날짜 기준 고정(소스 설치)

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를 다시 실행하고 출력을 주의 깊게 읽으세요(대개 해결책이 나옵니다).
• 확인: Troubleshooting
• Discord에 문의: https://discord.gg/clawd