오픈클로 2.0 이해하기: 공유 세션과 업데이트 전 확인

오픈클로(OpenClaw)는 AI가 파일, 웹, 메신저 같은 도구를 사용해 작업하도록 연결하는 프로그램입니다. 질문에 답만 하는 챗봇과 달리, 허용한 도구로 파일 수정이나 메시지 전송까지 할 수 있습니다. 어떤 모델을 연결했는지뿐 아니라 무엇을 허용했는지가 결과에 영향을 줍니다.

오픈클로 2.0은 2026년 8월 30일 발표한 v2026.8.1의 별칭입니다. 설치 과정을 줄이고 브라우저 화면과 팀 협업을 크게 바꾼 버전입니다. 이 글은 당시 변경을 설명하되, 업데이트와 복구 안내는 2026년 10월 4일 확인한 현재 문서를 따릅니다. 2.0이라는 이름을 보고 지금도 그 버전이 최신이라고 판단하지 않습니다. 출시 발표, 릴리스 노트

화면의 Local은 실행 위치, workspace는 작업 폴더를 가리킵니다. 대화를 보내기 전에 내가 의도한 컴퓨터와 폴더인지 봅니다. 그림에 보이는 Full access도 내 설치의 권한 상태가 같다는 뜻은 아닙니다.

먼저 알아둘 세 가지 용어

상태 디렉터리는 설정과 대화 기록 등 프로그램 운영 자료가 저장된 폴더입니다. 작업 폴더의 문서만 복사해 두었다고 상태까지 백업한 것은 아닙니다.

2.0에서 작업 방식이 어떻게 달라졌는지

스킬은 AI가 특정 일을 수행할 때 참고하는 지침과 도구 사용 절차입니다. 만들기와 검증 및 설치 경로가 정리됐다고 모든 스킬을 검토 없이 실행해도 되는 것은 아닙니다. 기억 기능도 과거 내용을 항상 정확히 가져온다는 보장은 아닙니다. 변경 항목별 릴리스 안내

출시 블로그는 기여자 933명과 변경 요청 1만 6,000건 이상을 소개했습니다. 현재 릴리스 페이지는 기여자 987명, 변경 요청 16,977건을 표시하므로 숫자를 섞어 한 시점의 통계로 쓰지 않습니다. 변경 요청은 개발자가 제안한 코드 수정 묶음으로, 수가 많다는 것만으로 내 환경의 안정성이 입증되지는 않습니다.

공유 세션: 작업을 이어받되 접근 범위를 구분하기

예를 들어 동료가 행사 안내 초안을 만들다가 담당자를 바꾸면, 새 담당자는 대화의 요청과 수정 내역을 보며 이어갈 수 있습니다. 공유 전에 개인 자료나 다른 고객 정보가 같은 대화에 섞이지 않았는지 확인해야 합니다.

이 화면은 사용자가 만든 대시보드 예시입니다. 설치하면 모든 계정에 같은 화면과 작업 항목이 생긴다는 뜻은 아닙니다.

공유 모드의 소유자와 참여자 표시는 담당과 기록을 관리하는 기능입니다. 서로 신뢰하지 않는 사람들의 파일, 인증정보, 도구 사용을 완전히 분리하는 장치로 보면 안 됩니다. 공식 보안 문서는 그런 경우 게이트웨이와 인증정보를 분리하고, 가능하면 운영체제 사용자나 기기도 나누도록 안내합니다. 다중 사용자 모드, 신뢰 범위

읽기 전용과 제안 같은 로그인 이용자의 협업 설정은 공개 링크와도 다릅니다. 현재 문서의 Public access를 별도로 켜면 링크를 가진 사람이 로그인 없이 이후 대화 내용까지 볼 수 있습니다. 단순 인수인계 목적이라면 이 공개 기능을 켤 필요가 있는지부터 구분합니다. 공개 세션 링크의 범위

첫 연습: 업데이트하지 않고 현재 상태 기록하기

