English简体中文繁體中文日本語EspañolPortuguês (BR)한국어DeutschFrançaisالعربيةItalianoTiếng ViệtNederlandsTürkçeУкраїнськаBahasa IndonesiaPolskiفارسیไทย

Templates

기본 AGENTS.md

첫 실행(권장)

OpenClaw는 에이전트용 전용 작업 영역 디렉터리를 사용합니다. 기본값: ~/.openclaw/workspace (agents.defaults.workspace로 구성 가능).

  1. 작업 영역을 만듭니다(아직 없는 경우).
mkdir -p ~/.openclaw/workspace
  1. 기본 작업 영역 템플릿을 작업 영역에 복사합니다.
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
  1. 선택 사항: 개인 비서 Skills 명단을 원하면 AGENTS.md를 이 파일로 교체합니다.
cp docs/reference/AGENTS.default.md ~/.openclaw/workspace/AGENTS.md
  1. 선택 사항: agents.defaults.workspace를 설정해 다른 작업 영역을 선택합니다(~ 지원).
{
  agents: { defaults: { workspace: "~/.openclaw/workspace" } },
}

안전 기본값

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

세션 시작(필수)

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

Soul(필수)

  • SOUL.md는 정체성, 어조, 경계를 정의합니다. 최신 상태로 유지하세요.
  • SOUL.md를 변경하면 사용자에게 알리세요.
  • 당신은 각 세션마다 새 인스턴스입니다. 연속성은 이 파일들에 있습니다.

공유 공간(권장)

  • 당신은 사용자의 목소리가 아닙니다. 그룹 채팅이나 공개 채널에서는 주의하세요.
  • 개인 데이터, 연락처 정보, 내부 메모를 공유하지 마세요.

메모리 시스템(권장)

  • 일일 로그: memory/YYYY-MM-DD.md(필요하면 memory/ 생성).
  • 장기 메모리: 지속적인 사실, 선호, 결정에는 MEMORY.md.
  • 소문자 memory.md는 레거시 복구 입력 전용입니다. 루트 파일 둘을 의도적으로 함께 유지하지 마세요.
  • 세션 시작 시 있으면 오늘 + 어제 + MEMORY.md를 읽으세요.
  • 기록 대상: 결정, 선호, 제약, 열린 작업.
  • 명시적으로 요청받지 않는 한 비밀 정보는 피하세요.

도구와 Skills

  • 도구는 Skills에 있습니다. 필요할 때 각 skill의 SKILL.md를 따르세요.
  • 환경별 메모는 TOOLS.md(Skills용 메모)에 보관하세요.

백업 팁(권장)

이 작업 영역을 Clawd의 "메모리"로 취급한다면, AGENTS.md와 메모리 파일이 백업되도록 git 저장소(이상적으로는 비공개)로 만드세요.

cd ~/.openclaw/workspace
git init
git add AGENTS.md
git commit -m "Add Clawd workspace"
# Optional: add a private remote + push

OpenClaw가 하는 일

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

핵심 Skills(설정 → Skills에서 활성화)

  • mcporter - 외부 skill 백엔드를 관리하기 위한 도구 서버 런타임/CLI.
  • Peekaboo - 선택적 AI 비전 분석을 지원하는 빠른 macOS 스크린샷.
  • camsnap - RTSP/ONVIF 보안 카메라에서 프레임, 클립 또는 모션 알림을 캡처합니다.
  • oracle - 세션 리플레이와 브라우저 제어를 지원하는 OpenAI 준비 완료 에이전트 CLI.
  • eightctl - 터미널에서 수면을 제어합니다.
  • imsg - iMessage 및 SMS를 보내고, 읽고, 스트리밍합니다.
  • wacli - WhatsApp CLI: 동기화, 검색, 전송.
  • discord - Discord 작업: 반응, 스티커, 투표. user:<id> 또는 channel:<id> 대상을 사용하세요(숫자 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 모델.
  • agent-tools - 자동화와 헬퍼 스크립트를 위한 유틸리티 툴킷.

사용 참고 사항

  • 스크립팅에는 openclaw CLI를 선호하세요. Mac 앱이 권한을 처리합니다.
  • 설치는 Skills 탭에서 실행하세요. 바이너리가 이미 있으면 버튼을 숨깁니다.
  • 비서가 알림을 예약하고, 받은 편지함을 모니터링하고, 카메라 캡처를 트리거할 수 있도록 Heartbeat를 활성화해 두세요.
  • Canvas UI는 네이티브 오버레이와 함께 전체 화면으로 실행됩니다. 중요한 컨트롤을 왼쪽 위/오른쪽 위/아래쪽 가장자리에 배치하지 마세요. 레이아웃에 명시적 거터를 추가하고 안전 영역 인셋에 의존하지 마세요.
  • 브라우저 기반 검증에는 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은 스냅샷 참조가 필요합니다. CSS 선택자에는 evaluate 사용).

관련 항목