서버 상태 먼저 확인
에이전트를 만들기 전에 현재 OpenClaw 설치 상태를 확인합니다.
openclaw --version 으로 버전을 확인하고, node --version 으로 Node.js 버전을 확인합니다. OpenClaw는 Node.js 22 이상을 권장합니다. ls -la ~/.openclaw/ 로 현재 디렉터리 구조를 확인합니다.
이 세 가지 확인이 중요한 이유가 있습니다. 이후 단계에서 문제가 생겼을 때 환경 차이에서 오는 것인지, 설정 문제인지를 빠르게 구분할 수 있습니다.
Doctor 수리 먼저
openclaw doctor --repair 를 실행합니다. 이 명령은 설정 파일의 기본적인 문제들을 자동으로 고쳐줍니다. credentials 폴더 생성, PATH 설정 등 초기 설치 후 남은 설정 문제들을 정리해 줍니다.
에이전트 생성
에이전트를 만들 때 워크스페이스 경로를 함께 지정합니다.
openclaw agents add chaeunbyul --workspace ~/.openclaw/workspace-chaeunbyul
에이전트 이름을 workspace 이름과 일치시키는 것이 중요합니다. 나중에 에이전트가 늘어났을 때 workspace-chaeunbyul, workspace-도윤 처럼 폴더만 봐도 어느 에이전트 것인지 바로 알 수 있습니다. 처음부터 이 규칙을 잡아두지 않으면 나중에 정리하기 어렵습니다.
workspace를 별도로 지정하지 않으면 모든 에이전트가 default workspace를 공유합니다. 에이전트가 많아지면 파일이 섞이고 메모리 충돌이 생깁니다.
생성 확인
openclaw agents list 로 생성된 에이전트를 확인합니다.
정상적으로 생성됐다면 main(default)과 chaeunbyul 두 에이전트가 보입니다. 각각 별도의 workspace 경로와 agent dir을 갖고 있습니다.
워크스페이스 파일 구성 준비
에이전트 디렉터리가 만들어졌으면 SOUL.md, IDENTITY.md, USER.md, AGENTS.md 등 봇의 성격과 역할을 정의하는 문서들을 작성할 준비가 됩니다.
이 파일들은 봇이 매 응답마다 참조하는 시스템 컨텍스트입니다. SOUL.md는 100줄 이내로 유지하는 것이 좋습니다. SOUL.md는 매 대화에서 참조될 수 있어 너무 길면 토큰 낭비로 이어질 수 있습니다.
파일 구성은 다음 단계에서 함께 다룹니다.