이미 설치한 분은 오픈클로가 실행되는 컴퓨터에서, 평소 설치를 관리하는 계정으로 터미널을 엽니다. 터미널은 명령을 입력하는 앱입니다. 오픈클로 채팅에 명령을 보내는 것과 다릅니다. 프로필은 설정과 상태를 나누어 사용하는 구성 이름입니다. 별도 프로필을 쓰는 환경은 아래 명령에도 평소의 프로필 선택을 유지합니다. Mac은 터미널 앱을 열고, Windows는 설치에 사용했던 PowerShell 또는 WSL 터미널을 엽니다. WSL은 Windows 안의 Linux 환경이며, WSL에 설치했다면 PowerShell의 다른 설치와 섞지 않습니다.

다음 명령을 한 줄씩 실행해 출력 내용을 읽습니다.

--version은 현재 버전, update status는 업데이트 상태, --dry-run은 적용 전 예상 동작 확인입니다. 마지막 명령에서 --dry-run을 빼면 실제 업데이트 요청이 됩니다. 지금은 버전과 설치 방식, 대상 버전, 경고 유무만 메모합니다. 네 항목을 적고 경고가 무엇인지 설명할 수 있으면 이 연습은 끝입니다. 대상 버전을 조회하지 못했다면 그 항목은 미확인으로 남깁니다. 현재 업데이트 안내

플러그인은 메신저 연결처럼 기능을 추가하는 구성 요소입니다. 설치하지 않은 분은 아래 가상 상황으로 연습합니다.

현재 버전은 A이고, 목표 버전은 B입니다. 데이터 형식이 바뀐다는 안내가 있습니다. 백업 파일은 있지만 검증 결과는 없습니다. 평소 쓰는 플러그인 하나는 B에서 지원되는지 모릅니다.

이때 답은 “바로 업데이트”가 아닙니다. 백업을 검증하고 플러그인 호환성을 확인해야 합니다. 이어서 “백업 검증 성공, 플러그인 B 지원 확인, 복구에 쓸 A 버전과 경로 기록 완료”로 조건을 바꿔 봅니다. 사전 확인이 끝났더라도 업데이트 후 기존 대화와 작업을 다시 확인해야 완료입니다.

명령을 찾을 수 없다는 오류가 나면 설치 방식과 실행 컴퓨터부터 확인합니다. 이 오류를 없애려고 다른 설치 명령으로 중복 설치하지 않습니다. 앱이 관리하는 설치와 컨테이너 설치는 각자의 업데이트 방법이 있으므로 일반 명령이 안내만 출력할 수도 있습니다.

백업: 파일이 생겼다는 것과 복구 가능하다는 것 구분하기

현재 백업 기능은 상태, 설정, 인증정보, 세션과 선택적으로 작업 폴더를 묶습니다. 해당 명령을 지원하는 버전이라면 백업 생성과 검증을 함께 요청할 수 있습니다.

이 명령은 실제 백업 파일을 만듭니다. 기본 위치는 명령을 실행한 폴더이며, 백업 대상 폴더 안이라면 홈 폴더를 사용하므로 출력된 경로를 확인합니다. 저장 위치와 검증 결과를 기록하고, 검증 실패가 표시되면 업데이트를 진행하지 말고 첫 오류부터 해결합니다. 백업에는 인증정보가 포함될 수 있으므로 공유 폴더나 공개 저장소에 올리지 않습니다. --only-config는 설정 파일만 내보내는 옵션이어서 전체 상태 백업을 대신하지 못합니다. 백업 명령과 포함 범위

백업 완료 기준은 검증 성공과 필요한 자료의 포함 여부를 확인한 것입니다. 프로그램 설치 파일 자체는 백업에 포함되지 않으므로 함께 쓸 프로그램 버전도 적어 둡니다. 실행 중인 SQLite 파일 하나만 따로 복사하면 아직 다른 기록 파일에 남은 변경을 놓칠 수 있습니다. 전체 상태 복구 조건

옛 버전에서 백업 명령을 지원하지 않으면 명령을 만들겠다고 먼저 업데이트하지 않습니다. 현재 데이터와 설정을 보존할 수 있는 해당 설치의 백업 방법을 관리자와 확인합니다. 복원 연습은 빈 별도 폴더에서 진행하고, 운영 중인 상태에 덮어쓰는 작업과 구분합니다.

