メッセージ

受信メッセージ
  -> ルーティング／バインディング -> セッションキー
  -> 重複排除 + デバウンス
  -> キュー（実行がすでにアクティブな場合）
  -> エージェント実行（ストリーミング + ツール）
  -> 送信返信（チャネル制限 + チャンク分割）

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

​

受信メッセージの重複排除

​

受信メッセージのデバウンス

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

• デバウンスはテキストのみのメッセージに適用されます。メディア／添付ファイルは即座にフラッシュされます。
• 制御コマンド（停止／中止／ステータスなど）はデバウンスを迂回し、即座にディスパッチされます。
• デフォルトでは無効です。messages.inbound.debounceMs には組み込みのデフォルト値がないため、デバウンスはグローバルまたはチャネルごとに設定した場合にのみ有効になります。
• iMessage にも同じ汎用デバウンスポリシーが適用されます。imsg 0.13.1 以降では、Apple の URL プレビューによる分割送信が OpenClaw に届く前に結合されるため、iMessage 固有のデバウンス設定は不要です。

​

セッションとデバイス

• ダイレクトチャットは、エージェントのメインセッションキーに統合されます。
• グループ／チャネルには、それぞれ独自のセッションキーが割り当てられます。
• セッションストアとトランスクリプトは 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（ブロック返信間の人間らしい間隔）
• チャネルオーバーライド：同梱チャネルでは *.streaming.block.enabled と *.streaming.block.coalesce を使用します。古いフラットキーは openclaw doctor --fix によって移行されます。Telegram を含むすべてのチャネルで、明示的に有効にしない限りブロックストリーミングは無効です。QQ Bot は例外です。streaming.block キーがなく、channels.qqbot.streaming.mode が "off" でない限り、ブロック返信をストリーミングします。

​

推論の可視性とトークン

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

​

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

• 送信プレフィックスは channels.<channel>.responsePrefix と channels.<channel>.accounts.<id>.responsePrefix にあります。アカウントの値が優先されます。これらの正規フィールドが未設定の場合、Doctor はグローバルフォールバックを設定済みのチャネルブロックにコピーします。messages.responsePrefix は、暗黙的チャネルとカスタムチャネルのフォールバックとして引き続き使用されます。
• replyToMode とチャネル別デフォルトによる返信のスレッド化。

​

サイレント返信

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

​

関連項目

• メッセージライフサイクルのリファクタリング - 永続的な送受信設計の目標
• ストリーミング - リアルタイムのメッセージ配信
• 再試行 - メッセージ配信の再試行動作
• キュー - メッセージ処理キュー
• チャネル - メッセージングプラットフォームとの統合