harald/zeroclaw
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions 3
zeroclaw/README.ja.md

8.8 KiB
Raw Blame History

ZeroClaw

ZeroClaw 🦀（日本語）

Zero overhead. Zero compromise. 100% Rust. 100% Agnostic.

🌐 言語: English · 简体中文 · 日本語 · Русский

ワンクリック導入 | 導入ガイド | ドキュメントハブ | Docs TOC

クイック分流： 参照 · 運用 · 障害対応 · セキュリティ · ハードウェア · 貢献・CI

この文書は README.md の内容を、正確性と可読性を重視して日本語に整えた版です（逐語訳ではありません）。

コマンド名、設定キー、API パス、Trait 名などの技術識別子は英語のまま維持しています。

最終同期日: 2026-02-19。

📢 お知らせボード

重要なお知らせ（互換性破壊変更、セキュリティ告知、メンテナンス時間、リリース阻害事項など）をここに掲載します。

日付 (UTC) レベル お知らせ 対応
2026-02-19 緊急 私たちは openagen/zeroclaw および zeroclaw.org とは一切関係ありません。zeroclaw.org は現在 openagen/zeroclaw の fork を指しており、そのドメイン/リポジトリは当プロジェクトの公式サイト・公式プロジェクトを装っています。 これらの情報源による案内、バイナリ、資金調達情報、公式発表は信頼しないでください。必ず本リポジトリと認証済み公式SNSのみを参照してください。
2026-02-19 重要 公式サイトはまだ公開しておらず、なりすましの試みを確認しています。ZeroClaw 名義の投資・資金調達などの活動には参加しないでください。 情報は本リポジトリを最優先で確認し、X（@zeroclawlabs） と 小紅書アカウント で公式更新を確認してください。
2026-02-19 重要 Anthropic は 2026-02-19 に Authentication and Credential Use を更新しました。条文では、OAuth authentication（Free/Pro/Max）は Claude Code と Claude.ai 専用であり、Claude Free/Pro/Max で取得した OAuth トークンを他の製品・ツール・サービス（Agent SDK を含む）で使用することは許可されず、Consumer Terms of Service 違反に該当すると明記されています。 損失回避のため、当面は Claude Code OAuth 連携を試さないでください。原文: Authentication and Credential Use。

概要

ZeroClaw は、高速・省リソース・高拡張性を重視した自律エージェント実行基盤です。

  • Rust ネイティブ実装、単一バイナリで配布可能
  • Trait ベース設計（Provider / Channel / Tool / Memory など）
  • セキュアデフォルト（ペアリング、明示 allowlist、サンドボックス、スコープ制御）

ZeroClaw が選ばれる理由

  • 軽量ランタイムを標準化: CLI や status などの常用操作は数MB級メモリで動作。
  • 低コスト環境に適合: 低価格ボードや小規模クラウドでも、重い実行基盤なしで運用可能。
  • 高速コールドスタート: Rust 単一バイナリにより、主要コマンドと daemon 起動が非常に速い。
  • 高い移植性: ARM / x86 / RISC-V を同じ運用モデルで扱え、provider/channel/tool を差し替え可能。

ベンチマークスナップショット（ZeroClaw vs OpenClaw、再現可能）

以下はローカルのクイック比較（macOS arm64、2026年2月）を、0.8GHz エッジ CPU 基準で正規化したものです。

OpenClaw NanoBot PicoClaw ZeroClaw 🦀
言語 TypeScript Python Go Rust
RAM > 1GB > 100MB < 10MB < 5MB
起動時間（0.8GHz コア） > 500s > 30s < 1s < 10ms
バイナリサイズ ~28MB（dist） N/A（スクリプト） ~8MB 3.4 MB
コスト Mac Mini $599 Linux SBC ~$50 Linux ボード $10 任意の $10 ハードウェア

注記: ZeroClaw の結果は release ビルドを /usr/bin/time -l で計測したものです。OpenClaw は Node.js ランタイムが必要で、ランタイム由来だけで通常は約390MBの追加メモリを要します。NanoBot は Python ランタイムが必要です。PicoClaw と ZeroClaw は静的バイナリです。

ZeroClaw vs OpenClaw Comparison

ローカルで再現可能な測定

ベンチマーク値はコードやツールチェーン更新で変わるため、必ず自身の環境で再測定してください。

cargo build --release
ls -lh target/release/zeroclaw

/usr/bin/time -l target/release/zeroclaw --help
/usr/bin/time -l target/release/zeroclaw status

README のサンプル値（macOS arm64, 2026-02-18）:

  • Release バイナリ: 8.8M
  • zeroclaw --help: 約 0.02s、ピークメモリ 約 3.9MB
  • zeroclaw status: 約 0.01s、ピークメモリ 約 4.1MB

ワンクリック導入

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

環境ごと初期化する場合: ./bootstrap.sh --install-system-deps --install-rust（システムパッケージで sudo が必要な場合があります）。

詳細は docs/one-click-bootstrap.md を参照してください。

クイックスタート

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

zeroclaw onboard --api-key sk-... --provider openrouter
zeroclaw onboard --interactive

zeroclaw agent -m "Hello, ZeroClaw!"

# default: 127.0.0.1:3000
zeroclaw gateway

zeroclaw daemon

セキュリティのデフォルト

  • Gateway の既定バインド: 127.0.0.1:3000
  • 既定でペアリング必須: require_pairing = true
  • 既定で公開バインド禁止: allow_public_bind = false
  • Channel allowlist:
    • [] は deny-by-default
    • ["*"] は allow all（意図的に使う場合のみ）

設定例

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

[memory]
backend = "sqlite"
auto_save = true
embedding_provider = "none"

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

ドキュメント入口

コントリビュート / ライセンス

詳細仕様（全コマンド、アーキテクチャ、API 仕様、開発フロー）は英語版の README.md を参照してください。