업데이트 실행과 복구 명령을 구분하기

Doctor는 설치 상태를 점검하고 복구하는 도구입니다. 옵션 없는 doctor나 --non-interactive를 읽기 전용이라고 생각하면 안 됩니다. 실제 수정 없이 검사하려면 지원 버전의 --lint를 사용합니다. 오류가 있다고 --force까지 붙여 실행하지 말고 백업과 오류 원인을 먼저 확인합니다. Doctor 실행 모드

수동 복구를 안내받으면 게이트웨이가 자기 자신을 수정하는 채팅 실행창 대신 게이트웨이 밖에서 연 터미널을 사용합니다. 원격 접속이라는 이유만으로 불가능한 것은 아닙니다. 핵심은 실행 주체, 설치 계정, 프로필과 상태 경로를 유지하는 것입니다. 2026년 7월 이전의 아주 오래된 설치에는 중간 버전을 거치는 안내도 있으므로 단순히 옛 글의 설치 명령을 복사하지 않습니다. 설치 방식과 버전별 갱신 절차

업데이트 후에는 아래 네 가지를 비교합니다.

1. 실제 실행 중인 버전이 목표 버전인지 확인합니다.
2. 기존 대화 한 개를 열어 최근 메시지와 첨부 기록이 보이는지 봅니다.
3. 자주 쓰는 플러그인과 연결 상태를 확인합니다.
4. 가상 메모 한 개로 평소 작업을 재시험하고, 의도하지 않은 파일 수정이나 전송이 없는지 봅니다.

화면만 열렸다고 모든 데이터 이전이 성공한 것으로 보지 않습니다. 문제가 생기면 첫 오류 메시지와 업데이트 보고서를 남기고 현재 상태 및 백업을 보존합니다. 프로그램 버전만 낮춰도 이미 바뀐 데이터 형식이 돌아가지는 않습니다. 복구용 자료를 정리하는 cleanup도 정상 작동과 기록을 확인한 뒤에 합니다. 롤백과 복구

보안 설정은 항목별로 확인하기

현재 일반 설치는 게이트웨이의 접속 주소를 같은 컴퓨터 안에서만 접근하는 loopback으로 제한하고, 대부분의 메신저는 모르는 발신자에게 연결 확인을 요구합니다. 컨테이너와 일부 채널은 기본값이 다릅니다. “보안이 모두 기본으로 꺼져 있다”는 설명은 맞지 않습니다. 현재 보안 기본값

샌드박스는 도구를 제한된 별도 실행 환경 안에서 돌리는 기능입니다. 에이전트 전체의 샌드박스 모드는 기본값이 off이지만, 역할이 샌드박스를 필수로 요구하는 세션에는 적용될 수 있습니다. 접속 인증, 파일 접근 범위, 실행 승인, 샌드박스는 각각 확인해야 합니다. 샌드박스 모드

처음 업무를 연결할 때는 “메모를 읽고 답하기”와 “파일을 고치고 외부로 보내기”를 따로 시험합니다. 모델을 바꾸는 것만으로 권한 문제가 해결되지는 않습니다. 메일이나 웹페이지의 문장이 AI에게 엉뚱한 도구 실행을 유도하는 문제와 권한 점검은 오픈클로 설치 전 확인할 위험에서 이어 볼 수 있습니다.

3줄 요약

1. 오픈클로 2.0은 v2026.8.1의 별칭으로, 브라우저 작업 화면과 공유 세션 및 SQLite 기반 저장을 도입한 큰 업데이트입니다.

2. 공유 세션은 팀이 작업을 이어받는 데 쓰지만 역할 표시만으로 다른 사람의 도구와 파일을 완전히 격리하지는 않습니다.

3. 업데이트 전에는 설치 방식과 버전을 기록하고 백업을 검증하며, 문제가 생기면 이전된 데이터와 호환되는 복구 방법을 선택합니다.