OpenClaw v2.0 업데이트는 설치 전에 수동으로 확인이 필요합니다.

OpenClaw는 설치 전 수동 조치가 필요한 중대한 주요 변경사항을 포함한 주요 업데이트를 발표했습니다. 이 업데이트에는 12개의 주요 변경사항, 완전히 새로운 플러그인 시스템, 30개 이상의 보안 패치가 포함되어 있습니다.

필수 업데이트 전 확인사항

업데이트하기 전에 사용자는 구성 문제를 피하기 위해 다음 확인사항을 수행해야 합니다:

1단계: 환경 변수 확인

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

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

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

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

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

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

OpenClaw 데이터가 ~/.moltbot 아래에 저장되어 있다면 업데이트 후 감지되지 않습니다. 현재 디렉토리를 확인하세요:

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

확장 프로그램, 릴레이 또는 relayBindHost에 대한 참조가 보이면 새로운 브라우저 제어 시스템을 위해 재구성해야 합니다. 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

기존 스킬이 새로운 시스템과 동기화되도록 보장합니다.