Clawleash

自律AIエージェント - サンドボックス実行環境搭載

Semantic Kernel × Playwright × PowerShell × MCP × Sandbox Architecture × Multi-Interface

概要

Clawleash（クラウリッシュ）は、安全なサンドボックス環境で動作する自律AIエージェントです。Microsoft Semantic KernelとPlaywrightをベースに、Firecrawl風のWebスクレイピング機能と自律的なブラウザ操作を実現します。

特徴

マルチインターフェース: CLI / Discord / Slack / WebSocket / WebRTC に対応
E2EE対応: WebSocket・WebRTCでエンドツーエンド暗号化
サンドボックス実行: AppContainer (Windows) / Bubblewrap (Linux) で安全に実行
フォルダーポリシー: ディレクトリごとにアクセス権限・ネットワーク制御を設定
ツールパッケージシステム: ZIP/DLLでツールを追加可能
スキルシステム: YAML/JSONでプロンプトテンプレートを定義・再利用
MCPクライアント: 外部MCPサーバーのツールを統合利用
承認システム: 危険な操作にはユーザー承認が必要

主な機能

マルチインターフェース

Clawleashは複数の入力インターフェースを同時にサポートします。

インターフェース	説明	E2EE
CLI	標準コンソール入力（ビルトイン）	-
Discord	Discord Bot経由でメッセージ受信	-
Slack	Slack Bot (HTTP API + ポーリング)	-
WebSocket	SignalRによるリアルタイム通信	✅ AES-256-GCM
WebRTC	DataChannel経由のP2P通信	✅ DTLS-SRTP

アーキテクチャ:

┌─────────────────────────────────────────────────────────────────────┐
│                       Clawleash (Main Application)                   │
│  ┌─────────────────────────────────────────────────────────────────┐ │
│  │     InterfaceLoader + FileSystemWatcher (Hot Reload)            │ │
│  │  %LocalAppData%\Clawleash\Interfaces\ を監視                     │ │
│  │  新規DLL追加 → 自動ロード → ChatInterfaceManagerに登録           │ │
│  └──────────────────────────┬──────────────────────────────────────┘ │
│                             │                                        │
│  ┌──────────────────────────┴──────────────────────────────────────┐ │
│  │                   ChatInterfaceManager                           │ │
│  │  ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌────────┐ │ │
│  │  │   CLI    │ │ Discord  │ │  Slack   │ │ WebSocket│ │ WebRTC │ │ │
│  │  │(Built-in)│ │  (DLL)   │ │  (DLL)   │ │  (DLL)   │ │ (DLL)  │ │ │
│  │  └──────────┘ └──────────┘ └──────────┘ └──────────┘ └────────┘ │ │
│  └───────────────────────────────────────────────────────────────────┘ │
└─────────────────────────────────────────────────────────────────────────┘

設定例 (appsettings.json):

{
  "ChatInterface": {
    "EnableCli": true,
    "EnableHotReload": true,
    "InterfacesDirectory": null,
    "Discord": {
      "Enabled": true,
      "Token": "${DISCORD_BOT_TOKEN}",
      "CommandPrefix": "!"
    },
    "Slack": {
      "Enabled": true,
      "BotToken": "${SLACK_BOT_TOKEN}"
    },
    "WebSocket": {
      "Enabled": true,
      "ServerUrl": "wss://localhost:8080/chat",
      "EnableE2ee": true
    },
    "WebRtc": {
      "Enabled": true,
      "SignalingServerUrl": "wss://localhost:8080/signaling",
      "EnableE2ee": true
    }
  }
}

E2EE（エンドツーエンド暗号化）

WebSocket・WebRTC通信でE2EEを有効にできます。

┌──────────────┐                      ┌──────────────┐
│   Client     │                      │    Server    │
│              │                      │              │
│  1. 鍵交換    │ ◄─── X25519 ────────► │              │
│              │                      │              │
│  2. 暗号化    │                      │              │
│  Plaintext   │                      │              │
│     │        │                      │              │
│     ▼        │                      │              │
│  AES-256-GCM │                      │              │
│     │        │                      │              │
│     ▼        │                      │              │
│  Ciphertext  │ ──── wss:// ────────► │  3. 復号化    │
│              │                      │  AES-256-GCM │
│              │                      │     │        │
│              │                      │     ▼        │
│              │                      │  Plaintext   │
└──────────────┘                      └──────────────┘

Webクローラー（Firecrawl風）

