목적별 시작 경로
처음부터 모든 기능을 켤 필요는 없습니다. 아래 경로 중 하나만 골라서 작게 검증하고, 필요한 스킬과 채널을 점진적으로 늘리는 방식이 가장 안정적입니다.
⚡ 10분 안에 실행
설치, setup, 첫 대화, 로컬 서버 확인까지 최소 흐름만 따라갑니다.
☀️ 아침 브리핑
날씨, 시장, RSS 패키지를 설치하고 cron 발송까지 확인합니다.
🔄 반복 요청 자동화
반복 의도 후보를 surface 하고 사용자 승인 후 dispatch 하는 흐름입니다.
🔒 안전하게 운영
sandbox, permission, secrets, 로컬 저장 원칙을 먼저 점검합니다.
가이드 목차
1. 빠른 시작
필수 준비물, 설치 명령, setup wizard, 첫 메시지, 서버 확인.
2. 스킬 패키지
registry 설치, config 입력, manual run, cron trigger, package.toml 읽기.
3. 채널 연결
CLI/Web UI, Telegram, Slack, Discord, Kakao, WebSocket 의 역할과 선택 기준.
4. 모델 선택
기본 모델, named model, /model 전환, cloud/local provider 선택 기준.
5. Reflection
최근 대화 분석, 반복 의도 후보, first-turn suffix, 승인 기반 dispatch.
6. 보안 모델
goja sandbox, SSRF guard, supervised permission, account 별 secrets 저장.
7. 운영 점검
로컬 서버 상태, 스케줄 확인, 알림 실패 원인 분리, 업그레이드 전 체크.
기본 데이터 흐름
사용자는 CLI, 로컬 Web UI, 또는 채널 어댑터로 요청을 보냅니다. KittyPaw 서버는 로컬 SQLite 에 대화와 설정을 저장하고, 필요한 경우 스킬을 goja sandbox 안에서 실행합니다. 스킬 출력은 다시 채팅 응답이나 채널 발송으로 돌아갑니다.
account config · permissions · routing
main · named models · fallback
Claude · OpenAI · Gemini · Groq · local
package.toml · config · supervised ops
messages · schedules · account secrets
chat reply · scheduled briefing · alert
approve · retry · adjust config
Alpha 단계에서는 한 번에 큰 자동화를 만들기보다, 하나의 스킬을 설치하고 수동 실행으로 검증한 뒤 cron 과 채널 발송을 붙이는 순서를 권장합니다.