Skill: gyeuun97/openclaw-starter-kit (version 1.0.1)

--- 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가지 질문: 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. 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. **API 키 관리** - SOUL.md/USER.md에 절대 키 넣지 않기 - 환경변수 또는 `openclaw configure`로만 관리 - `.env` 파일은 `.gitignore`에 추가 2. **외부 행동 제어** - 이메일/SNS 발송: 승인 모드 설정 - `openclaw configure --section security` - allowlist로 허용 번호/채널만 허가 3. **파일 안전** - `rm` 대신 `trash` 사용 (복구 가능) - 민감 정보 별도 관리 - 에이전트 접근 범위 명시 4. **채널 보안** - 텔레그램: allowlist에 본인 번호만 - 그룹챗: 에이전트 발언 범위 제한 - 모르는 사람 메시지 차단 5. **네트워크 보안** - gateway 토큰 외부 노출 금지 - 공용 WiFi에서 대시보드 접속 주의 - 정기적으로 `openclaw health` 실행 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 ```

path: guides/advanced-roadmap.md
content: # 고급 세팅 로드맵

## Level 1 — 기본 (첫날)
- [x] OpenClaw 설치
- [x] 텔레그램 연결
- [x] SOUL.md + USER.md 작성
- [x] Brave Search API 등록
- [x] 첫 대화

## Level 2 — 활용 (첫 주)
- [ ] 스킬 3~5개 설치
- [ ] HEARTBEAT.md로 자동 체크인
- [ ] 크론잡 1~2개 설정
- [ ] 메모리 구조 활용 시작
- [ ] 보안 설정 완료

## Level 3 — 자동화 (2~4주)
- [ ] 멀티채널 (텔레그램 + Discord 등)
- [ ] 서브에이전트 활용 (무거운 작업 위임)
- [ ] Google Workspace 연동 (캘린더/메일)
- [ ] 커스텀 워크플로우 설계
- [ ] AGENTS.md 고도화

## Level 4 — 고급 (1~2개월)
- [ ] 벡터DB (RAG) 구축 — Supabase + 임베딩
- [ ] 커스텀 스킬 직접 제작
- [ ] API 연동 (노션, 슬랙, 웹훅 등)
- [ ] 에이전트 대시보드 구축
- [ ] 자기성장 루프 (자동 학습 시스템)

## 팁
- 급하게 Level 4를 목표로 하지 마세요
- Level 1~2를 완벽히 하는 것만으로도 충분히 강력합니다
- 에이전트와 대화하면서 자연스럽게 레벨업 하세요
- 모르는 건 에이전트한테 물어보면 됩니다!


path: guides/cron-basics.md
content: # 크론잡 & 자동화 기초

## 하트비트 vs 크론

| 구분 | 하트비트 | 크론잡 |
|------|---------|--------|
| 타이밍 | ~30분마다 (유동적) | 정확한 시간 |
| 설정 | HEARTBEAT.md 편집 | 에이전트에게 말하기 |
| 용도 | 여러 체크 묶어서 | 단일 작업 정확히 |
| 예시 | "이메일+캘린더 체크" | "9시에 일정 알려줘" |

## 크론잡 설정 방법

에이전트에게 자연어로 말하면 됩니다:

```
"매일 아침 9시에 오늘 일정 알려줘"
"매주 월요일 10시에 주간 리포트 만들어줘"
"30분 후에 회의 시작이라고 알려줘"
"매일 저녁 6시에 오늘 한 일 정리해줘"
```

## 크론잡 관리

```
"크론잡 목록 보여줘"          → 설정된 작업 확인
"그 크론잡 꺼줘"              → 비활성화
"그 크론잡 삭제해줘"          → 완전 삭제
```

## 추천 자동화 (초보자용)

1. **아침 브리핑**: 매일 9시 → 날씨 + 일정 + 뉴스
2. **리마인더**: 특정 시간에 알림
3. **주간 리포트**: 매주 월요일 → 지난주 요약
4. **학습 루프**: 매일 관심 분야 자료 수집


path: guides/security-guide.md
content: # 🔒 OpenClaw 보안 가이드

## 1. API 키 관리 (최우선)

### ❌ 절대 하면 안 되는 것
- SOUL.md, USER.md, MEMORY.md에 API 키 적기
- 에이전트한테 "이 키 기억해" 하기
- 파일에 키를 평문으로 저장하기

### ✅ 올바른 방법
```bash
# OpenClaw 설정으로 관리
openclaw configure --section web      # Brave API 키
openclaw configure --section models   # AI 모델 API 키

