Soloclaw はターミナル用のシングルインスタンス、openclaw互換AIエージェントです。1ユーザー、1エージェント、1セッション — ゲートウェイなし、共有インフラなし。openclawの3層承認エンジン、コンテキストファイルパターン、スキルシステムを、フルスクリーンストリーミングTUIを持つスタンドアロンRustバイナリに忠実に移植しています。5つのLLMプロバイダー、実際のセキュリティコントロール、すべてのツール呼び出しはシステムに触れる前にゲートされます。

インストール

git clone https://github.com/2389-research/soloclaw.git
cd soloclaw
cargo install --path .

# Interactive setup — writes config, API keys, approval rules
claw setup

できること

マルチプロバイダーLLMサポート。 設定またはCLIフラグでAnthopic、OpenAI、Gemini、OpenRouter、Ollamaを切り替えます。すべてのプロバイダーが同じ会話インターフェースを使います。カスタムベースURLでプロキシやセルフホストエンドポイントも動作します。

ストリーミングTUI。 ratatuiで構築されたフルスクリーンターミナルインターフェース。トークンはリアルタイムでストリームされます。チャット履歴はキーボードまたはマウスでスクロール。ツール呼び出しとその出力はインラインで描画されます。

openclaw互換承認エンジン。 Soloclaw はopenclawの3層セキュリティモデルを実装: SecurityLevel (deny、allowlist、full) × AskMode (off、on-miss、always) × 永続的なallowlist。ツール呼び出しがallowlistにマッチしない場合、soloclaw がインラインでプロンプトします: Allow Once、Always Allow、またはDeny。“Always Allow” はパターンを approvals.json に永続化するため、毎回 grep を承認する必要はありません。シェルコマンドは解析され、読み取り専用バイナリ (ls、cat、grep、head など) の組み込みセーフリストと照合されて自動承認されます。

MCP拡張。 プロジェクトルートまたはホームディレクトリに .mcp.json を置きます。Claude Desktop と同じ形式です。MCPサーバーツールは組み込みツールと並んで表示され、同じ承認フローを経由します。

openclawコンテキストファイル。 SOUL.md、AGENTS.md、または TOOLS.md をプロジェクトに置いてエージェントの動作を形作ります — openclawが使うのと同じコンテキストファイルパターンです。.soloclaw.md はプロジェクト固有の設定として機能します。すべてのファイルはオプションで、起動時にシステムプロンプトに読み込まれます。

スキルインジェクション。 4つの設定可能なルート (XDG config、ワークスペース、~/.agents、~/.codex) からの SKILL.md ファイルがシステムプロンプトに注入されます。プロンプトの肥大化を防ぐ制限付き (最大24ファイル、合計32,000文字)。

仕組み

openclawがゲートウェイコントロールプレーンを持つフルマルチエージェント、マルチチャンネルプラットフォームであるのに対し、soloclaw はそれをシングルインスタンスエージェントに絞り込みます。1プロセス、1ターミナル、1会話。ゲートウェイなし、WebSocketルーティングなし、マルチテナントセッションなし。トレードオフはシンプルさです: インフラを動かすことなく、openclawの承認エンジン、コンテキストレイヤリング、スキルシステムを使えます。

Soloclaw はThink-Actループを実行します: LLMがレスポンスを生成し、ツール呼び出しが承認エンジンを経由してルーティングされ、承認済みの呼び出しが実行され、結果が会話にフィードバックされます。TUIがすべてを描画します — メッセージ、ツール呼び出し、承認プロンプト — 単一のフルスクリーンレイアウトで。

設定は $XDG_CONFIG_HOME/soloclaw/ にあります。APIキーは secrets.env (chmod 600) に入ります。claw setup ウィザードが初回設定を処理します。

必要要件

Rustツールチェーン (cargo)
mux-rs — LLM抽象化とツールレジストリレイヤー
少なくとも1つのLLM APIキー (Anthropic、OpenAI、Gemini、OpenRouter) またはOllamaインスタンス