OpenClaw v2.0 업데이트 전 확인해야 할 3가지 설정

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

필수 업데이트 전 확인사항

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

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

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

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

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

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 디렉토리를 생성하여 모든 데이터가 손실된 것처럼 보이게 할 것입니다.

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

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

이렇게 하면 SOUL.md, USER.md, MEMORY.md, 에이전트 구성, 스킬 및 기타 모든 것이 백업됩니다.

레거시 크롬 확장 프로그램 릴레이는 완전히 제거되었습니다. 브라우저 구성이 driver: "extension" 또는 browser.relayBindHost를 사용한다면 해당 설정은 더 이상 작동하지 않습니다. 구성을 확인하세요:

openclaw config get | grep -i browser

확장 프로그램, 릴레이 또는 relayBindHost에 대한 참조가 보이면 새로운 브라우저 제어 시스템을 위해 재구성해야 합니다. OpenClaw는 이제 자체 브라우저 프로필(openclaw 프로필)을 관리하거나 CDP를 통해 기존 크롬 세션에 연결합니다.

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

이것은 다음을 의미합니다:

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

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