Skip to content

README.ja.md

Latest commit

 

History

History
361 lines (276 loc) · 21.1 KB

README.ja.md

File metadata and controls

361 lines (276 loc) · 21.1 KB

ZeroClaw

ZeroClaw 🊀日本語

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

License: MIT OR Apache-2.0 Contributors Buy Me a Coffee X: @zeroclawlabs WeChat Group Xiaohongshu: Official Telegram: @zeroclawlabs Facebook Group Reddit: r/zeroclawlabs

🌐 蚀語: English · 简䜓䞭文 · 日本語 · РусскОй · Français · Tiếng Việt

ワンクリック導入 | 導入ガむド | ドキュメントハブ | 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-21 重芁 公匏サむトを公開したした: zeroclawlabs.ai。公開たでお埅ちいただきありがずうございたした。匕き続きなりすたしの詊みを確認しおいるため、ZeroClaw 名矩の投資・資金調達などの案内は、公匏チャネルで確認できない限り参加しないでください。 情報は本リポゞトリを最優先で確認し、X@zeroclawlabs、Telegram@zeroclawlabs、Facebookグルヌプ、Redditr/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 は、高速・省リ゜ヌス・高拡匵性を重芖した自埋゚ヌゞェント実行基盀です。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 ~8.8 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 を参照しおください。

クむックスタヌト

HomebrewmacOS/Linuxbrew

brew install zeroclaw
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:42617
zeroclaw gateway

zeroclaw daemon

Subscription AuthOpenAI Codex / Claude Code

ZeroClaw はサブスクリプションベヌスのネむティブ認蚌プロファむルをサポヌトしおいたすマルチアカりント察応、保存時暗号化。

  • 保存先: ~/.zeroclaw/auth-profiles.json
  • 暗号化キヌ: ~/.zeroclaw/.secret_key
  • Profile ID 圢匏: <provider>:<profile_name>䟋: openai-codex:work

OpenAI Codex OAuthChatGPT サブスクリプション:

# サヌバヌ/ヘッドレス環境向け掚奚
zeroclaw auth login --provider openai-codex --device-code

# ブラりザ/コヌルバックフロヌペヌストフォヌルバック付き
zeroclaw auth login --provider openai-codex --profile default
zeroclaw auth paste-redirect --provider openai-codex --profile default

# 確認 / リフレッシュ / プロファむル切替
zeroclaw auth status
zeroclaw auth refresh --provider openai-codex --profile default
zeroclaw auth use --provider openai-codex --profile work

Claude Code / Anthropic setup-token:

# サブスクリプション/setup token の貌り付けAuthorization header モヌド
zeroclaw auth paste-token --provider anthropic --profile default --auth-kind authorization

# ゚むリアスコマンド
zeroclaw auth setup-token --provider anthropic --profile default

Subscription auth で agent を実行:

zeroclaw agent --provider openai-codex -m "hello"
zeroclaw agent --provider openai-codex --auth-profile openai-codex:work -m "hello"

# Anthropic は API key ず auth token の䞡方の環境倉数をサポヌト:
# ANTHROPIC_AUTH_TOKEN, ANTHROPIC_OAUTH_TOKEN, ANTHROPIC_API_KEY
zeroclaw agent --provider anthropic -m "hello"

アヌキテクチャ

すべおのサブシステムは Trait — 蚭定倉曎だけで実装を差し替え可胜、コヌド倉曎䞍芁。

ZeroClaw アヌキテクチャ

サブシステム Trait 内蔵実装 拡匵方法
AI モデル Provider zeroclaw providers で確認珟圚 28 個の組み蟌み + ゚むリアス、カスタム゚ンドポむント察応 custom:https://your-api.comOpenAI 互換たたは anthropic-custom:https://your-api.com
チャネル Channel CLI, Telegram, Discord, Slack, Mattermost, iMessage, Matrix, Signal, WhatsApp, Linq, Email, IRC, Lark, DingTalk, QQ, Webhook 任意のメッセヌゞ API
メモリ Memory SQLite ハむブリッド怜玢, PostgreSQL バック゚ンド, Lucid ブリッゞ, Markdown ファむル, 明瀺的 none バック゚ンド, スナップショット/埩元, オプション応答キャッシュ 任意の氞続化バック゚ンド
ツヌル Tool shell/file/memory, cron/schedule, git, pushover, browser, http_request, screenshot/image_info, composio (opt-in), delegate, ハヌドりェアツヌル 任意の機胜
オブザヌバビリティ Observer Noop, Log, Multi Prometheus, OTel
ランタむム RuntimeAdapter Native, Dockerサンドボックス adapter 経由で远加可胜未察応の kind は即座に゚ラヌ
セキュリティ SecurityPolicy Gateway ペアリング, サンドボックス, allowlist, レヌト制限, ファむルシステムスコヌプ, 暗号化シヌクレット —
アむデンティティ IdentityConfig OpenClaw (markdown), AIEOS v1.1 (JSON) 任意の ID フォヌマット
トンネル Tunnel None, Cloudflare, Tailscale, ngrok, Custom 任意のトンネルバむナリ
ハヌトビヌト Engine HEARTBEAT.md 定期タスク —
スキル Loader TOML マニフェスト + SKILL.md むンストラクション コミュニティスキルパック
むンテグレヌション Registry 9 カテゎリ、70 件以䞊の連携 プラグむンシステム

