IronClaw

あなたの味方になる、安全なパーソナルAIアシスタント

English | 简体中文 | Русский | 日本語 | 한국어

フィロソフィー • 機能 • インストール • 設定 • セキュリティ • アーキテクチャ

フィロソフィー

IronClawはシンプルな原則に基づいて構築されています：あなたのAIアシスタントは、あなたのために働くべきであり、あなたに不利益をもたらすべきではありません。

AIシステムがデータの取り扱いについて不透明になり、企業の利益に沿って調整されることが増えている世界で、IronClawは異なるアプローチを取ります：

• あなたのデータはあなたのもの - すべての情報はローカルに保存・暗号化され、あなたの管理下から離れることはありません
• 設計段階からの透明性 - オープンソース、監査可能、隠れたテレメトリやデータ収集なし
• 自己拡張する能力 - ベンダーのアップデートを待たずに、新しいツールをその場で構築
• 多層防御 - 複数のセキュリティレイヤーがプロンプトインジェクションやデータ流出から保護

IronClawは、個人生活にも仕事にも本当に信頼できるAIアシスタントです。

機能

セキュリティファースト

• WASMサンドボックス - 信頼されていないツールは、機能ベースの権限を持つ隔離されたWebAssemblyコンテナで実行
• 認証情報の保護 - シークレットはツールに公開されず、リーク検出付きでホスト境界で注入
• プロンプトインジェクション防御 - パターン検出、コンテンツサニタイズ、ポリシー適用
• エンドポイントの許可リスト - HTTPリクエストは明示的に許可されたホストとパスのみに制限

常時利用可能

• マルチチャネル - REPL、HTTPウェブフック、WASMチャネル（Telegram、Slack）、Webゲートウェイ
• Dockerサンドボックス - ジョブごとのトークンとオーケストレーター/ワーカーパターンによる隔離されたコンテナ実行
• Webゲートウェイ - リアルタイムSSE/WebSocketストリーミング対応のブラウザUI
• ルーティン - cronスケジュール、イベントトリガー、ウェブフックハンドラーによるバックグラウンド自動化
• ハートビートシステム - 監視・保守タスクのためのプロアクティブなバックグラウンド実行
• 並列ジョブ - 隔離されたコンテキストで複数のリクエストを同時に処理
• 自己修復 - スタックした操作の自動検出と復旧

自己拡張

• 動的ツール構築 - 必要なものを説明すると、IronClawがWASMツールとして構築
• MCPプロトコル - Model Context Protocolサーバーに接続して追加機能を利用
• プラグインアーキテクチャ - 再起動なしで新しいWASMツールやチャネルを追加

永続メモリ

• ハイブリッド検索 - Reciprocal Rank Fusionを使用した全文検索+ベクトル検索
• ワークスペースファイルシステム - メモ、ログ、コンテキストのための柔軟なパスベースストレージ
• アイデンティティファイル - セッション間で一貫した人格と設定を維持

インストール

前提条件

• Rust 1.85+
• PostgreSQL 15+ (pgvector拡張機能を含む)
• NEAR AIアカウント（セットアップウィザードで認証を処理）

ダウンロードまたはビルド

最新のアップデートはリリースページをご覧ください。

irm https://github.com/nearai/ironclaw/releases/latest/download/ironclaw-installer.ps1 | iex

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/nearai/ironclaw/releases/latest/download/ironclaw-installer.sh | sh

brew install ironclaw

# リポジトリをクローン
git clone https://github.com/nearai/ironclaw.git
cd ironclaw

# ビルド
cargo build --release

# テストを実行
cargo test

データベースのセットアップ

# データベースを作成
createdb ironclaw

# pgvectorを有効化
psql ironclaw -c "CREATE EXTENSION IF NOT EXISTS vector;"

設定

セットアップウィザードを実行してIronClawを設定します：

ironclaw onboard

ウィザードは、データベース接続、NEAR AI認証（ブラウザOAuth経由）、シークレットの暗号化（システムキーチェーンを使用）を処理します。設定は接続されたデータベースに永続化されます。ブートストラップ変数（例：DATABASE_URL、LLM_BACKEND）は、データベース接続前に利用できるよう~/.ironclaw/.envに書き込まれます。

代替LLMプロバイダー

IronClawはデフォルトでNEAR AIを使用しますが、多くのLLMプロバイダーをすぐに利用できます。組み込みプロバイダーにはAnthropic、OpenAI、Google Gemini、MiniMax、Mistral、Ollama（ローカル）が含まれます。OpenRouter（300以上のモデル）、Together AI、Fireworks AI、セルフホストサーバー（vLLM、LiteLLM）などのOpenAI互換サービスもサポートされています。

ウィザードでプロバイダーを選択するか、環境変数を直接設定してください：

# 例：MiniMax（組み込み、204Kコンテキスト）
LLM_BACKEND=minimax
MINIMAX_API_KEY=...

# 例：OpenAI互換エンドポイント
LLM_BACKEND=openai_compatible
LLM_BASE_URL=https://openrouter.ai/api/v1
LLM_API_KEY=sk-or-...
LLM_MODEL=anthropic/claude-sonnet-4

完全なプロバイダーガイドはdocs/capabilities/llm-providers.mdをご覧ください。

セキュリティ

IronClawは、データを保護し悪用を防ぐために多層防御を実装しています。

WASMサンドボックス

すべての信頼されていないツールは、隔離されたWebAssemblyコンテナで実行されます：

• 機能ベースの権限 - HTTP、シークレット、ツール呼び出しの明示的なオプトイン
• エンドポイントの許可リスト - 許可されたホスト/パスへのHTTPリクエストのみ
• 認証情報の注入 - シークレットはホスト境界で注入され、WASMコードに公開されない
• リーク検出 - リクエストとレスポンスのシークレット流出試行をスキャン
• レート制限 - 悪用防止のためのツールごとのリクエスト制限
• リソース制限 - メモリ、CPU、実行時間の制約

WASM ──► 許可リスト ──► リーク    ──► 認証情報 ──► リクエスト ──► リーク    ──► WASM
         バリデーター    スキャン       注入        実行          スキャン
                       (リクエスト)                             (レスポンス)

プロンプトインジェクション防御

外部コンテンツは複数のセキュリティレイヤーを通過します：

• パターンベースのインジェクション試行検出
• コンテンツのサニタイズとエスケープ
• 重要度レベル付きポリシールール（ブロック/警告/レビュー/サニタイズ）
• 安全なLLMコンテキスト注入のためのツール出力ラッピング

データ保護

• すべてのデータはローカルのPostgreSQLデータベースに保存
• AES-256-GCMでシークレットを暗号化
• テレメトリ、分析、データ共有なし
• すべてのツール実行の完全な監査ログ

アーキテクチャ