機能	説明
`ScrapeUrl`	URLをスクレイプしてMarkdown形式でコンテンツを取得
`CrawlWebsite`	Webサイト全体をクロールして複数ページのコンテンツを取得
`MapWebsite`	サイトマップ（全URL一覧）を高速に取得
`SearchWeb`	Webを検索（DuckDuckGo使用・APIキー不要）
`BatchScrape`	複数のURLを一括スクレイプ

ファイル操作

機能	説明
`CreateFile` / `ReadFile`	ファイルの作成・読み込み
`ReplaceLine` / `ReplaceText`	行・テキストの置換
`InsertLine` / `DeleteLine`	行の挿入・削除
`MoveFile` / `CopyFile`	ファイルの移動・コピー
`CreateFolder` / `DeleteFolder`	フォルダの作成・削除
`ShowTree`	ディレクトリ構造をツリー形式で表示

ブラウザ操作

基本操作: ナビゲート、クリック、テキスト入力、フォーム送信
スクロール: ページスクロール、最下部への移動
待機操作: 要素表示待機、時間待機、ページ読み込み待機
キーボード: Enter, Tab, Escape, 矢印キーなど
マウス操作: ダブルクリック、右クリック、ドラッグ＆ドロップ
ストレージ: Cookie、localStorage、sessionStorage

AI搭載データ抽出

ExtractStructuredData: AIを使った構造化データ抽出
ExtractProductInfo: 商品情報の自動抽出
SummarizePage: ページ内容の要約

自律エージェント

目標の計画・実行: 目標を設定して、AIが自動的にタスクを分解・実行
自己評価・修正: 実行結果を評価して、失敗時は別のアプローチを試行
Human-in-the-Loop: 危険な操作にはユーザーの承認が必要

スキルシステム

プロンプトテンプレートを再利用可能な「スキル」として定義・実行できます。

機能	説明
`list_skills`	利用可能なスキル一覧を表示
`execute_skill`	指定したスキルを実行
`show_skill`	スキルの詳細情報を表示
`register_skill`	新しいスキルを登録（YAML/JSON）
`remove_skill`	スキルを削除

スキル定義例（YAML）:

name: summarize
description: テキストを要約します
version: "1.0.0"
tags: [text, summarization]

systemInstruction: |
  あなたは専門的な要約アシスタントです。

parameters:
  - name: text
    type: string
    description: 要約するテキスト
    required: true
  - name: style
    type: string
    description: 要約スタイル
    required: false
    default: 簡潔
    enum: [簡潔, 詳細, 箇条書き]

prompt: |
  以下のテキストを{{style}}に要約してください：
  {{text}}

スキルディレクトリ: %LocalAppData%\Clawleash\Skills\

MCP (Model Context Protocol) クライアント

外部MCPサーバーのツールをClawleash内で利用できます。

機能	説明
`list_tools`	MCPサーバーのツール一覧を表示
`execute_tool`	MCPツールを実行

トランスポート対応:

stdio: ローカルNPXパッケージ、Dockerコンテナ
SSE: リモートMCPサーバー（今後対応）

セキュリティ

サンドボックス

プラットフォーム	実装	機能
Windows	AppContainer	ケーパビリティベースのアクセス制御
Linux	Bubblewrap	名前空間分離

AppContainerケーパビリティ

Windows AppContainerでプロセスに付与するケーパビリティを設定できます。

{
  "Sandbox": {
    "Type": "AppContainer",
    "AppContainerName": "Clawleash.Sandbox",
    "Capabilities": "InternetClient, PrivateNetworkClientServer"
  }
}

利用可能なケーパビリティ:

ケーパビリティ	説明
`InternetClient`	インターネットへの送信接続
`InternetClientServer`	インターネットへの着信・送信接続
`PrivateNetworkClientServer`	プライベートネットワークへの接続
`PicturesLibrary`	画像ライブラリへのアクセス
`VideosLibrary`	ビデオライブラリへのアクセス
`MusicLibrary`	ミュージックライブラリへのアクセス
`DocumentsLibrary`	ドキュメントライブラリへのアクセス
`EnterpriseAuthentication`	企業認証
`SharedUserCertificates`	共有証明書
`RemovableStorage`	リムーバブルストレージ
`Appointments`	予定
`Contacts`	連絡先

フォルダーポリシー

ディレクトリごとに詳細なアクセス制御を設定できます。より具体的なパスが優先され、子フォルダーで親の設定を上書き可能です。

