グループチャット

OpenClaw は、セキュリティ制御・メンション制御・柔軟な起動モードを備えた強力なグループチャット機能を提供します。各グループには分離された専用セッションが割り当てられ、コンテキストの混線を防ぎます。

各グループチャットは分離された専用セッションで動作します：

• コンテキスト分離 - グループごとに会話履歴を保持します
• メモリ分離 - グループのメモリは DM や他グループと混ざりません
• サンドボックス実行 - セキュリティのため Docker サンドボックスで実行できます
• 独立設定 - グループごとに異なる設定を適用できます

OpenClaw がアクセスできるグループを制御します：

• Allowlist モード - 指定したグループのみアクセス可能
• ワイルドカード対応 - "*" で全グループを許可できます
• チャネル別設定 - メッセージングプラットフォームごとに別の allowlist を持てます

Example Configuration

{
  "channels": {
    "telegram": {
      "groups": {
        "123456789": {
          "requireMention": true
        },
        "*": {
          "requireMention": true,
          "activation": "mention"
        }
      }
    }
  }
}

メンション制御では、bot が返信するために @mention が必要になります：

• 既定の挙動 - メンションされたときだけ返信（推奨）
• ノイズ削減 - すべてのメッセージに反応するのを防ぎます
• UX 改善 - メンバーが bot の参加タイミングを制御できます
• 設定可能 - グループごとに無効化できます

メンションパターン

メンションパターンを設定します：

{
  "messages": {
    "groupChat": {
      "mentionPatterns": ["@openclaw", "@molty", "@bot"]
    }
  }
}

起動モード

• mention - メンションされたときだけ返信（既定、推奨）
• always - すべてのメッセージに返信（注意して使用）
• manual - 明示的に起動されたときだけ返信

起動モードの変更

グループ管理者は起動モードを変更できます：

/activation mention
/activation always
/activation manual

グループには追加のセキュリティ機能があります：

• サンドボックス - 分離された Docker コンテナで実行できます
• ツール制限 - 既定でツールアクセスが制限されます
• 返信タグ - 適切なスレッド化と返信処理
• チャネル別ルーティング - グループを別エージェントへ振り分け可能

サンドボックス設定

グループでサンドボックスを有効化します：

{
  "agents": {
    "defaults": {
      "sandbox": {
        "mode": "non-main"
      }
    }
  }
}

OpenClaw は次の機能でグループメッセージを扱います：

• 返信スレッド - 適切な返信処理とスレッド化
• メディア対応 - 画像、音声、ドキュメントの送受信
• 入力中表示 - bot が処理中であることを表示
• メンション処理 - @mention と返信を正しく処理

メッセージングプラットフォームごとにグループ設定が異なります：

Telegram グループ

{
  "channels": {
    "telegram": {
      "groups": {
        "*": {
          "requireMention": true
        }
      }
    }
  }
}

Discord サーバー

{
  "channels": {
    "discord": {
      "guilds": {
        "123456789": {
          "channels": ["general", "support"]
        }
      }
    }
  }
}

• 1
  メンション制御を使う既定の「メンション時のみ」モードを維持します。
• 2
  Allowlist を設定する信頼できるグループだけを明示的に許可します。
• 3
  サンドボックスを有効化セキュリティのためにグループをサンドボックス化します。
• 4
  活動を監視するグループ内でのやり取りを定期的に見直します。
• 5
  期待値を共有するメンバーに bot の使い方（呼び出し方）を周知します。