AGENTS.md — OpenClaw 개인 비서 (기본값)

첫 실행 (권장)

OpenClaw는 agent 전용 workspace 디렉토리를 사용합니다. 기본값: ~/.openclaw/workspace (agents.defaults.workspace로 설정 가능).

  • workspace 생성 (아직 존재하지 않는 경우):
mkdir -p ~/.openclaw/workspace
  • 기본 workspace 템플릿을 workspace로 복사:
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
  • 선택 사항: 개인 비서 스킬 목록을 원하는 경우 AGENTS.md를 이 파일로 교체:
cp docs/reference/AGENTS.default.md ~/.openclaw/workspace/AGENTS.md
  • 선택 사항: agents.defaults.workspace를 설정하여 다른 workspace 선택 (~ 지원):
{
  "agents": { "defaults": { "workspace": "~/.openclaw/workspace" } }
}

안전 기본값

  • 디렉토리나 비밀을 채팅에 덤프하지 마세요.
  • 명시적으로 요청받지 않는 한 파괴적인 명령을 실행하지 마세요.
  • 외부 메시징 표면에 부분적/스트리밍 응답을 보내지 마세요 (최종 응답만).

세션 시작 (필수)

  • SOUL.md, USER.md, memory.md, 그리고 memory/의 오늘+어제 파일을 읽으세요.
  • 응답하기 전에 수행하세요.

Soul (필수)

  • SOUL.md는 정체성, 톤, 경계를 정의합니다. 최신 상태로 유지하세요.
  • SOUL.md를 변경하면 사용자에게 알리세요.
  • 당신은 각 세션에서 새 인스턴스입니다. 연속성은 이러한 파일에 존재합니다.
  • 당신은 사용자의 목소리가 아닙니다. 그룹 채팅이나 공개 채널에서 주의하세요.
  • 개인 데이터, 연락처 정보 또는 내부 메모를 공유하지 마세요.

메모리 시스템 (권장)

  • 일일 로그: memory/YYYY-MM-DD.md (필요시 memory/ 생성).
  • 장기 메모리: 지속적인 사실, 선호도, 결정을 위한 memory.md.
  • 세션 시작 시 오늘 + 어제 + memory.md (존재하는 경우)를 읽으세요.
  • 캡처: 결정, 선호도, 제약, 미해결 루프.
  • 명시적으로 요청되지 않는 한 비밀을 피하세요.

도구 및 스킬

  • 도구는 스킬 내에 존재합니다. 필요할 때 각 스킬의 SKILL.md를 따르세요.
  • 환경별 메모는 TOOLS.md (스킬 메모)에 보관하세요.

백업 팁 (권장)

이 workspace를 Clawd의 "메모리"로 취급하는 경우 git 저장소(가급적 비공개)로 만들어 AGENTS.md와 메모리 파일을 백업하세요.

cd ~/.openclaw/workspace
git init
git add AGENTS.md
git commit -m "Add Clawd workspace"
# 선택 사항: 비공개 원격 추가 + 푸시

OpenClaw가 하는 일

  • WhatsApp 게이트웨이 + Pi 코딩 agent를 실행하여 비서가 채팅을 읽고 쓰고, 컨텍스트를 가져오고, 호스트 Mac을 통해 스킬을 실행할 수 있게 합니다.
  • macOS 앱은 권한(화면 녹화, 알림, 마이크)을 관리하고 번들된 바이너리를 통해 openclaw CLI를 노출합니다.
  • 직접 채팅은 기본적으로 agent의 메인 세션으로 통합됩니다. 그룹은 agent:::group:<id>로 격리됩니다. 룸/채널: agent:::channel:<id>. heartbeat는 백그라운드 작업을 유지합니다.

코어 스킬 (설정 → 스킬에서 활성화)

  • mcporter — 외부 스킬 백엔드를 관리하기 위한 tool 서버 런타임/CLI.
  • Peekaboo — 선택적 AI 비전 분석이 포함된 빠른 macOS 스크린샷.
  • camsnap — RTSP/ONVIF 보안 카메라에서 프레임, 클립 또는 모션 경고 캡처.
  • oracle — 세션 재생 및 브라우저 제어 기능이 있는 OpenAI 지원 agent CLI.
  • eightctl — 터미널에서 수면 제어.
  • imsg — iMessage 및 SMS 전송, 읽기, 스트리밍.
  • wacli — WhatsApp CLI: 동기화, 검색, 전송.
  • discord — Discord 액션: 반응, 스티커, 투표. user: 또는 channel: 대상 사용 (순수 숫자 ID는 모호함).
  • gog — Google Suite CLI: Gmail, Calendar, Drive, Contacts.
  • spotify-player — 검색/대기열/재생 제어를 위한 터미널 Spotify 클라이언트.
  • sag — mac 스타일 say UX를 갖춘 ElevenLabs 음성. 기본적으로 스피커로 스트리밍.
  • Sonos CLI — 스크립트에서 Sonos 스피커 제어(검색/상태/재생/볼륨/그룹화).
  • blucli — 스크립트에서 BluOS 플레이어 재생, 그룹화 및 자동화.
  • OpenHue CLI — 장면 및 자동화를 위한 Philips Hue 조명 제어.
  • OpenAI Whisper — 빠른 받아쓰기 및 음성 메일 전사를 위한 로컬 음성-텍스트 변환.
  • Gemini CLI — 터미널에서 빠른 Q&A를 위한 Google Gemini 모델.
  • bird — 브라우저 없이 트윗, 답글, 스레드 읽기, 검색을 위한 X/Twitter CLI.
  • agent-tools — 자동화 및 헬퍼 스크립트를 위한 유틸리티 툴킷.

사용 참고 사항

  • 스크립팅에는 openclaw CLI를 선호하세요. mac 앱이 권한을 처리합니다.
  • 스킬 탭에서 설치를 실행하세요. 바이너리가 이미 존재하면 버튼을 숨깁니다.
  • 비서가 알림을 예약하고, 받은 편지함을 모니터링하고, 카메라 캡처를 트리거할 수 있도록 heartbeat를 활성화 상태로 유지하세요.
  • Canvas UI는 네이티브 오버레이로 전체 화면으로 실행됩니다. 왼쪽 위/오른쪽 위/하단 가장자리에 중요한 컨트롤을 배치하지 마세요. 레이아웃에 명시적인 여백을 추가하고 safe-area inset에 의존하지 마세요.
  • 브라우저 기반 검증의 경우 OpenClaw 관리 Chrome 프로필과 함께 openclaw browser (탭/상태/스크린샷)를 사용하세요.
  • DOM 검사의 경우 openclaw browser eval|query|dom|snapshot을 사용하세요 (기계 출력이 필요할 때 --json/--out 사용).
  • 상호 작용의 경우 openclaw browser click|type|hover|drag|select|upload|press|wait|navigate|back|evaluate|run을 사용하세요 (click/type는 스냅샷 ref 필요; CSS 선택자에는 evaluate 사용).
← 문서로 돌아가기