{
  "Sandbox": {
    "FolderPolicies": [
      {
        "Path": "C:\\Projects",
        "Access": "ReadWrite",
        "Network": "Allow",
        "Execute": "Allow",
        "Name": "プロジェクトフォルダー"
      },
      {
        "Path": "C:\\Projects\\Secrets",
        "Access": "Deny",
        "Network": "Deny",
        "Name": "機密情報（アクセス禁止）"
      },
      {
        "Path": "C:\\Projects\\Public",
        "Access": "ReadOnly",
        "Network": "Allow",
        "Name": "公開エリア（読み取り専用）"
      },
      {
        "Path": "C:\\Work",
        "Access": "ReadWrite",
        "Network": "Allow",
        "DeniedExtensions": ["exe", "bat", "ps1"],
        "MaxFileSizeMB": 50,
        "Name": "作業フォルダー"
      },
      {
        "Path": "C:\\Work\\Downloads",
        "Access": "ReadWrite",
        "Network": "Allow",
        "Execute": "Deny",
        "EnableAudit": true,
        "Name": "ダウンロード（実行禁止・監査あり）"
      }
    ]
  }
}

ポリシープロパティ:

プロパティ	値	説明
`Access`	`Deny` / `ReadOnly` / `ReadWrite` / `FullControl`	ファイルシステムアクセス
`Network`	`Inherit` / `Allow` / `Deny`	ネットワークアクセス
`Execute`	`Inherit` / `Allow` / `Deny`	プロセス実行権限
`AllowedExtensions`	`[".txt", ".json"]`	許可する拡張子
`DeniedExtensions`	`[".exe", ".bat"]`	禁止する拡張子
`MaxFileSizeMB`	`10`	最大ファイルサイズ
`EnableAudit`	`true`	アクセスログ記録

継承ルール:

C:\Projects          → ReadWrite, Network=Allow
  ├─ \Secrets        → Deny, Network=Deny        ← 親を上書き（無効化）
  ├─ \Public         → ReadOnly, Network=Allow  ← 読み取り専用に変更
  └─ \Data
       └─ \Sensitive → Deny                      ← 深い階層でも上書き可能

PowerShell制約

ConstrainedLanguage: デフォルトの安全なモード
コマンドホワイトリスト: 許可されたコマンドのみ実行
パス制限: 許可されたパスのみアクセス可能

承認システム

// CLI用（コンソールで承認確認）
services.AddCliApprovalHandler();

// 自動化用（ルールベース）
services.AddSilentApprovalHandler(config);

アーキテクチャ

┌─────────────────────────────────────────────────────────────┐
│                      Clawleash (Main)                        │
│  ┌─────────────┐  ┌─────────────┐  ┌─────────────────────┐  │
│  │   Kernel    │  │ ToolLoader  │  │   ShellServer       │  │
│  │  (AI Agent) │  │ (ZIP/DLL)   │  │   (ZeroMQ Router)   │  │
│  └──────┬──────┘  └──────┬──────┘  └──────────┬──────────┘  │
│         │                │                     │ IPC         │
│         ├────────────────┼─────────────────────┤             │
│         │  SkillLoader   │   McpClientManager  │             │
│         │  (YAML/JSON)   │   (stdio/SSE)       │             │
│         └────────────────┴─────────────────────┘             │
│                                                              │
│  ┌─────────────────────────────────────────────────────────┐ │
│  │              ChatInterfaceManager                        │ │
│  │  ┌─────┐ ┌─────────┐ ┌────────┐ ┌──────────┐ ┌───────┐  │ │
│  │  │ CLI │ │ Discord │ │ Slack  │ │ WebSocket│ │ WebRTC│  │ │
│  │  └─────┘ └─────────┘ └────────┘ └──────────┘ └───────┘  │ │
│  └─────────────────────────────────────────────────────────┘ │
└─────────────────────────────────────────────────────────────┘
                            │
                            ▼ MessagePack over ZeroMQ
┌─────────────────────────────────────────────────────────────┐
│                    Clawleash.Shell (Sandboxed)               │
│  ┌─────────────┐  ┌─────────────────────────────────────┐   │
│  │  IpcClient  │  │     ConstrainedRunspaceHost         │   │
│  │  (Dealer)   │  │     (PowerShell SDK)                │   │
│  └─────────────┘  └─────────────────────────────────────┘   │
└─────────────────────────────────────────────────────────────┘