# 환경변수로 관리
export OPENAI_API_KEY=sk-xxxxx
export ANTHROPIC_API_KEY=sk-ant-xxxxx
```

### .gitignore 설정
```
.env
*.env
secrets/
```

---

## 2. 채널 보안 (메신저)

### 텔레그램
- **allowlist 필수**: 본인 전화번호만 등록
- 모르는 사람이 봇에 메시지 보내면 자동 무시
- 그룹챗 추가 시 주의 (에이전트가 모든 메시지를 읽음)

### 확인 방법
```bash
openclaw configure --section channels
# → allowlist에 본인 번호 확인
```

---

## 3. 외부 행동 제어

에이전트가 혼자 판단해서 하면 위험한 것들:
- 이메일 발송
- SNS 게시
- 파일 삭제
- 결제/구매

### 설정
```bash
openclaw configure --section security
```
- 외부 발송: 승인 모드 (에이전트가 먼저 물어봄)
- 파일 삭제: `trash` 사용 강제 (`rm` 금지)

---

## 4. Gateway 보안

### 토큰 관리
- gateway 토큰 = 에이전트 접근 열쇠
- **절대 외부 공유 금지**
- 카톡/메신저로 보내지 말 것

### 네트워크
- 공용 WiFi (카페, 공항)에서 대시보드 접속 주의
- 가능하면 VPN 사용
- Tailscale 설정하면 안전한 원격 접속 가능

---

## 5. 데이터 보안

### 에이전트가 아는 것
- SOUL.md, USER.md → 당신의 기본 정보
- memory/ → 대화 기록, 학습 자료
- 연결된 서비스 (이메일, 캘린더 등)

### 관리 원칙
- 민감 정보 (주민번호, 카드번호 등) 에이전트에게 알려주지 않기
- `memory/` 폴더 정기 백업 (월 1회 권장)
- 다른 사람과 공유 시 민감정보 마스킹

---

## 6. 정기 보안 점검

### 월 1회 체크리스트
```
□ openclaw health 실행
□ 설치된 스킬 목록 확인 (모르는 스킬 없는지)
□ allowlist 확인 (허용 번호 맞는지)
□ API 키 유효성 확인
□ memory/ 폴더 백업
□ 크론잡 목록 확인 (불필요한 것 삭제)
```

### 명령어
```bash
openclaw health         # 전체 상태 점검
openclaw status         # 현재 상태
openclaw doctor         # 문제 진단
```

---

## 7. 비상 시 대처

### 에이전트가 이상한 행동을 하면
1. `openclaw gateway stop` → 즉시 중지
2. 로그 확인: `openclaw logs`
3. 설정 확인: `openclaw configure`
4. 필요시 리셋: `openclaw reset` (주의: 설정 초기화)

### API 키가 유출된 것 같으면
1. 해당 서비스에서 즉시 키 폐기 (Revoke)
2. 새 키 발급
3. `openclaw configure`로 새 키 등록


path: guides/skill-recommendations.md
content: # 추천 스킬 가이드

## 🟢 필수 (바로 설치)

| 스킬 | 용도 | 설치 명령어 |
|------|------|------------|
| Brave Search | 웹 검색 | `openclaw configure --section web` |
| weather | 날씨 조회 | `openclaw skills install weather` |
| summarize | 웹/PDF/영상 요약 | `openclaw skills install summarize` |

## 🟡 추천 (용도에 따라)

| 스킬 | 용도 | 설치 명령어 |
|------|------|------------|
| github | GitHub 이슈/PR 관리 | `openclaw skills install github` |
| youtube-transcript | 유튜브 자막 추출 | `openclaw skills install youtube-transcript` |
| gog | Google 캘린더/메일 | `openclaw skills install gog` |
| notion | Notion 연동 | `openclaw skills install notion` |

## 🔴 고급 (나중에)

| 스킬 | 용도 | 설치 명령어 |
|------|------|------------|
| coding-agent | 코딩 에이전트 실행 | `openclaw skills install coding-agent` |
| supabase | 벡터DB/데이터베이스 | `openclaw skills install supabase` |
| nano-pdf | PDF 편집 | `openclaw skills install nano-pdf` |

## Brave Search API 키 발급 방법
1. https://brave.com/search/api/ 접속
2. "Get Started for Free" 클릭
3. 회원가입 (이메일)
4. Free 플랜 선택 (월 2,000회 무료)
5. API Key 복사
6. 터미널에서: `openclaw configure --section web`
7. API Key 입력

→ 이제 에이전트가 웹 검색 가능!


path: guides/troubleshooting.md
content: # 트러블슈팅 FAQ

## 🔴 Gateway가 안 켜져요
```bash
openclaw doctor        # 문제 진단
openclaw gateway start # 수동 시작
```
- Node.js 버전 확인: `node -v` (v18 이상 필요)
- 포트 충돌: `lsof -i :18789` 로 확인

## 🔴 봇이 응답 안 해요
1. gateway 실행 중인지 확인: `openclaw status`
2. API 키 유효한지 확인: `openclaw configure --section models`
3. 텔레그램 allowlist에 내 번호 있는지 확인
4. 봇 토큰이 맞는지 확인

## 🔴 "Command not found: openclaw"
```bash
# npm 글로벌 경로 확인
npm list -g openclaw

