campaign お知らせ
当プロジェクトはopenagen/zeroclawやzeroclaw.orgとは無関係です。公式リポジトリと認証済みZeroClawソーシャルアカウントのみを信頼してください。
公式の資金調達/投資プログラムは開始されていません。なりすましや非公式の主張は無視してください。
Anthropic OAuthの規約が変更されました(2026-02-19)。ポリシーリスクが明確になるまで、Claude Code OAuth連携は一時的に避けてください。
info はじめに
ZeroClawはRustで構築された高速・軽量・完全自律型のAIアシスタントインフラです。シングルスタティックバイナリが$10のハードウェアでRAM 5MB未満で動作 — Nodeベースの代替より99%少ないメモリ。すべてのサブシステムがtrait:設定変更でプロバイダー、チャンネル、ツール、メモリバックエンド、トンネルを切り替え。
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はすべてのワークフローに対応するサブコマンドを持つシングルバイナリです。
| コマンド | 説明 |
|---|---|
zeroclaw onboard | インタラクティブまたはクイックセットアップ — 設定を作成、APIキーを設定 |
zeroclaw onboard --channels-only | チャンネルの認証情報/許可リストのみを再設定 |
zeroclaw agent | チャットモード(インタラクティブREPLまたは単一-mメッセージ) |
zeroclaw gateway | Webhookサーバーを起動(デフォルト127.0.0.1:3000) |
zeroclaw daemon | フル自律型の長時間実行ランタイムを起動 |
zeroclaw status | フルシステムステータスを表示 |
zeroclaw auth status | アクティブな認証プロファイルとトークン状態を確認 |
zeroclaw doctor | デーモン/スケジューラ/チャンネルの鮮度を診断 |
zeroclaw channel list | 設定済みチャンネルとステータスを一覧表示 |
zeroclaw channel doctor | チャンネルの健全性と準備状態を確認 |
zeroclaw channel bind-telegram <id> | TelegramユーザーIDを許可リストに認可 |
zeroclaw service install | ユーザーレベルのバックグラウンドサービスをインストール |
zeroclaw service start/stop/status | バックグラウンドサービスのライフサイクルを管理 |
zeroclaw cron | スケジュールタスクを管理(list/add/remove/pause/resume) |
zeroclaw providers | 対応プロバイダーとエイリアスを一覧表示 |
zeroclaw models | プロバイダーモデルカタログを更新 |
zeroclaw auth login | サブスクリプション認証プロファイルでログイン |
zeroclaw skills | スキルの一覧/インストール/削除 |
zeroclaw config schema | フル設定コントラクトのJSON Schemaを出力 |
zeroclaw migrate openclaw | OpenClawランタイムからデータをインポート |
zeroclaw integrations info <name> | 連携セットアップのガイダンスを取得 |
zeroclaw hardware | USB discover/introspect/infoコマンド |
zeroclaw peripheral | ハードウェアペリフェラルの管理とフラッシュ |
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 ゲートウェイとデーモン
ゲートウェイはチャンネル連携用のWebhookサーバーを公開します。デーモンはハートビート、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プロバイダー
ZeroClawは28以上の組み込みプロバイダーに加え、OpenAI互換またはAnthropic互換のカスタムエンドポイントに対応。
| プロバイダー | 説明 |
|---|---|
openrouter | マルチモデルルーター(推奨) |
anthropic | Claudeモデル |
openai | GPTモデル |
ollama | ローカルまたはリモートOllama |
gemini | Google Gemini |
custom:https://... | 任意のOpenAI互換エンドポイント |
zeroclaw providersを実行して利用可能なプロバイダーとエイリアスを一覧表示。
key 環境変数
プロバイダー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 | 変数 | 説明 |
|---|---|
OPENROUTER_API_KEY | OpenRouter APIキー |
ANTHROPIC_API_KEY | Anthropic APIキー |
OPENAI_API_KEY | OpenAI APIキー |
OLLAMA_API_KEY | Ollamaリモートエンドポイントキー |
ZEROCLAW_LUCID_CMD | lucidバイナリのパス |
ZEROCLAW_LUCID_BUDGET | Lucidメモリバジェット(デフォルト200) |
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 — 設定変更で実装をスワップ、コード変更ゼロ。
| サブシステム | Trait | 同梱内容 |
|---|---|---|
| AIモデル | Provider | 28の組み込み + カスタムエンドポイント |
| チャンネル | Channel | CLI, Telegram, Discord, Slack, WhatsApp, iMessage, Matrix, Signal, Email, IRC, Lark, DingTalk, QQ, Webhook |
| メモリシステム | Memory | SQLiteハイブリッド, PostgreSQL, Lucid, Markdown, none |
| ツール | Tool | shell, file, memory, cron, git, browser, http, composio, delegate, hardware |
| オブザーバビリティ | Observer | Noop, Log, Multi |
| ランタイム | RuntimeAdapter | Native, Docker(サンドボックス) |
| セキュリティ | SecurityPolicy | ペアリング, サンドボックス, 許可リスト, レート制限, ファイルシステムスコーピング |
| アイデンティティ | IdentityConfig | OpenClaw(markdown), AIEOS v1.1(JSON) |
| トンネル | Tunnel | None, Cloudflare, Tailscale, ngrok, Custom |
| ハートビート | Engine | HEARTBEAT.md定期タスク |
| スキルの一覧/インストール/削除 | Loader | TOMLマニフェスト + SKILL.md命令 |
| 連携 | Registry | 9カテゴリにわたる70以上の連携 |
runtime.kind = "native"と"docker"が現在サポート。WASM/エッジランタイムは計画中。
api Gateway API
チャンネル連携とヘルスチェックのための最小HTTP API。
| メソッド | エンドポイント | 説明 |
|---|---|---|
GET | /health | ヘルスチェック(常にパブリック、シークレットは漏洩しない) |
POST | /pair | OTP(X-Pairing-Codeヘッダー)をBearerトークンと交換 |
POST | /webhook | エージェントにメッセージを送信(Authorization: Bearer) |
GET/POST | WhatsApp Webhook検証 + 受信メッセージ |
# 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 ドキュメントハブ
タスク指向のドキュメントは、公式リポジトリのドキュメントハブから始めてください。
| ドキュメント | パス |
|---|---|
| ドキュメントハブ | docs/README.md |
| 統合ドキュメント目次 | docs/SUMMARY.md |
| コマンドリファレンス | docs/commands-reference.md |
| 設定リファレンス | docs/config-reference.md |
| プロバイダーリファレンス | docs/providers-reference.md |
| チャンネルリファレンス | docs/channels-reference.md |
| 運用ランブック | docs/operations-runbook.md |
| トラブルシューティング | docs/troubleshooting.md |