campaign 공지사항

info 소개

ZeroClaw는 Rust로 만든 빠르고 작은 완전 자율 AI 어시스턴트 인프라입니다. 단일 정적 바이너리가 $10 하드웨어에서 <5MB RAM으로 실행됩니다 — Node 기반 대안 대비 99% 적은 메모리. 모든 서브시스템이 trait입니다: 설정 변경만으로 Provider, 채널, 도구, 메모리 백엔드, 터널을 교체할 수 있습니다.

download 설치

ZeroClaw는 단일 Rust 바이너리로 제공됩니다. Homebrew, 부트스트랩 스크립트, 또는 수동 소스 빌드로 설치하세요.

Homebrew (macOS / Linuxbrew)

# macOS / Linuxbrew
brew install zeroclaw

원클릭 부트스트랩 (추천)

git clone https://github.com/zeroclaw-labs/zeroclaw.git
cd zeroclaw
./bootstrap.sh

# With system deps + Rust install on fresh machines
./bootstrap.sh --install-system-deps --install-rust

# With onboarding in the same flow
./bootstrap.sh --onboard --api-key "sk-..." --provider openrouter

# Remote one-liner
curl -fsSL https://raw.githubusercontent.com/zeroclaw-labs/zeroclaw/main/scripts/bootstrap.sh | bash

수동 빌드 & 설치

git clone https://github.com/zeroclaw-labs/zeroclaw.git
cd zeroclaw
cargo build --release --locked
cargo install --path . --force --locked

# Ensure ~/.cargo/bin is in PATH
export PATH="$HOME/.cargo/bin:$PATH"

개발 폴백: 전역 설치를 건너뛰려면 명령 앞에 cargo run --release --를 붙이세요.

rocket_launch 빠른 시작

온보딩을 한 번 실행해서 설정을 완료한 다음, 대화를 시작하세요.

# Interactive onboarding wizard
zeroclaw onboard --interactive

# Or quick setup (no prompts)
zeroclaw onboard --api-key sk-... --provider openrouter --model "openrouter/auto"

# Quickly repair channels/allowlists only
zeroclaw onboard --channels-only

# Chat with the agent
zeroclaw agent -m "Hello, ZeroClaw!"

# Interactive mode
zeroclaw agent

# Start gateway + daemon
zeroclaw gateway
zeroclaw daemon

# Check status
zeroclaw status
zeroclaw doctor
zeroclaw channel doctor

# Bind Telegram identity into allowlist
zeroclaw channel bind-telegram 123456789

# Service + migration helpers
zeroclaw service install
zeroclaw config schema
zeroclaw migrate openclaw --dry-run
zeroclaw migrate openclaw

설정 위치: ~/.zeroclaw/config.toml — zeroclaw onboard가 자동으로 생성합니다.

terminal 명령어

ZeroClaw는 모든 워크플로우를 위한 서브커맨드를 갖춘 단일 바이너리입니다.

smart_toy 에이전트 모드

zeroclaw agent 명령은 도구를 사용하고, 메모리를 회상하고, 작업을 실행할 수 있는 AI 어시스턴트를 실행합니다.

# Single message
zeroclaw agent -m "List files in the current directory"

# Interactive REPL
zeroclaw agent

# Use a specific provider/model
zeroclaw agent --provider anthropic --model claude-sonnet-4-6 -m "Hello"

# Use a subscription auth profile
zeroclaw agent --provider openai-codex --auth-profile openai-codex:work -m "Hello"

dns Gateway & 데몬

Gateway는 채널 연동을 위한 웹훅 서버를 노출합니다. 데몬은 하트비트, cron, 채널을 포함한 전체 자율 런타임을 실행합니다.

# Start the gateway (webhook server, default 127.0.0.1:3000)
zeroclaw gateway
zeroclaw gateway --port 0        # random port (security hardened)

# Start full autonomous runtime
zeroclaw daemon

# Manage as a background service
zeroclaw service install
zeroclaw service status

forum 채널

채널을 통해 ZeroClaw는 Telegram, Discord, Slack, Mattermost, iMessage, Matrix, Signal, WhatsApp, Email, IRC, Lark, DingTalk 등에서 메시지를 주고받을 수 있습니다. 모든 채널은 기본 거부 허용 목록을 사용합니다.

# Telegram
[channels_config.telegram]
bot_token = "123456:ABC..."
allowed_users = ["your_username"]   # or ["*"] for all

# Discord
[channels_config.discord]
bot_token = "..."
allowed_users = ["your-discord-id"]

# Slack
[channels_config.slack]
bot_token = "xoxb-..."
allowed_users = ["UMEMBERID"]

# Start channels via daemon
zeroclaw daemon

팁: 다른 설정을 건드리지 않고 채널만 재설정하려면 zeroclaw onboard --channels-only를 실행하세요.

build 도구

