campaign お知らせ

重要

当プロジェクトはopenagen/zeroclawやzeroclaw.orgとは無関係です。公式リポジトリと認証済みZeroClawソーシャルアカウントのみを信頼してください。

注意

公式の資金調達/投資プログラムは開始されていません。なりすましや非公式の主張は無視してください。

注意

Anthropic OAuthの規約が変更されました(2026-02-19)。ポリシーリスクが明確になるまで、Claude Code OAuth連携は一時的に避けてください。

info はじめに

ZeroClawはRustで構築された高速・軽量・完全自律型のAIアシスタントインフラです。シングルスタティックバイナリが$10のハードウェアでRAM 5MB未満で動作 — Nodeベースの代替より99%少ないメモリ。すべてのサブシステムがtrait:設定変更でプロバイダー、チャンネル、ツール、メモリバックエンド、トンネルを切り替え。

memory
シングルバイナリ
3.4MBリリース、0.8GHzでコールドスタート10ms未満
swap_horiz
Trait駆動
Provider、Channel、Tool、Memory、Tunnel — すべてスワップ可能
shield
デフォルトでセキュア
Localhostのみのゲートウェイ、ペアリングOTP、ワークスペーススコーピング
developer_board
どこにでもデプロイ
ARM、x86、RISC-V — Raspberry Piからクラウドまで

download インストール

ZeroClawはRustシングルバイナリとして提供。Homebrew、ブートストラップスクリプト、またはソースからの手動ビルドでインストール。

前提条件: Rust stableツールチェーン(rustup)、Git、AIプロバイダーAPIキー(OpenRouter、Anthropic、OpenAI、Ollamaなど)

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 gatewayWebhookサーバーを起動(デフォルト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 openclawOpenClawランタイムからデータをインポート
zeroclaw integrations info <name>連携セットアップのガイダンスを取得
zeroclaw hardwareUSB 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
Security: ゲートウェイはデフォルトで127.0.0.1にバインド。外部公開にはトンネル(Cloudflare、Tailscale、ngrok)を使用してください。

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不要。

ベクトルDB
SQLite BLOB + コサイン類似度
キーワード検索
FTS5 + BM25スコアリング
ハイブリッドマージ
カスタム重み付きマージ
キャッシュ
LRUエビクションポリシー
[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マルチモデルルーター(推奨)
anthropicClaudeモデル
openaiGPTモデル
ollamaローカルまたはリモートOllama
geminiGoogle 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_KEYOpenRouter APIキー
ANTHROPIC_API_KEYAnthropic APIキー
OPENAI_API_KEYOpenAI APIキー
OLLAMA_API_KEYOllamaリモートエンドポイントキー
ZEROCLAW_LUCID_CMDlucidバイナリのパス
ZEROCLAW_LUCID_BUDGETLucidメモリバジェット(デフォルト200)

shield セキュリティ

ZeroClawはすべてのレイヤーでセキュリティを強制し、コミュニティセキュリティチェックリストの全項目をパスしています。

Localhostのみのゲートウェイ
127.0.0.1にバインド。トンネルまたはallow_public_bindなしでは0.0.0.0を拒否
ペアリング必須
起動時に6桁OTP。POST /pairでBearerトークンと交換
ファイルシステムスコープ
デフォルトでworkspace_only。14のシステムディレクトリ + 4つの機密dotfileをブロック
シンボリックリンクエスケープ検出
正規化 + 解決パスのワークスペースチェック
暗号化シークレット
APIキーをローカルキーファイルで保存時に暗号化
デフォルト拒否チャンネル
空の許可リスト = すべて拒否。"*" = すべて許可(明示的オプトイン)
[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モデルProvider28の組み込み + カスタムエンドポイント
チャンネルChannelCLI, Telegram, Discord, Slack, WhatsApp, iMessage, Matrix, Signal, Email, IRC, Lark, DingTalk, QQ, Webhook
メモリシステムMemorySQLiteハイブリッド, PostgreSQL, Lucid, Markdown, none
ツールToolshell, file, memory, cron, git, browser, http, composio, delegate, hardware
オブザーバビリティObserverNoop, Log, Multi
ランタイムRuntimeAdapterNative, Docker(サンドボックス)
セキュリティSecurityPolicyペアリング, サンドボックス, 許可リスト, レート制限, ファイルシステムスコーピング
アイデンティティIdentityConfigOpenClaw(markdown), AIEOS v1.1(JSON)
トンネルTunnelNone, Cloudflare, Tailscale, ngrok, Custom
ハートビートEngineHEARTBEAT.md定期タスク
スキルの一覧/インストール/削除LoaderTOMLマニフェスト + SKILL.md命令
連携Registry9カテゴリにわたる70以上の連携

runtime.kind = "native"と"docker"が現在サポート。WASM/エッジランタイムは計画中。

api Gateway API

チャンネル連携とヘルスチェックのための最小HTTP API。

メソッドエンドポイント説明
GET/healthヘルスチェック(常にパブリック、シークレットは漏洩しない)
POST/pairOTP(X-Pairing-Codeヘッダー)をBearerトークンと交換
POST/webhookエージェントにメッセージを送信(Authorization: Bearer)
GET/POST/whatsappWhatsApp 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

スタックを実行する準備は?

brew install zeroclaw && zeroclaw onboard --interactive