~/.openclaw/workspace/
├── MEMORY.md              ← 장기 기억 인덱스
├── memory/
│   ├── YYYY-MM-DD.md      ← 일일 로그 (첫 날 자동 생성)
│   ├── knowledge/          ← 학습 자료
│   ├── projects/           ← 프로젝트 기록
│   └── lessons/            ← 실수/교훈

OpenClaw Starter Kit 🚀

새로운 OpenClaw 사용자를 위한 풀패키지 온보딩 스킬.
대화형으로 하나씩 안내하며, 모든 핵심 파일을 자동 생성한다.

트리거

• - 초기 세팅, 처음 설정, starter kit, 온보딩
• setup guide, 시작하기, 세팅 도와줘
• 보안 설정, security setup
• 세팅 리포트, 뭐 설치됐어

실행 흐름

Phase 1: 기본 세팅 (대화형)

Step 1 — SOUL.md (에이전트 성격)
사용자에게 5가지 질문:

1. 1. 에이전트 이름을 뭘로 할까요?
2. 말투는? (반말/존댓말/캐주얼/전문가)
3. 주요 역할은? (비서/코딩도우미/학습파트너/만능)
4. 하면 안 되는 것은? (경계선)
5. 대표 이모지는?

→ 답변을 기반으로 templates/soul-template.md를 참고하여 SOUL.md 생성
→ 사용자 확인 후 저장

Step 2 — USER.md (사용자 정보)
수집 항목:

• - 이름, 호칭
• 직업/관심사
• 타임존 (기본: Asia/Seoul)
• 특이사항/선호

→ templates/user-template.md 참고하여 생성

Step 3 — 메모리 구조
자동 생성:

~/.openclaw/workspace/
├── MEMORY.md ← 장기 기억 인덱스
├── memory/
│ ├── YYYY-MM-DD.md ← 일일 로그 (첫 날 자동 생성)
│ ├── knowledge/ ← 학습 자료
│ ├── projects/ ← 프로젝트 기록
│ └── lessons/ ← 실수/교훈

→ templates/memory-template.md 기반

Step 4 — HEARTBEAT.md (자동 체크인)
용도 설명 후 기본 템플릿 생성:

• - 날씨 체크
• 할 일 리마인더
• 사용자 맞춤 항목 추가

→ templates/heartbeat-template.md 기반

Phase 2: 스킬 & 도구 설정

Step 5 — Brave Search API

1. 1. https://brave.com/search/api/ 가입 안내 (무료 월 2,000회)
2. API 키 받으면 openclaw configure --section web 실행 안내
3. 설정 확인

Step 6 — 추천 스킬 설치
용도별 안내 → guides/skill-recommendations.md 참고:

용도	스킬	명령어
웹 검색	(Brave API)	openclaw configure --section web
날씨

weather | openclaw skills install weather |
| 요약 | summarize | openclaw skills install summarize |
| GitHub | github | openclaw skills install github |
| 유튜브 | youtube-transcript | openclaw skills install youtube-transcript |

Step 7 — 크론잡 기초
→ guides/cron-basics.md 참고

• - 하트비트 vs 크론 차이
• 예시: 매일 아침 9시 일정 알려줘
• 설정 방법 안내

Phase 3: 보안 강화

Step 8 — 보안 설정 (필수)
→ guides/security-guide.md 참고

1. 1. API 키 관리

- SOUL.md/USER.md에 절대 키 넣지 않기 - 환경변수 또는 openclaw configure로만 관리 - .env 파일은 .gitignore에 추가

1. 2. 외부 행동 제어

- 이메일/SNS 발송: 승인 모드 설정 - openclaw configure --section security - allowlist로 허용 번호/채널만 허가

1. 3. 파일 안전

- rm 대신 trash 사용 (복구 가능) - 민감 정보 별도 관리 - 에이전트 접근 범위 명시

1. 4. 채널 보안

- 텔레그램: allowlist에 본인 번호만 - 그룹챗: 에이전트 발언 범위 제한 - 모르는 사람 메시지 차단

1. 5. 네트워크 보안

- gateway 토큰 외부 노출 금지 - 공용 WiFi에서 대시보드 접속 주의 - 정기적으로 openclaw health 실행

1. 6. 데이터 보안

- 개인정보 관리 원칙 - memory/ 폴더 정기 백업 - 공유 시 민감정보 마스킹

Phase 4: 마무리

Step 9 — 세팅 리포트 생성
자동으로 현재 상태를 스캔하여 리포트 출력:

✅ 세팅 완료 리포트
━━━━━━━━━━━━━━━━━━━━━━━━━━━
📦 설치된 스킬: [자동 감지]
🤖 에이전트: [이름] ([모델])
📡 채널: [연결된 채널]
🔍 웹 검색: [활성/비활성]
📂 워크스페이스: [경로]
📝 SOUL.md: [✅/❌]
👤 USER.md: [✅/❌]
🧠 MEMORY.md: [✅/❌]
💓 HEARTBEAT.md: [✅/❌]
🔒 보안: [allowlist 설정 여부]
⏰ 크론잡: [설정 수]

세팅 담당: [설정자 이름]
세팅 일자: [오늘 날짜]
━━━━━━━━━━━━━━━━━━━━━━━━━━━

Step 10 — 고급 로드맵 안내
→ guides/advanced-roadmap.md 참고

• - 멀티채널 연결
• 서브에이전트 활용
• 벡터DB (RAG) 구축
• 커스텀 스킬 제작

트러블슈팅

→ guides/troubleshooting.md 참고

• - gateway가 안 켜져요 → openclaw doctor 실행
• 봇이 응답 안 해요 → 토큰 확인 + allowlist 체크
• 스킬 설치 오류 → Node.js 버전 확인

파일 구조

openclaw-starter-kit/
├── SKILL.md
├── templates/
│ ├── soul-template.md
│ ├── user-template.md
│ ├── memory-template.md
│ ├── heartbeat-template.md
│ └── agents-template.md
├── guides/
│ ├── skill-recommendations.md
│ ├── cron-basics.md
│ ├── security-guide.md
│ ├── advanced-roadmap.md
│ └── troubleshooting.md
└── package.json