メッセージ

Inbound message
  -> routing/bindings -> session key
  -> dedupe + debounce
  -> queue (if a run is already active)
  -> agent run (streaming + tools)
  -> outbound replies (channel limits + chunking)

• プレフィックス、キューイング、インバウンドデバウンス、グループ動作用の messages.*。
• ブロックストリーミング、チャンク化、サイレント返信のデフォルト用の agents.defaults.*。
• チャンネルごとの上限とストリーミング切り替え用のチャンネルオーバーライド (channels.telegram.*、channels.whatsapp.* など)。

​

インバウンド重複排除

​

インバウンドデバウンス

{
  messages: {
    inbound: {
      debounceMs: 2000,
      byChannel: {
        discord: 1500,
        slack: 1500,
        whatsapp: 5000,
      },
    },
  },
}

• デバウンスはテキストのみのメッセージに適用されます。メディア/添付ファイルは即座にフラッシュされます。
• 制御コマンド (stop/abort/status など) はデバウンスをバイパスし、即座にディスパッチされます。
• デフォルトでは無効です。messages.inbound.debounceMs には組み込みのデフォルトがないため、デバウンスは (グローバルまたはチャンネルごとに) 設定した場合にのみ有効になります。
• iMessage の coalesceSameSenderDms オプトインが唯一の例外です。これは Apple の command+URL 分割送信が 1 つのターンとして到着するのに十分な時間、同じ送信者の DM テキスト (コマンドを含む) をすべて保持します。グループチャットはこの設定に関係なく常に即座にディスパッチされます。

​

セッションとデバイス

• ダイレクトチャットはエージェントのメインセッションキーにまとめられます。
• グループ/チャンネルはそれぞれ独自のセッションキーを取得します。
• セッションストアとトランスクリプトは Gateway ホスト上に存在します。

​

プロンプト本文と履歴コンテキスト

• [Chat messages since your last reply - for context]
• [Current message - respond to this]

​

ツール結果メタデータ

• toolResult.details はプロバイダー再生前と Compaction 入力前に取り除かれます。
• 永続化されたセッショントランスクリプトは、境界付けられた details のみを保持します。大きすぎるメタデータは persistedDetailsTruncated: true が付いたコンパクトな要約に置き換えられます。
• Plugin とツールは、モデルが読む必要のあるテキストを details だけでなく content に入れる必要があります。

​

キューイングとフォローアップ

​

チャンネル実行の所有権

​

ストリーミング、チャンク化、バッチ化

• agents.defaults.blockStreamingDefault (on|off、デフォルト off)
• agents.defaults.blockStreamingBreak (text_end|message_end)
• agents.defaults.blockStreamingChunk (minChars|maxChars|breakPreference)
• agents.defaults.blockStreamingCoalesce (アイドルベースのバッチ化)
• agents.defaults.humanDelay (ブロック返信間の人間らしい間)
• チャンネルオーバーライド: *.blockStreaming と *.blockStreamingCoalesce (Telegram を含むすべてのチャンネルで、*.blockStreaming が明示的に true に設定されていない限り、ブロックストリーミングはオフです)。

​

推論の可視性とトークン

• /reasoning on|off|stream は可視性を制御します。
• モデルが推論内容を生成する場合、その内容もトークン使用量にカウントされます。
• Telegram は、一時的な下書きバブルへの推論ストリーミングをサポートしており、最終配信後に削除されます。永続的な推論出力には /reasoning on を使用してください。

​

プレフィックス、スレッド化、返信

• アウトバウンドプレフィックスのカスケード: messages.responsePrefix、channels.<channel>.responsePrefix、channels.<channel>.accounts.<id>.responsePrefix。WhatsApp にはインバウンドプレフィックス用の channels.whatsapp.messagePrefix もあります。
• replyToMode とチャンネルごとのデフォルトによる返信スレッド化。

​

サイレント返信

• ダイレクト会話は NO_REPLY プロンプトガイダンスを受け取りません。ダイレクト実行が誤って素のサイレントトークンを返した場合、OpenClaw はそれを書き換えたり配信したりせずに抑制します。
• グループ/チャンネルはデフォルトでサイレンスを許可します。message_tool の可視返信モードでは、サイレンスはモデルが message(action=send) を呼び出さないことを意味します。
• 内部オーケストレーションはデフォルトでサイレンスを許可します。

​

関連

• メッセージライフサイクルのリファクター - 耐久性のある送受信設計のターゲット
• ストリーミング - リアルタイムメッセージ配信
• 再試行 - メッセージ配信の再試行動作
• キュー - メッセージ処理キュー
• チャンネル - メッセージングプラットフォーム連携