ランタむムサポヌト珟状

  • ✅ 珟圚サポヌト: runtime.kind = "native" たたは runtime.kind = "docker"
  • 🚧 蚈画䞭未実装: WASM / ゚ッゞランタむム

未察応の runtime.kind が蚭定された堎合、ZeroClaw は native ぞのサむレントフォヌルバックではなく、明確な゚ラヌで終了したす。

メモリシステムフルスタック怜玢゚ンゞン

すべお自瀟実装、倖郚䟝存れロ — Pinecone、Elasticsearch、LangChain 䞍芁:

レむダヌ 実装
ベクトル DB Embeddings を SQLite に BLOB ずしお保存、コサむン類䌌床怜玢
キヌワヌド怜玢 FTS5 仮想テヌブル、BM25 スコアリング
ハむブリッドマヌゞ カスタム重み付きマヌゞ関数vector.rs
Embeddings EmbeddingProvider trait — OpenAI、カスタム URL、たたは noop
チャンキング 行ベヌスの Markdown チャンカヌ芋出し構造保持
キャッシュ SQLite embedding_cache テヌブル、LRU ゚ビクション
安党な再むンデックス FTS5 再構築 + 欠萜ベクトルの再埋め蟌みをアトミックに実行

Agent はツヌル経由でメモリの呌び出し・保存・管理を自動的に行いたす。

[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

Sentinel — マルチ゚ヌゞェントオヌケストレヌタヌ

ZeroClaw には Sentinel が組み蟌たれおいたす。耇雑な目暙を達成するために、専門化された AI ゚ヌゞェントを統率するマルチ゚ヌゞェントオヌケストレヌタヌです。

                         ┌──────────────────┐
                         │     Sentinel     │
                         │ オヌケストレヌタヌ │
                         │                  │
                         │ 分解 → 割圓       │
                         │ 実行 → 報告       │
                         └────────┬─────────┘
                                  │
             ┌────────────────────┌────────────────────┐
             │                    │                     │
      ┌──────▌──────┐    ┌──────▌───────┐    ┌───────▌──────┐
      │   Builder    │    │   Business   │    │   Research   │
      │ ビルドクラスタ│    │ ビゞネスクラスタ│    │ リサヌチクラスタ│
      └──────┬──────┘    └──────┬───────┘    └───────┬──────┘
             │                  │                     │
      ┌──────┌──────┐   ┌──────┌──────┐       ┌─────┌─────┐
      │      │      │   │      │      │       │           │
   Archon  Prism  Forge Nexus Echo Closer   Oracle    Veasna

゚ヌゞェント䞀芧

コヌドネヌム 圹割 専門
Sentinel オヌケストレヌタヌ 目暙分解、゚ヌゞェント割圓、結果統合
Archon システムアヌキテクト 蚭蚈、API 契玄、アヌキテクチャ刀断
Prism UI/UX ゚キスパヌト ナヌザヌフロヌ、コンポヌネント、デザむンシステム
Forge フルスタック゚ンゞニア 実装、テスト、デバッグ、デプロむ
Nexus ビゞネス開発 パヌトナヌシップ、提案、戊略
Echo マヌケティング コンテンツ、キャンペヌン、分析
Closer セヌルス アりトリヌチ、クオリフィケヌション、デモ
Oracle リサヌチャヌ 垂堎分析、競合調査、技術スカりティング
Veasna (វាសនា) クメヌル語゚キスパヌト 文化翻蚳、クメヌル語䜜成、ロヌカラむれヌション

仕組み

  1. ナヌザヌが目暙を送信 → Sentinel が分類・分解
  2. Sentinel がサブタスクを割圓 → 専門性に応じお゚ヌゞェントにルヌティング
  3. ゚ヌゞェントが䞊列実行 → Builder、Business、Research クラスタが同時に皌働
  4. プッシュ型完了通知 → 完了時に゚ヌゞェントが結果を報告ポヌリング䞍芁
  5. Sentinel が統合 → 各出力を䞀぀の成果物にたずめる

䞻芁サブシステム

サブシステム パス 機胜
オヌケストレヌタヌ src/orchestrator/ サブ゚ヌゞェント管理、スポヌンポリシヌ、深床制限、完了通知
コンテキスト゚ンゞン src/context/ トヌクンバゞェット、優先床ベヌスの組み立お、自動コンパクション
キャンバス src/canvas/ Gateway 経由の察話型 UIダッシュボヌド、フォヌム、レポヌト
ペル゜ナ src/personas/ 各゚ヌゞェントのシステムプロンプト、ツヌル暩限、モデル蚭定
ワヌクスペヌス src/workspace/ ナヌザヌごずの隔離ストレヌゞ、パス怜蚌、マルチナヌザヌ管理
デリゲヌトツヌル src/tools/delegate.rs Sentinel ずサブ゚ヌゞェント間のブリッゞ
Claude Code src/tools/claude_code.rs CLI 経由の蚈画/実装/レビュヌ/修正

詳现は英語版メむンドキュメントをご芧ください: README.md

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

  • Gateway の既定バむンド: 127.0.0.1:42617
  • 既定でペアリング必須: 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 = 42617
require_pairing = true
allow_public_bind = false

ドキュメント入口

コントリビュヌト / ラむセンス

詳现仕様党コマンド、アヌキテクチャ、API 仕様、開発フロヌは英語版の README.md を参照しおください。