# 경로가 안 잡히면
export PATH="$PATH:$(npm config get prefix)/bin"
```

## 🔴 스킬 설치가 안 돼요
```bash
# 권한 문제
sudo npm install -g openclaw

# 스킬 재설치
openclaw skills install [스킬명] --force
```

## 🔴 API 키 오류 (401/403)
- 키가 만료되었을 수 있음 → 새로 발급
- 복사할 때 앞뒤 공백이 들어갔을 수 있음
- `openclaw configure`로 다시 입력

## 🔴 메모리가 안 쌓여요
- MEMORY.md 파일이 존재하는지 확인
- `memory/` 폴더가 있는지 확인
- 에이전트에게 "기억해" 라고 명시적으로 말하기

## 🔴 하트비트가 안 돌아요
- HEARTBEAT.md 파일이 워크스페이스 루트에 있는지 확인
- gateway가 실행 중인지 확인
- heartbeat 간격 설정 확인: `openclaw configure`

## 💡 만능 해결법
```bash
openclaw doctor     # 1. 진단
openclaw health     # 2. 상태 확인
openclaw gateway restart  # 3. 재시작
```
그래도 안 되면 → OpenClaw Discord 커뮤니티에 질문!
https://discord.com/invite/clawd


path: package.json
content: {
  "name": "openclaw-starter-kit",
  "version": "1.0.0",
  "description": "OpenClaw 초보자를 위한 풀패키지 온보딩 스킬. SOUL.md/USER.md 작성, 메모리 구조, 보안 강화, 추천 스킬, 크론잡까지 대화형으로 안내.",
  "author": "gyeuun97",
  "license": "MIT",
  "keywords": ["openclaw", "onboarding", "starter", "setup", "beginner", "korean", "한국어", "초기세팅", "온보딩"]
}


path: templates/agents-template.md
content: # AGENTS.md 템플릿

```markdown
# AGENTS.md - 에이전트 행동 규칙

## 매 세션 시작 시
1. SOUL.md 읽기 (나는 누구인가)
2. USER.md 읽기 (사용자는 누구인가)
3. MEMORY.md 읽기 (무엇을 기억하는가)
4. memory/YYYY-MM-DD.md 읽기 (최근 맥락)

## 기억 관리
- 중요한 건 memory/YYYY-MM-DD.md에 기록
- "기억해" 라고 하면 반드시 파일에 저장
- 주기적으로 MEMORY.md 업데이트

## 안전 규칙
- 개인정보 외부 유출 금지
- 파일 삭제 시 trash 사용 (rm 금지)
- 외부 발송(이메일/SNS) 전 확인
- 확실하지 않으면 먼저 물어보기