┌─────────────────────────────────────────────────────────────┐
│                    Clawleash.Server (Optional)               │
│  ┌─────────────────────┐  ┌─────────────────────────────┐   │
│  │     ChatHub         │  │     SignalingHub            │   │
│  │  (WebSocket/E2EE)   │  │  (WebRTC Signaling)         │   │
│  └─────────────────────┘  └─────────────────────────────┘   │
│  ┌─────────────────────────────────────────────────────────┐ │
│  │     Svelte Client (Static Files)                        │ │
│  └─────────────────────────────────────────────────────────┘ │
└─────────────────────────────────────────────────────────────┘

プロジェクト構成

Clowleash/
├── Clawleash/                    # メインアプリケーション
│   ├── Execution/
│   │   └── ShellServer.cs        # IPCサーバー
│   ├── Tools/
│   │   ├── ToolLoader.cs         # ツールローダー
│   │   ├── ToolPackage.cs        # パッケージ管理
│   │   ├── ToolProxyGenerator.cs # プロキシ生成 (Reflection.Emit)
│   │   └── ShellToolExecutor.cs  # IPC経由実行
│   ├── Skills/
│   │   └── SkillLoader.cs        # スキルローダー (YAML/JSON)
│   ├── Mcp/
│   │   ├── McpClientManager.cs   # MCPクライアント管理
│   │   ├── McpServerConfig.cs    # MCPサーバー設定
│   │   └── McpToolAdapter.cs     # Semantic Kernel統合
│   ├── Services/
│   │   ├── IApprovalHandler.cs   # 承認システム
│   │   ├── IInputHandler.cs      # 入力システム
│   │   ├── InterfaceLoader.cs    # インターフェース動的ロード
│   │   ├── ChatInterfaceManager.cs # マルチインターフェース管理
│   │   └── CliChatInterface.cs   # CLIインターフェース
│   ├── Sandbox/
│   │   ├── AppContainerProvider.cs  # Windows (ケーパビリティ対応)
│   │   ├── BubblewrapProvider.cs    # Linux
│   │   ├── FolderPolicy.cs          # フォルダーポリシー定義
│   │   ├── FolderPolicyManager.cs   # ポリシー管理・継承処理
│   │   ├── NativeMethods.cs         # P/Invoke定義
│   │   └── AclManager.cs            # ACL管理
│   ├── Security/
│   │   ├── UrlValidator.cs
│   │   ├── PathValidator.cs
│   │   └── CommandValidator.cs
│   └── Plugins/                 # Semantic Kernel プラグイン
│       ├── WebCrawlerPlugin.cs
│       ├── BrowserActionsPlugin.cs
│       ├── FileOperationsPlugin.cs
│       ├── SkillPlugin.cs
│       └── ...
│
├── Clawleash.Shell/              # サンドボックスプロセス
│   ├── IPC/IpcClient.cs          # IPCクライアント (DealerSocket)
│   └── Hosting/
│       └── ConstrainedRunspaceHost.cs  # 制約付きPowerShell
│
├── Clawleash.Abstractions/       # 共有インターフェース
│   ├── Services/
│   │   ├── IChatInterface.cs     # チャットインターフェース
│   │   └── ChatMessageReceivedEventArgs.cs
│   └── Security/
│       └── IE2eeProvider.cs      # E2EEプロバイダー
│
├── Clawleash.Interfaces.Discord/ # Discord Bot インターフェース
│   ├── DiscordChatInterface.cs
│   └── DiscordSettings.cs
│
├── Clawleash.Interfaces.Slack/   # Slack Bot インターフェース
│   ├── SlackChatInterface.cs
│   └── SlackSettings.cs
│
├── Clawleash.Interfaces.WebSocket/ # WebSocket インターフェース (E2EE)
│   ├── WebSocketChatInterface.cs
│   ├── Security/
│   │   └── AesGcmE2eeProvider.cs
│   └── WebSocketSettings.cs
│
├── Clawleash.Interfaces.WebRTC/  # WebRTC インターフェース (E2EE)
│   ├── WebRtcChatInterface.cs
│   ├── Security/
│   │   └── WebRtcE2eeProvider.cs
│   └── WebRtcSettings.cs
│
├── Clawleash.Server/             # SignalRサーバー (WebSocket/WebRTC)
│   ├── Hubs/
│   │   ├── ChatHub.cs            # チャットハブ (E2EE対応)
│   │   └── SignalingHub.cs       # WebRTCシグナリング
│   ├── Security/
│   │   ├── KeyManager.cs         # 鍵管理
│   │   └── E2eeMiddleware.cs     # E2EEミドルウェア
│   └── Client/                   # Svelteフロントエンド
│
├── Clawleash.Contracts/          # 共有型定義
│   └── Messages/
│       ├── ShellMessages.cs      # IPCメッセージ
│       └── Enums.cs              # 共有Enum
│
├── Clawleash.Tests/              # ユニットテスト
│
└── sample-skills/                # サンプルスキル

