Channel Routing

​

主要な用語

• Channel: whatsapp, telegram, discord, slack, signal, imessage, webchat
• AccountId: チャンネルごとのアカウントインスタンスです。対応しているチャンネルで使用されます。
• チャンネルごとの既定アカウント: channels.<channel>.defaultAccount を使うと、送信時のパスで accountId を明示していない場合に使うアカウントを指定できます。
  • マルチアカウント構成では、2 つ以上のアカウントがある場合に明示的な既定値 (defaultAccount または accounts.default) を設定してください。設定しないと、フォールバックルーティングで最初に正規化されたアカウント ID が選ばれることがあります。
• AgentId: 分離されたワークスペースとセッションストアを持つエージェント識別子です。
• SessionKey: コンテキスト保存と同時実行制御に使うキーです。

​

セッションキーの形式(例)

• agent:<agentId>:<mainKey> (デフォルト: agent:main:main)

• グループ: agent:<agentId>:<channel>:group:<id>
• チャンネル/ルーム: agent:<agentId>:<channel>:channel:<id>

• Slack / Discord のスレッドでは、ベースキーに :thread:<threadId> が追加されます。
• Telegram のフォーラムトピックでは、グループキーに :topic:<topicId> が含まれます。

• agent:main:telegram:group:-1001234567890:topic:42
• agent:main:discord:channel:123456:thread:987654

​

メインDMルートのピン留め

• allowFrom にワイルドカード以外のエントリが 1 つだけある
• そのエントリを、当該チャンネルの具体的な送信者 ID に正規化できる
• 受信した DM の送信者が、その固定された所有者と一致しない

​

ルーティングルール(エージェントの選択方法)

1. 完全一致する peer (peer.kind + peer.id を持つ bindings)
2. 親 peer 一致 (スレッド継承)
3. ギルド + ロール一致 (Discord、guildId + roles)
4. ギルド一致 (Discord、guildId)
5. チーム一致 (Slack、teamId)
6. アカウント一致 (チャンネル上の accountId)
7. チャンネル一致 (そのチャンネル上の任意アカウント、accountId: "*")
8. 既定エージェント (agents.list[].default、なければ最初のリスト項目、さらにフォールバックとして main)

​

ブロードキャストグループ(複数エージェントの実行)

{
  broadcast: {
    strategy: "parallel",
    "120363403215116621@g.us": ["alfred", "baerbel"],
    "+15555550123": ["support", "logger"],
  },
}

​

設定の概要

• agents.list: 名前付きエージェントの定義です。ワークスペースやモデルなどを指定します。
• bindings: 受信したチャンネル、アカウント、peer をどのエージェントへ割り当てるかを定義します。

{
  agents: {
    list: [{ id: "support", name: "Support", workspace: "~/.openclaw/workspace-support" }],
  },
  bindings: [
    { match: { channel: "slack", teamId: "T123" }, agentId: "support" },
    { match: { channel: "telegram", peer: { kind: "group", id: "-100123" } }, agentId: "support" },
  ],
}

​

セッションストレージ

• ~/.openclaw/agents/<agentId>/sessions/sessions.json
• JSONL 形式のトランスクリプトは、ストアと同じ場所に保存されます。

​

WebChatの動作

​

返信コンテキスト

• 利用可能な場合は ReplyToId、ReplyToBody、ReplyToSender
• 引用コンテキストは [Replying to ...] ブロックとして Body に追加されます。