6. マルチチャンネルとツール

マルチチャンネルアーキテクチャ

チャンネルレジストリ

src/channels/registry.ts

8つのコアチャンネルが定義されています：

拡張チャンネル（プラグイン方式）：Microsoft Teams、Matrix、Zalo、Zalo Personal、WebChat

Dockシステム（軽量メタデータ抽象化）

src/channels/dock.ts

ChannelDockが定義する各チャンネルの振る舞い：

• capabilities — チャットタイプ（DM/グループ/チャンネル/スレッド）、ポール、リアクション、編集、送信取消、メディア、ネイティブコマンド等
• outbound — テキストチャンク制限（チャンネルごとに異なる）
• streaming — ストリーミング合体設定（最小文字数、アイドル時間等）
• groups — グループメンション要件、ツールポリシー
• mentions — メンション除去パターン（チャンネル固有）
• threading — リプライモード、スレッドコンテキスト
• agentPrompt — チャンネル固有のプロンプトヒント

チャンネルプラグイン契約

src/channels/plugins/types.plugin.ts

ChannelPluginインターフェースは20以上のアダプタを定義：

チャンネルごとの行動適応

メンション除去

ストリーミング合体

チャンネルごとに異なる設定。例えばDiscordは minChars=1500, idleMs=1000。

セッション管理

src/channels/session.ts

recordInboundSession() が受信メッセージのセッションメタデータ （lastChannel、to、accountId、threadId）を記録し、 返信のルーティングに使用します。

ツールシステム

ツール組み立て

src/agents/pi-tools.ts:164-507

createOpenClawCodingTools() が複数のソースからツールを組み立てます：

ツールポリシーパイプライン

src/agents/pi-tools.ts:462-485

マルチレイヤーのセキュリティフィルタリングがツールへのアクセスを制御します：

1. L1 オーナー専用ポリシー — whatsapp_login, cron, gateway はオーナーのみ
2. L2 プロファイルポリシー — minimal/coding/messaging/full
3. L3 プロバイダ固有ポリシー
4. L4 グローバルポリシー
5. L5 エージェント固有ポリシー
6. L6 グループポリシー — チャンネル/グループごとの制限
7. L7 サンドボックスポリシー
8. L8 サブエージェントポリシー — 深度に基づく制限

ツールプロファイル

src/agents/tool-policy.ts:65-80

ツールグループ

主要ツール一覧

messageツール — ユニバーサルメッセージングインターフェース

src/agents/tools/message-tool.ts

messageツールは53種類のアクションをサポートするユニバーサルメッセージングインターフェースです。 現在のチャンネルの能力に応じてJSONスキーマが動的に適応します。

主要アクション例：

• send, broadcast — メッセージ送信
• poll — 投票作成
• react — リアクション
• edit, unsend — 編集・送信取消
• reply, thread-create — 返信・スレッド作成
• kick, ban, timeout — モデレーション
• sticker, presence — その他

スキルシステム

src/agents/skills.ts、src/agents/skills/workspace.ts

スキルの読み込み優先順位（後から上書き）

1. 追加ディレクトリ（config.skills.load.extraDirs）
2. バンドルスキル（OpenClawに同梱）
3. マネージドスキル（~/.config/openclaw/skills/）
4. パーソナルエージェントスキル（~/.agents/skills/）
5. プロジェクトエージェントスキル（.agents/skills/ in workspace）
6. ワークスペーススキル（skills/ in workspace）

スキルの制限

• ルートごと最大300候補
• ソースごと最大200ロード
• プロンプト内最大150スキル
• プロンプト予算: 30,000文字
• スキルファイルサイズ上限: 256KB

50以上のバンドルスキル例

チャンネルシステムがパーソナルアシスタントを可能にする仕組み

1. 統一アイデンティティ — 全プラットフォームで単一の人格を維持しつつ、メッセージフォーマットをチャンネルに適応
2. セッション継続性 — recordInboundSession()でユーザーの通信チャンネル/スレッドを追跡
3. ラストルート配信 — messageツールが明示的ターゲットなしでユーザーの最新チャンネルに送信可能
4. チャンネル横断メッセージング — Telegramで受信 → Discordで返信、チャンネル間リレーが可能
5. グループごとのツールポリシー — DMではフルツール、公開グループでは制限付き
6. オーナー専用セキュリティ — 機密操作（login、cron、gateway）は検証済みオーナーのみ