| name | openclaw-starter-kit |
| description | OpenClaw 초보자를 위한 풀패키지 온보딩 스킬. 첫 세팅부터 보안 강화까지 대화형으로 안내한다. "초기 세팅", "처음 설정", "starter kit", "온보딩", "setup guide", "시작하기", "세팅 도와줘" 키워드에 반응. |
OpenClaw Starter Kit 🚀
새로운 OpenClaw 유저를 위한 풀패키지 온보딩 스킬.
대화형으로 하나씩 안내하며, 모든 핵심 파일을 자동 생성한다.
트리거
- "초기 세팅", "처음 설정", "starter kit", "온보딩"
- "setup guide", "시작하기", "세팅 도와줘"
- "보안 설정", "security setup"
- "세팅 리포트", "뭐 설치됐어"
실행 흐름
Phase 1: 기본 세팅 (대화형)
Step 1 — SOUL.md (에이전트 성격)
사용자에게 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
- https://brave.com/search/api/ 가입 안내 (무료 월 2,000회)
- API 키 받으면
openclaw configure --section web 실행 안내
- 설정 확인
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 참고
-
API 키 관리
- SOUL.md/USER.md에 절대 키 넣지 않기
- 환경변수 또는
openclaw configure로만 관리
.env 파일은 .gitignore에 추가
-
외부 행동 제어
- 이메일/SNS 발송: 승인 모드 설정
openclaw configure --section security- allowlist로 허용 번호/채널만 허가
-
파일 안전
rm 대신 trash 사용 (복구 가능)- 민감 정보 별도 관리
- 에이전트 접근 범위 명시
-
채널 보안
- 텔레그램: allowlist에 본인 번호만
- 그룹챗: 에이전트 발언 범위 제한
- 모르는 사람 메시지 차단
-
네트워크 보안
- gateway 토큰 외부 노출 금지
- 공용 WiFi에서 대시보드 접속 주의
- 정기적으로
openclaw health 실행
-
데이터 보안
- 개인정보 관리 원칙
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
