OpenClaw Personal Assistant 설정 가이드

매일 수많은 코드를 짜고 문서를 읽다 보면, 어제 내가 어떤 결정을 내렸는지 혹은 특정 프로젝트의 맥락이 무엇이었는지 잊어버릴 때가 많아요. 여러 도구에 파편화된 정보를 일일이 기억하고 정리하는 일은 개발자에게 꽤나 피로한 작업이죠.

이런 맥락의 단절을 해결하고 나만의 작업 흐름을 기억해 주는 비서가 있다면 업무 효율이 훨씬 좋아질 거예요. OpenClaw를 사용해 이 과정을 어떻게 자동화하고 관리할 수 있는지 알려드릴게요.

필요한 것

시작하기 전에 다음 항목들이 준비되어 있는지 확인해 주세요.

• OpenClaw macOS 앱 (권한 관리 및 openclaw CLI 포함)
• 작업 공간 디렉토리 (기본값: ~/.openclaw/workspace)
• 기본 템플릿 파일들 (AGENTS.md, SOUL.md, TOOLS.md)

빠른 시작

5분 안에 나만의 비서 작업 공간을 설정하는 방법이에요.

1. 작업 공간 디렉토리 생성 터미널에서 비서가 사용할 디렉토리를 만듭니다.

   mkdir -p ~/.openclaw/workspace

2. 기본 템플릿 복사 제공된 템플릿 파일들을 작업 공간으로 가져옵니다.

   cp docs/reference/templates/AGENTS.md ~/.openclaw/workspace/AGENTS.md
   cp docs/reference/templates/SOUL.md ~/.openclaw/workspace/SOUL.md
   cp docs/reference/templates/TOOLS.md ~/.openclaw/workspace/TOOLS.md

3. 개인 비서 Skill 설정 (선택 사항) 개인 비서 전용 Skill 목록을 사용하고 싶다면 아래 명령어를 실행하세요.

   cp docs/reference/AGENTS.default.md ~/.openclaw/workspace/AGENTS.md

4. 작업 공간 경로 변경 (선택 사항) 기본 경로 외에 다른 곳을 쓰고 싶다면 json5 설정 파일에서 수정할 수 있습니다.

   {
     agents: { defaults: { workspace: "~/.openclaw/workspace" } },
   }

5. Git을 이용한 백업 (추천) 비서의 메모와 설정을 안전하게 보관하기 위해 Git 저장소로 관리하는 것이 좋습니다.

   cd ~/.openclaw/workspace
   git init
   git add AGENTS.md
   git commit -m "Add Clawd workspace"

Core Skills & Usage

OpenClaw는 다양한 Skill을 통해 기능을 확장할 수 있습니다. 설정의 Settings → Skills 탭에서 필요한 기능을 활성화해 보세요.

• oracle: OpenAI 기반 Agent CLI로 세션 재생과 브라우저 제어가 가능해요.
• Peekaboo: macOS 스크린샷을 찍고 AI Vision으로 분석합니다.
• imsg & wacli: iMessage와 WhatsApp 메시지를 읽고 보낼 수 있어요.
• gog: Google Calendar, Gmail, Drive를 제어합니다.
• spotify-player: 터미널에서 음악을 검색하고 재생합니다.
• browser 제어: openclaw browser click|type|run 등의 명령어로 브라우저와 상호작용할 수 있어요.

모든 세션이 시작될 때 비서는 SOUL.md, USER.md, memory.md 파일을 먼저 읽고 응답합니다. 비서의 정체성이나 고유한 톤은 SOUL.md에 정의해 두면 돼요.

문제 해결

문제가 발생하면 다음 사항을 확인해 보세요.

• Canvas UI 레이아웃 문제: 중요한 컨트롤을 화면의 모서리(상단 좌우, 하단)에 배치하지 마세요. Safe-area 인셋을 믿기보다 명시적인 거터(gutter)를 레이아웃에 추가하는 것이 안전합니다.
• 백그라운드 작업 실패: 리마인더 예약이나 카메라 캡처 같은 기능이 작동하지 않는다면 Heartbeats 설정이 켜져 있는지 확인해 주세요.
• 명령어 실행 오류: 브라우저 상호작용 시 click이나 type 명령은 반드시 snapshot 참조가 필요합니다. CSS 선택자를 쓸 때는 evaluate 명령을 사용하세요.

AI Setup Assistant

다음 단계

• SOUL.md로 비서의 성격 정의하기
• memory/ 디렉토리를 활용한 일일 로그 관리
• TOOLS.md에 환경별 Skill 노트 작성하기
• openclaw CLI를 활용한 스크립트 자동화