도구는 에이전트가 대화 중에 호출할 수 있는 기능입니다. 모든 내장 도구는 기본적으로 샌드박스되고 워크스페이스 스코핑됩니다.

# Built-in tools:
# shell, file_read, file_write, memory, cron,
# git, http_request, browser (opt-in), composio (opt-in),
# delegate, hardware, screenshot, pushover

# Enable browser tools
[browser]
enabled = true
allowed_domains = ["docs.rs", "github.com"]

# Enable Composio (1000+ OAuth integrations)
[composio]
enabled = true
api_key = "cmp_..."

database 메모리 시스템

외부 의존성 제로의 풀스택 검색 엔진 — Pinecone 없음, Elasticsearch 없음, LangChain 없음.

[memory]
backend = "sqlite"             # sqlite | lucid | postgres | markdown | none
auto_save = true
embedding_provider = "none"    # none | openai | custom:https://...
vector_weight = 0.7
keyword_weight = 0.3

# PostgreSQL remote backend
# [storage.provider.config]
# provider = "postgres"
# db_url = "postgres://user:pass@host:5432/zeroclaw"

settings 설정 파일

설정은 ~/.zeroclaw/config.toml에 있습니다 — zeroclaw onboard가 생성합니다.

api_key = "sk-..."
default_provider = "openrouter"
default_model = "anthropic/claude-sonnet-4-6"
default_temperature = 0.7

[memory]
backend = "sqlite"
auto_save = true

[gateway]
port = 3000
host = "127.0.0.1"
require_pairing = true
allow_public_bind = false

[autonomy]
level = "supervised"
workspace_only = true
allowed_commands = ["git", "npm", "cargo", "ls", "cat", "grep"]

[runtime]
kind = "native"

[tunnel]
provider = "none"

[secrets]
encrypt = true

model_training AI Provider

ZeroClaw는 28개 이상의 내장 Provider와 모든 OpenAI 호환 또는 Anthropic 호환 커스텀 엔드포인트를 지원합니다.

zeroclaw providers를 실행하면 사용 가능한 모든 Provider와 별칭을 확인할 수 있습니다.

key 환경 변수

Provider API 키 및 선택적 오버라이드.

# Provider API keys
OPENROUTER_API_KEY=sk-or-v1-...
ANTHROPIC_API_KEY=sk-ant-...
OPENAI_API_KEY=sk-...

# Lucid memory backend
ZEROCLAW_LUCID_CMD=/usr/local/bin/lucid
ZEROCLAW_LUCID_BUDGET=200

# Ollama remote endpoint
OLLAMA_API_KEY=your-key

shield 보안

ZeroClaw는 모든 계층에서 보안을 적용하며 커뮤니티 보안 체크리스트의 모든 항목을 통과합니다.

[gateway]
require_pairing = true
allow_public_bind = false   # refuse 0.0.0.0 without tunnel

[autonomy]
workspace_only = true       # scoped to workspace by default

account_tree 아키텍처

모든 서브시스템이 Rust trait입니다 — 설정 변경만으로 구현체를 교체할 수 있으며, 코드 변경은 불필요합니다.

runtime.kind = "native"와 "docker"가 현재 지원됩니다. WASM/엣지 런타임은 계획 중입니다.

api Gateway API

채널 연동과 상태 확인을 위한 최소 HTTP API.

# Health check (no auth required)
curl http://127.0.0.1:3000/health

# Exchange pairing code for bearer token
curl -X POST http://127.0.0.1:3000/pair \
  -H "X-Pairing-Code: 847291"

# Send a message (requires bearer token)
curl -X POST http://127.0.0.1:3000/webhook \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{"message": "Hello, ZeroClaw!"}'

lock 인증 & 페어링

구독 네이티브 인증 프로필 (멀티 계정, 저장 시 암호화) — OpenAI Codex 및 Anthropic용.

# OpenAI Codex (device code — recommended for servers)
zeroclaw auth login --provider openai-codex --device-code

# Browser/callback flow
zeroclaw auth login --provider openai-codex --profile default

# Anthropic setup token
zeroclaw auth paste-token --provider anthropic --profile default

# Check / refresh / switch profile
zeroclaw auth status
zeroclaw auth refresh --provider openai-codex --profile default
zeroclaw auth use --provider openai-codex --profile work

code 개발

표준 Rust 워크플로우. pre-push Git 훅이 fmt + clippy + test를 자동으로 실행합니다.

# Dev build
cargo build

# Release build (works on all devices including Raspberry Pi)
cargo build --release

# Run tests
cargo test

# Lint
cargo clippy --locked --all-targets -- -D clippy::correctness

# Format
cargo fmt

# Enable pre-push hook (fmt + clippy + test)
git config core.hooksPath .githooks

menu_book 문서 허브

작업 중심 문서는 공식 저장소의 문서 허브에서 시작하세요.

brew install zeroclaw && zeroclaw onboard --interactive