インストール

# リポジトリをクローン
git clone https://github.com/yourusername/Clowleash.git
cd Clawleash

# 依存関係を復元
dotnet restore

# Playwrightブラウザをインストール
pwsh bin/Debug/net10.0/.playwright/package/cli.js install

設定

appsettings.json:

{
  "AI": {
    "ApiKey": "your-api-key",
    "ModelId": "gpt-4o",
    "Endpoint": "https://api.openai.com/v1"
  },
  "Sandbox": {
    "Type": "AppContainer",
    "AppContainerName": "Clawleash.Sandbox",
    "Capabilities": "InternetClient, PrivateNetworkClientServer",
    "FolderPolicies": [
      {
        "Path": "C:\\Projects",
        "Access": "ReadWrite",
        "Network": "Allow",
        "Execute": "Allow"
      },
      {
        "Path": "C:\\Projects\\Secrets",
        "Access": "Deny",
        "Network": "Deny"
      }
    ]
  },
  "ChatInterface": {
    "EnableCli": true,
    "EnableHotReload": true,
    "Discord": { "Enabled": false },
    "Slack": { "Enabled": false },
    "WebSocket": { "Enabled": false },
    "WebRtc": { "Enabled": false }
  },
  "Browser": {
    "Headless": true
  },
  "Mcp": {
    "Enabled": true,
    "Servers": []
  }
}

使用方法

メインアプリケーション

dotnet run --project Clawleash

SignalRサーバー（WebSocket/WebRTC用）

dotnet run --project Clawleash.Server
# http://localhost:5000 でサーバー起動
# /chat - WebSocketハブ
# /signaling - WebRTCシグナリングハブ

インターフェースDLLの追加

%LocalAppData%\Clawleash\Interfaces\
├── Discord\
│   ├── Clawleash.Interfaces.Discord.dll
│   └── Discord.Net.dll
├── Slack\
│   ├── Clawleash.Interfaces.Slack.dll
│   └── (依存DLL)
├── WebSocket\
│   └── Clawleash.Interfaces.WebSocket.dll
└── WebRTC\
    └── Clawleash.Interfaces.WebRTC.dll

ホットリロード対応：新しいDLLを配置すると自動的に読み込まれます。

スキルの追加

%LocalAppData%\Clawleash\Skills\
└── my-skill.skill.yaml       # YAML形式
└── my-skill.skill.json       # またはJSON形式

IPC通信

項目	仕様
プロトコル	ZeroMQ (Router/Dealer)
シリアライズ	MessagePack
方向	Main (Server) ← Shell (Client)

メッセージ種別:

ShellExecuteRequest/Response - コマンド実行
ToolInvokeRequest/Response - ツール呼び出し
ShellInitializeRequest/Response - 初期化
ShellPingRequest/Response - 死活監視

開発

# ビルド
dotnet build

# テスト実行
dotnet test

# テスト詳細表示
dotnet test --verbosity normal

コントリビュート

このリポジトリをフォーク
フィーチャーブランチを作成 (git checkout -b feature/amazing-feature)
変更をコミット (git commit -m 'Add amazing feature')
プルリクエストを作成

ライセンス

MIT License - LICENSE を参照

Made with ❤️ by actbit

English Version | ⬆ トップに戻る

Name		Name	Last commit message	Last commit date
Latest commit History 51 Commits
Clawleash.Abstractions		Clawleash.Abstractions
Clawleash.Contracts		Clawleash.Contracts
Clawleash.Interfaces.Discord		Clawleash.Interfaces.Discord
Clawleash.Interfaces.Slack		Clawleash.Interfaces.Slack
Clawleash.Interfaces.WebRTC		Clawleash.Interfaces.WebRTC
Clawleash.Interfaces.WebSocket		Clawleash.Interfaces.WebSocket
Clawleash.Server		Clawleash.Server
Clawleash.Shell		Clawleash.Shell
Clawleash.Tests		Clawleash.Tests
Clawleash		Clawleash
sample-skills		sample-skills
.dockerignore		.dockerignore
.gitattributes		.gitattributes
.gitignore		.gitignore
Clawleash.slnx		Clawleash.slnx
LICENSE.txt		LICENSE.txt
README-en.md		README-en.md
README.md		README.md

License

actbit/Clawleash

Folders and files

Latest commit

History

Repository files navigation