## 그룹챗
- 직접 언급되었을 때만 답변
- 불필요한 참견 금지
- 개인 정보 그룹에서 공유 금지
```


path: templates/heartbeat-template.md
content: # HEARTBEAT.md 템플릿

```markdown
# HEARTBEAT.md - 자동 체크인

## 할 일 체크 (하트비트마다 실행)
- 특별한 할 일 없으면 HEARTBEAT_OK 응답

## 예시 항목 (필요한 것만 활성화)
# - 오늘 캘린더 일정 확인
# - 읽지 않은 이메일 체크
# - 날씨 확인 (외출 예정일 때)
# - 프로젝트 진행 상황 체크
```

## 하트비트란?
- 에이전트가 주기적으로 (약 30분마다) 이 파일을 읽음
- 할 일이 있으면 실행, 없으면 조용히 대기
- 주석(#)을 풀면 활성화됨


path: templates/memory-template.md
content: # MEMORY.md 템플릿

```markdown
# MEMORY.md - 장기 기억 인덱스

> 이 파일은 에이전트의 장기 기억 인덱스.
> 중요한 결정, 교훈, 프로젝트 상태를 기록.

## 📌 핵심 정보
- [사용자에 대해 알게 된 중요한 것들]

## 🚀 프로젝트
| 프로젝트 | 상태 | 메모 |
|----------|------|------|
| - | - | - |

## 💡 교훈
- [실수하거나 배운 것들]

## 📅 최근 기록
- memory/YYYY-MM-DD.md 참조
```

## 폴더 구조 (자동 생성)
```
memory/
├── YYYY-MM-DD.md      ← 일일 로그
├── knowledge/          ← 학습한 자료
├── projects/           ← 프로젝트별 기록
└── lessons/            ← 실수/교훈 모음
```


path: templates/soul-template.md
content: # SOUL.md 템플릿

아래 3가지 예시 중 참고하여 사용자 답변 기반으로 작성.

---

## 예시 1: 비서형
```markdown
# SOUL.md - Who You Are

## Core
- **Name:** 아리 (Ari)
- **Role:** 개인 비서 겸 리서치 파트너
- **Tone:** 존댓말, 간결하고 핵심만

## Principles
- 묻기 전에 먼저 찾아보기
- 불필요한 수식어 빼기
- 외부 행동(메일, SNS)은 반드시 확인 후
- 개인정보는 절대 외부 유출 금지

## Boundaries
- 모르면 모른다고 말하기
- 추측으로 행동하지 않기
- 민감한 작업은 항상 확인받기
```

## 예시 2: 친구형
```markdown
# SOUL.md - Who You Are

## Core
- **Name:** 뭉치
- **Role:** 같이 고민하는 친구
- **Tone:** 반말, 편하게, 가끔 이모지

## Principles
- 딱딱하지 않게, 사람처럼
- 재밌는 거 발견하면 공유
- 잘 모르면 같이 찾아보자고 하기
- 비밀은 지키기

## Boundaries
- TMI 금지 (물어볼 때만 자세히)
- 잔소리 아닌 조언
- 기분 나쁜 말 안 하기
```

## 예시 3: 전문가형
```markdown
# SOUL.md - Who You Are

## Core
- **Name:** Atlas
- **Role:** 기술 컨설턴트 & 코딩 파트너
- **Tone:** Professional, 한국어/영어 혼용 OK

## Principles
- 정확성 최우선
- 코드는 실행 가능한 것만
- 트레이드오프 명시
- 근거 없는 추천 안 함

## Boundaries
- 프로덕션 배포는 확인 필수
- 비용 발생 작업 사전 고지
- 보안 취약점 발견 시 즉시 알림
```


path: templates/user-template.md
content: # USER.md 템플릿

```markdown
# USER.md - About You

- **Name:** [이름]
- **Call me:** [호칭 - 대표님/형/이름 등]
- **Pronouns:** [성별]
- **Timezone:** Asia/Seoul
- **Job:** [직업/역할]
- **Interests:** [관심사]
- **Goals:** [현재 목표]
- **Notes:** [특이사항, 선호하는 것, 싫어하는 것 등]
```


Security scan verdicts — ClawScan: clean | static analysis: clean | VirusTotal: clean | SkillSpector: suspicious (HIGH)