OpenClaw v2.0 업데이트: 호환성 손상을 방지하기 위한 필수 사전 업데이트 체크리스트

OpenClaw 주요 업데이트는 업데이트 전 준비가 필요합니다

OpenClaw는 12개의 주요 변경 사항, 완전히 새로운 플러그인 시스템, 그리고 30개 이상의 보안 패치와 함께 몇 달 만에 가장 큰 업데이트를 출시했습니다. 사용자가 먼저 준비 없이 npm update를 실행하면 업데이트가 자동으로 설정을 손상시킬 것입니다.

1단계: 환경 변수 확인

OpenClaw가 Clawdbot이나 Moltbot으로 불리던 시절의 레거시 환경 변수는 더 이상 작동하지 않습니다. 호환성 셰이머, 폴백, 또는 경고가 없습니다. 오래된 변수를 확인하세요:

env | grep -i clawdbot
env | grep -i moltbot

무언가 나타나면 이름을 변경하세요:

• CLAWDBOT_* → OPENCLAW_*
• MOLTBOT_* → OPENCLAW_*

.env, .bashrc, .zshrc, .profile, 그리고 모든 docker-compose 파일을 확인하세요. 누락된 변수는 OpenClaw가 사용자 설정 대신 기본 설정으로 시작하게 할 것입니다.

2단계: 상태 디렉토리 확인

이전 디렉토리 이름에 대한 자동 감지 기능이 사라졌습니다. 현재 상태 디렉토리를 확인하세요:

ls ~/.moltbot 2>/dev/null && echo "YOU NEED TO MOVE THIS"
ls ~/.openclaw 2>/dev/null && echo "you're fine"

여전히 ~/.moltbot을 사용 중이라면 업데이트 전에 이동하세요:

mv ~/.moltbot ~/.openclaw

또는 경로를 명시적으로 설정하세요:

export OPENCLAW_STATE_DIR=~/.openclaw

먼저 업데이트하면 OpenClaw는 빈 설정으로 새로운 ~/.openclaw 디렉토리를 생성할 것입니다.

3단계: 설정 백업

업데이트 전에 백업을 생성하세요:

cp -r ~/.openclaw ~/.openclaw-backup-$(date +%Y%m%d)

여기에는 SOUL.md, USER.md, MEMORY.md, 에이전트 설정, 스킬 및 기타 모든 것이 포함됩니다.

4단계: 브라우저 자동화 설정 확인

레거시 크롬 확장 프로그램 릴레이는 완전히 제거되었습니다. 브라우저 설정이 driver: "extension"이나 browser.relayBindHost를 사용한다면, 이제 해당 설정은 아무런 효과가 없습니다. 설정을 확인하세요:

openclaw config get | grep -i browser

새로운 접근 방식은 기존 세션 브라우저 연결을 사용합니다. OpenClaw는 확장 프로그램을 통해 브라우저를 제어하는 대신 이미 실행 중인 브라우저에 연결합니다. OpenClaw는 이제 자체 브라우저 프로필(openclaw 프로필)을 관리하거나 CDP를 통해 기존 크롬 세션에 연결합니다.

5단계: Clawhub 변경 사항 이해

Clawhub는 이제 기본 플러그인 및 스킬 스토어입니다. openclaw plugins install이나 openclaw skills install을 실행하면 먼저 Clawhub를 확인하고 패키지를 찾을 수 없는 경우에만 npm으로 폴백합니다. 이는 다음을 의미합니다:

• npm을 통해 설치된 일부 스킬은 Clawhub를 통해 재설치해야 할 수 있습니다
• openclaw skills search, openclaw skills install, 그리고 openclaw skills update는 ClawHub를 기본적으로 사용하는 새로운 명령어입니다
• 스킬이 Clawhub에 없다면 여전히 npm에서 설치할 수 있습니다(제거가 아닌 폴백입니다)

업데이트 후 다음을 실행하세요:

openclaw skills update

기존 스킬이 새로운 시스템과 동기화되었는지 확인하세요.