ZeroClaw 시작하기
단일 Rust 바이너리, 다양한 설치 방법. 원하는 방식을 선택하세요.
checklist 시스템 요구사항
Rust 툴체인 (stable) — rustup.rs에서 설치, 소스 빌드에만 필요
Linux (x86_64, aarch64, armv7), macOS (x86_64, aarch64), Windows (x86_64)
런타임: <5MB RAM. 소스 빌드: 2GB 이상 RAM, 4GB 권장
바이너리: ~8.8MB. 소스 빌드: 6GB 여유 디스크, 10GB 권장
선택사항: Docker (샌드박스 런타임용), Git (소스 빌드용)
AI API 호출에 인터넷 연결 필요. Ollama를 통한 로컬 모델은 완전 오프라인으로 작동합니다.
모든 것을 처리하는 원라인 스크립트. 대부분의 사용자에게 추천합니다.
Remote One-Liner
macOS / Linux. Single command.
curl -fsSL https://raw.githubusercontent.com/zeroclaw-labs/zeroclaw/main/scripts/bootstrap.sh | bash Local Bootstrap
Clone first, then bootstrap. More options.
git clone https://github.com/zeroclaw-labs/zeroclaw.git cd zeroclaw && ./bootstrap.sh # With system deps + Rust: ./bootstrap.sh --install-system-deps --install-rust # With onboarding: ./bootstrap.sh --onboard --api-key "sk-..." --provider openrouter verified 설치 확인
아래 명령어를 실행해서 ZeroClaw가 올바르게 설치되었는지 확인하세요.
zeroclaw --version 설치된 버전이 출력되어야 합니다. ~0.02초, ~3.9MB 피크 메모리로 실행됩니다.
zeroclaw doctor 시스템 진단을 실행합니다: Rust 버전, 설정 파일, Provider 연결, 채널 상태를 확인합니다.
zeroclaw onboard --interactive API 키, Provider 선택, 채널 설정을 안내하는 대화형 설정 마법사입니다.
settings 초기 설정
설치 후 온보딩 마법사가 설정을 안내합니다. 각 단계가 하는 일은 다음과 같습니다.
AI Provider 선택
Provider 카탈로그에서 선택하세요: OpenAI, Anthropic, Google Gemini, xAI, Mistral, DeepSeek, OpenRouter (100+ 모델), 또는 Ollama를 포함한 모든 OpenAI 호환 엔드포인트.
API 키 추가
API 키를 붙여넣으세요. 키는 로컬 config.toml에 저장되며, AI Provider 외에는 어디에도 전송되지 않습니다. 암호화된 프로필을 통한 구독 인증(OpenAI Codex, Anthropic)도 지원됩니다.
채널 연결
Telegram (봇 토큰 붙여넣기), Discord (봇 토큰 붙여넣기), Slack (워크스페이스 앱), WhatsApp (QR 코드), 또는 17개 이상의 지원 채널을 연결하세요. 기본 거부 허용 목록 정책.
에이전트 시작
빠른 테스트는 'zeroclaw agent -m "Hello!"', 전체 자율 런타임은 'zeroclaw daemon', 백그라운드 서비스는 'zeroclaw service install'을 실행하세요.
.env — 모든 설정은 ~/.zeroclaw/config.toml에 저장됩니다. 직접 편집해서 Provider, 채널, 메모리 백엔드, 터널, 보안 설정을 변경할 수 있습니다. 전체 레퍼런스는 docs/reference/README.md를 참고하세요.
system_update_alt ZeroClaw 업그레이드
최신 기능, 연동, 보안 패치를 받으려면 ZeroClaw를 최신 상태로 유지하세요.
brew upgrade zeroclaw cargo install zeroclaw --force cd zeroclaw && git pull && cargo build --release --locked ./bootstrap.sh --docker --skip-build 각 버전의 변경사항은 github.com/zeroclaw-labs/zeroclaw/releases에서 확인하세요.
build 문제 해결
자주 발생하는 문제와 해결 방법입니다.