OpenClaw 워크스페이스를 git으로 관리해야 하는 이유
OpenClaw 워크스페이스를 git으로 관리하지 않는다면, 언젠가는 후회할 날이 온다.
OpenClaw는 똑똑하다. 하지만 때로는 너무 똑똑해서 문제다. 스스로 설정을 바꾸다가 내가 공들여 설정해둔 것들을 날려버리는 경우가 있다. AGENTS.md에 정성스럽게 작성해둔 가이드라인이 사라지거나, memory 파일이 예상치 못하게 수정되는 일 말이다.
그런 일을 한 번이라도 겪어봤다면, git으로 워크스페이스를 관리하는 게 얼마나 중요한지 알 것이다.
문제: OpenClaw는 스스로 변경한다
OpenClaw는 워크스페이스 파일들을 읽고 쓴다. AGENTS.md, SOUL.md, USER.md, IDENTITY.md, memory/ 디렉토리 등. 이건 OpenClaw의 강력한 기능이다. 에이전트가 스스로 컨텍스트를 관리하고 발전시킬 수 있다는 건 매력적이다.
하지만 문제는, 언제 무엇이 바뀌었는지 추적하기 어렵다는 것이다. 며칠 전에는 분명히 있었던 설정이 어느새 사라져 있거나, memory 파일에 예상치 못한 내용이 추가되어 있을 때가 있다.
"어? 이거 내가 설정한 거였나? OpenClaw가 바꾼 거였나?"
이런 혼란이 반복되면 워크스페이스를 신뢰하기 어려워진다.
해결책: git으로 모든 것을 추적하라
git으로 워크스페이스를 관리하면 세 가지 문제가 한 번에 해결된다.
1. 변경 사항 추적
git diff로 무엇이 바뀌었는지 한눈에 볼 수 있다. OpenClaw가 AGENTS.md를 수정했다면, 어떤 부분이 바뀌었는지 정확히 확인할 수 있다.
git diff AGENTS.md
memory 디렉토리에 새로운 파일이 추가되었다면?
git status
한 줄이면 알 수 있다.
2. 복구 가능성
OpenClaw가 실수로 중요한 설정을 날려버렸다면? 걱정 없다.
git checkout AGENTS.md
혹은 특정 시점으로 돌아가고 싶다면:
git log
git checkout <commit-hash> -- AGENTS.md
git이 있다면 어떤 변경도 두렵지 않다. 언제든 되돌릴 수 있으니까.
3. 여러 환경 동기화
OpenClaw를 여러 기기에서 사용한다면? git으로 워크스페이스를 동기화하면 된다.
회사 맥북에서 설정한 워크스페이스를, 집 데스크탑에서도 그대로 쓸 수 있다. 설정을 일일이 다시 하지 않아도 된다.
git pull
끝이다.
어떤 파일들을 관리해야 하나
워크스페이스의 모든 파일을 git으로 관리하면 된다.
AGENTS.md- 에이전트 가이드라인SOUL.md- 에이전트 페르소나USER.md- 사용자 정보IDENTITY.md- 에이전트 정체성TOOLS.md- 로컬 도구 설정HEARTBEAT.md- 주기적 체크리스트memory/- 모든 메모리 파일
그 외에도 워크스페이스에 추가한 모든 파일을 포함시키면 된다.
민감 정보는 어떻게 하나
원칙적으로는 API 토큰, 비밀번호 같은 민감 정보는 .gitignore에 추가해서 제외해야 한다.
하지만 현실적으로, private repo를 신뢰하기로 결정할 수도 있다. 편의성과 보안 사이의 균형을 고려해서 판단하면 된다.
내 경우는 private repo에 모든 워크스페이스 파일을 포함시키기로 했다. 어차피 혼자 쓰는 repo고, GitHub의 보안을 신뢰한다. 토큰이 유출되는 것보다, 설정이 날아가서 복구 못 하는 게 더 큰 문제라고 판단했다.
물론 이건 개인의 선택이다. 더 보수적으로 접근하고 싶다면:
- 민감 정보는 환경 변수로 분리
.env파일은.gitignore에 추가.env.example파일만 커밋해서 구조만 공유
이런 방식도 좋다.
실전 워크플로우
내가 사용하는 방식은 간단하다.
초기 설정
cd ~/.openclaw/workspaces/my-workspace
git init
git add .
git commit -m "Initial workspace setup"
git remote add origin git@github.com:username/openclaw-workspace.git
git push -u origin main
일상적인 사용
작업하다가 중요한 변경이 생기면:
git add .
git commit -m "Update AGENTS.md with new guidelines"
git push
OpenClaw가 뭔가 이상하게 바꿨다 싶으면:
git diff
확인하고, 필요하면:
git checkout -- <파일명>
다른 기기에서
git clone git@github.com:username/openclaw-workspace.git ~/.openclaw/workspaces/my-workspace
혹은 기존 워크스페이스를 업데이트:
git pull
결론
OpenClaw 워크스페이스를 git으로 관리하는 건 선택이 아니라 필수다.
변경 사항을 추적하고, 언제든 복구할 수 있으며, 여러 환경에서 동기화할 수 있다. OpenClaw가 스스로 설정을 바꾸더라도 전혀 두렵지 않다. git이 모든 걸 기록하고 있으니까.
한 번 설정해두면 신경 쓸 일도 없다. 그냥 평소처럼 OpenClaw를 사용하면 된다. 문제가 생기면 그때 git으로 확인하고 복구하면 그만이다.
아직 워크스페이스를 git으로 관리하지 않고 있다면, 지금 당장 하는 게 좋다. 설정이 날아가는 경험을 한 번 해보기 전에 말이다.