자주 묻는 질문
ZeroClaw에 관한 자주 묻는 질문과 작동 방식.
ZeroClaw는 Rust로 작성된 초경량, 완전 자율 AI 에이전트 런타임입니다. 모델, 도구, 메모리, 실행을 추상화하는 인프라로 설계되어, 에이전트를 한 번 만들면 $10 ARM 보드부터 클라우드 서버까지 어디서든 실행할 수 있습니다.
macOS: 'brew install zeroclaw'. Linux: 원클릭 부트스트랩 스크립트 'curl -fsSL https://raw.githubusercontent.com/zeroclaw-labs/zeroclaw/main/scripts/bootstrap.sh | bash'. Windows: rustup으로 Rust 설치 후 'cargo install zeroclaw'. 모든 플랫폼용 사전 빌드 바이너리도 제공됩니다.
ZeroClaw는 <5MB RAM을 사용하고 OpenClaw는 >1GB입니다. 동일 하드웨어에서 <10ms에 시작하고 OpenClaw는 >500초입니다. 바이너리는 ~8.8MB이며 런타임 의존성이 제로인 반면, OpenClaw는 Node.js (~390MB 오버헤드)가 필요합니다. ZeroClaw는 $10 하드웨어에서 실행되고, OpenClaw는 보통 $599 Mac mini가 필요합니다.
ZeroClaw는 Provider trait을 통해 완전한 모델 무관성을 제공합니다. 내장 지원: OpenAI, Anthropic, Google Gemini, xAI Grok, Mistral, DeepSeek, Perplexity, Hugging Face, OpenRouter (100+ 모델), Ollama를 포함한 모든 OpenAI 호환 엔드포인트.
ZeroClaw는 17개 이상의 채널을 지원합니다: CLI, Telegram, Discord, Slack, WhatsApp, Signal, iMessage, Matrix, Mattermost, IRC, Lark, DingTalk, QQ, Nostr, Email, Linq, Webhook. 모든 채널은 보안을 위해 기본 거부 허용 목록 정책을 사용합니다.
보안은 모든 계층에서 적용됩니다: Gateway는 localhost에만 바인딩, 인증을 위한 6자리 페어링 코드, 차단된 시스템 디렉토리가 포함된 파일시스템 스코핑, 심링크 탈출 감지, 기본 거부 채널 허용 목록, 선택적 Docker 샌드박스 런타임. 커뮤니티 보안 체크리스트의 모든 항목을 통과합니다.
ZeroClaw는 외부 의존성 제로의 풀스택 검색 엔진을 갖추고 있습니다. 코사인 유사도를 사용하는 SQLite 벡터 DB, BM25 스코어링의 FTS5 키워드 검색, 커스텀 하이브리드 병합, 플러거블 임베딩 Provider, LRU 캐시 퇴거를 포함합니다. 백엔드: SQLite, PostgreSQL, Lucid, Markdown, 또는 없음.
네. ZeroClaw는 저비용 하드웨어를 위해 설계되었습니다. <5MB 메모리 사용량과 단일 정적 바이너리로 Raspberry Pi, Orange Pi 등 ARM SBC에서 편안하게 실행됩니다. 리소스가 제한된 기기에서는 부트스트랩 시 '--prefer-prebuilt'를 사용해 컴파일을 건너뛰세요.
ZeroClaw의 모든 서브시스템(Provider, Channel, Tool, Memory, Tunnel, Runtime, Security, Identity, Observability)은 Rust trait으로 정의됩니다. 설정만으로 구현체를 교체할 수 있습니다 — 코드 변경 불필요. 예: SQLite에서 PostgreSQL 메모리로, Cloudflare에서 ngrok 터널로 전환.
프로젝트는 Apache 2.0 라이선스로 github.com/zeroclaw-labs/zeroclaw에서 오픈소스입니다. docs/contributing/README.md에서 기여 가이드를 확인하세요. Harvard, MIT, Sundai.Club 커뮤니티의 학생과 멤버들이 만들었습니다. 모든 기여를 환영합니다.
내장 도구: 셸/파일/메모리 작업, cron/스케줄 작업, Git 통합, 브라우저 자동화, HTTP 요청, 스크린샷/이미지 도구, Pushover 알림, Composio (옵트인), 작업 위임, 하드웨어 도구. TOML 매니페스트를 통한 커뮤니티 스킬 팩으로 확장할 수 있습니다.
네. ZeroClaw는 Cloudflare, Tailscale, ngrok, 커스텀 터널 바이너리를 지원합니다. 보안을 위해 활성 터널 없이는 Gateway가 공개 바인딩을 거부합니다. 설정의 Tunnel trait을 통해 구성하세요.
공식이자 유일하게 신뢰할 수 있는 저장소는 github.com/zeroclaw-labs/zeroclaw입니다. 공식 웹사이트는 zeroclawlabs.ai입니다. zeroclaw.org나 zeroclaw.net은 신뢰하지 마세요 — 다른 포크의 사칭 시도입니다.
사전 빌드 바이너리: Linux (x86_64, aarch64, armv7), macOS (x86_64, aarch64), Windows (x86_64). 포터블 Rust 아키텍처로 ARM, x86, RISC-V를 지원합니다.
빠른 설정: 'zeroclaw onboard --api-key sk-... --provider openrouter', 또는 마법사: 'zeroclaw onboard --interactive'. 암호화된 프로필 저장을 통한 OpenAI Codex 및 Anthropic Claude Code 구독 인증도 지원합니다.
전체 문서는 저장소의 docs/README.md에 있으며 목차는 docs/SUMMARY.md입니다. 빠른 경로: API 레퍼런스는 docs/reference, 운영 가이드는 docs/operations, 일반적인 문제는 docs/troubleshooting, 보안 상세는 docs/security.
공식 채널: X (@zeroclawlabs), Reddit (r/zeroclawlabs), Telegram (@zeroclawlabs, 중국어 @zeroclawlabs_cn, 러시아어 @zeroclawlabs_ru), WeChat 그룹, Xiaohongshu. 모두 GitHub README에 나열되어 있습니다.