Discord

Discord はエージェント出力内の返信タグをサポートします。

• [[reply_to_current]]
• [[reply_to:<id>]]

channels.discord.replyToMode で制御します。

• off (デフォルト)
• first
• all
• batched

注: off は暗黙的な返信スレッド化を無効にします。明示的な [[reply_to_*]] タグは引き続き尊重されます。 first は、そのターンの最初の送信 Discord メッセージに、常に暗黙的なネイティブ返信参照を付与します。 batched は、受信ターンが複数メッセージのデバウンスされたバッチだった場合にのみ、 Discord の暗黙的なネイティブ返信参照を付与します。これは、 単一メッセージのすべてのターンではなく、主に曖昧な連続チャットでネイティブ返信を使いたい場合に便利です。

メッセージ ID はコンテキスト/履歴に表示されるため、エージェントは特定のメッセージを対象にできます。

OpenClaw は、一時メッセージを送信し、テキスト到着に合わせて編集することで、下書き返信をストリーミングできます。channels.discord.streaming は off | partial | block | progress (デフォルト) を受け取ります。progress は編集可能なステータス下書きを 1 つ保持し、最終配信までツール進行状況で更新します。streamMode はレガシーランタイムエイリアスです。永続化された設定を正規キーに書き換えるには、openclaw doctor --fix を実行します。

Discord プレビュー編集を無効にするには、channels.discord.streaming.mode を off に設定します。Discord ブロックストリーミングが明示的に有効な場合、OpenClaw は二重ストリーミングを避けるためにプレビューストリームをスキップします。

{
channels: {
discord: {
  streaming: {
    mode: "progress",
    progress: {
      label: "auto",
      maxLines: 8,
      toolProgress: true,
    },
  },
},
},
}

• partial はトークン到着に合わせて単一のプレビューメッセージを編集します。
• block は下書きサイズのチャンクを送出します (サイズと区切り位置の調整には draftChunk を使用し、textChunkLimit にクランプされます)。
• メディア、エラー、明示的な返信の最終メッセージは、保留中のプレビュー編集をキャンセルします。
• streaming.preview.toolProgress (デフォルト true) は、ツール/進行状況更新がプレビューメッセージを再利用するかどうかを制御します。
• streaming.preview.commandText / streaming.progress.commandText は、コンパクトな進行状況行でのコマンド/exec 詳細を制御します: raw (デフォルト) または status (ツールラベルのみ)。

コンパクトな進行状況行を維持しつつ、生のコマンド/exec テキストを隠すには:

{
  "channels": {
    "discord": {
      "streaming": {
        "mode": "progress",
        "progress": {
          "toolProgress": true,
          "commandText": "status"
        }
      }
    }
  }
}

プレビューストリーミングはテキストのみです。メディア返信は通常配信にフォールバックします。block ストリーミングが明示的に有効な場合、OpenClaw は二重ストリーミングを避けるためにプレビューストリームをスキップします。

ギルド履歴コンテキスト:

• channels.discord.historyLimit のデフォルトは 20
• フォールバック: messages.groupChat.historyLimit
• 0 は無効化

DM 履歴制御:

• channels.discord.dmHistoryLimit
• channels.discord.dms["<user_id>"].historyLimit

スレッドの動作:

• Discord スレッドはチャンネルセッションとしてルーティングされ、上書きされない限り親チャンネル設定を継承します。
• スレッドセッションは、親チャンネルのセッションレベルの /model 選択をモデルのみのフォールバックとして継承します。スレッドローカルの /model 選択が引き続き優先され、トランスクリプト継承が有効でない限り親トランスクリプト履歴はコピーされません。
• channels.discord.thread.inheritParent (デフォルト false) は、新しい自動スレッドを親トランスクリプトからシードするようにします。アカウントごとの上書きは channels.discord.accounts.<id>.thread.inheritParent 配下にあります。
• メッセージツールのリアクションは user:<id> DM ターゲットを解決できます。
• guilds.<guild>.channels.<channel>.requireMention: false は、返信ステージのアクティベーションフォールバック中に保持されます。

チャンネルトピックは 信頼されない コンテキストとして注入されます。許可リストは誰がエージェントをトリガーできるかを制御しますが、完全な補足コンテキストの秘匿境界ではありません。

Discord はスレッドをセッションターゲットにバインドできるため、そのスレッド内の後続メッセージは同じセッション (サブエージェントセッションを含む) にルーティングされ続けます。

コマンド:

• /focus <target> 現在/新規スレッドをサブエージェント/セッションターゲットにバインド
• /unfocus 現在のスレッドバインドを削除
• /agents アクティブな実行とバインド状態を表示
• /session idle <duration|off> フォーカス済みバインドの非アクティブ時自動フォーカス解除を確認/更新
• /session max-age <duration|off> フォーカス済みバインドのハード最大期間を確認/更新

設定:

{
session: {
threadBindings: {
  enabled: true,
  idleHours: 24,
  maxAgeHours: 0,
},
},
channels: {
discord: {
  threadBindings: {
    enabled: true,
    idleHours: 24,
    maxAgeHours: 0,
    spawnSessions: true,
    defaultSpawnContext: "fork",
  },
},
},
}

注:

• session.threadBindings.* はグローバルデフォルトを設定します。
• channels.discord.threadBindings.* は Discord の動作を上書きします。
• spawnSessions は sessions_spawn({ thread: true }) と ACP スレッド生成に対するスレッドの自動作成/バインドを制御します。デフォルト: true。
• defaultSpawnContext は、スレッドバインド生成のネイティブサブエージェントコンテキストを制御します。デフォルト: "fork"。
• 非推奨の spawnSubagentSessions/spawnAcpSessions キーは openclaw doctor --fix によって移行されます。
• アカウントでスレッドバインドが無効な場合、/focus と関連するスレッドバインド操作は利用できません。

サブエージェント、ACP エージェント、設定リファレンス を参照してください。

安定した「常時稼働」の ACP ワークスペースでは、Discord 会話を対象とするトップレベルの型付き ACP バインドを設定します。

設定パス:

• bindings[] に type: "acp" と match.channel: "discord" を設定

例:

{
agents: {
list: [
  {
    id: "codex",
    runtime: {
      type: "acp",
      acp: {
        agent: "codex",
        backend: "acpx",
        mode: "persistent",
        cwd: "/workspace/openclaw",
      },
    },
  },
],
},
bindings: [
{
  type: "acp",
  agentId: "codex",
  match: {
    channel: "discord",
    accountId: "default",
    peer: { kind: "channel", id: "222222222222222222" },
  },
  acp: { label: "codex-main" },
},
],
channels: {
discord: {
  guilds: {
    "111111111111111111": {
      channels: {
        "222222222222222222": {
          requireMention: false,
        },
      },
    },
  },
},
},
}

注:

• /acp spawn codex --bind here は現在のチャンネルまたはスレッドをその場でバインドし、以後のメッセージを同じ ACP セッションに保持します。スレッドメッセージは親チャンネルのバインドを継承します。
• バインド済みのチャンネルまたはスレッドでは、/new と /reset は同じ ACP セッションをその場でリセットします。一時スレッドバインドは、アクティブな間ターゲット解決を上書きできます。
• spawnSessions は --thread auto|here による子スレッドの作成/バインドをゲートします。

バインド動作の詳細については、ACP エージェント を参照してください。

ギルドごとのリアクション通知モード:

• off
• own (デフォルト)
• all
• allowlist (guilds.<id>.users を使用)

リアクションイベントはシステムイベントに変換され、ルーティングされた Discord セッションに添付されます。

ackReaction は、OpenClaw が受信メッセージを処理している間、確認用絵文字を送信します。

解決順序:

• channels.discord.accounts.<accountId>.ackReaction
• channels.discord.ackReaction
• messages.ackReaction
• エージェント ID 絵文字フォールバック (agents.list[].identity.emoji、なければ "👀")

注:

• Discord は Unicode 絵文字またはカスタム絵文字名を受け付けます。
• チャンネルまたはアカウントでリアクションを無効にするには "" を使用します。

チャンネル起点の設定書き込みはデフォルトで有効です。

これは /config set|unset フロー (コマンド機能が有効な場合) に影響します。

無効化:

{
channels: {
discord: {
  configWrites: false,
},
},
}

channels.discord.proxy を使用して、Discord gateway WebSocket トラフィックと起動時 REST 参照 (アプリケーション ID + 許可リスト解決) を HTTP(S) プロキシ経由でルーティングします。

{
channels: {
discord: {
  proxy: "http://proxy.example:8080",
},
},
}

アカウントごとの上書き:

{
channels: {
discord: {
  accounts: {
    primary: {
      proxy: "http://proxy.example:8080",
    },
  },
},
},
}

PluralKit 解決を有効にして、プロキシされたメッセージをシステムメンバー ID にマッピングします。

{
channels: {
discord: {
  pluralkit: {
    enabled: true,
    token: "pk_live_...", // optional; needed for private systems
  },
},
},
}

注:

• 許可リストでは pk:<memberId> を使用できます
• メンバー表示名は、channels.discord.dangerouslyAllowNameMatching: true の場合にのみ名前/slug で照合されます
• 参照は元のメッセージ ID を使用し、時間枠で制限されます
• 参照に失敗した場合、プロキシされたメッセージはボットメッセージとして扱われ、allowBots=true でない限り破棄されます

エージェントが既知の Discord ユーザーに対して決定的な送信メンションを必要とする場合は、mentionAliases を使用します。キーは先頭の @ を除いたハンドルです。値は Discord ユーザー ID です。不明なハンドル、@everyone、@here、Markdown コードスパン内のメンションは変更されません。

{
channels: {
discord: {
  mentionAliases: {
    Vladislava: "123456789012345678",
  },
  accounts: {
    ops: {
      mentionAliases: {
        OpsLead: "234567890123456789",
      },
    },
  },
},
},
}

プレゼンス更新は、ステータスまたはアクティビティフィールドを設定した場合、または自動プレゼンスを有効にした場合に適用されます。

ステータスのみの例:

{
channels: {
discord: {
  status: "idle",
},
},
}

アクティビティの例 (カスタムステータスがデフォルトのアクティビティタイプです):

{
channels: {
discord: {
  activity: "Focus time",
  activityType: 4,
},
},
}

ストリーミングの例:

{
channels: {
discord: {
  activity: "Live coding",
  activityType: 1,
  activityUrl: "https://twitch.tv/openclaw",
},
},
}

アクティビティタイプの対応表:

• 0: プレイ中
• 1: ストリーミング中 (activityUrl が必要)
• 2: 聞いている
• 3: 視聴中
• 4: カスタム (アクティビティテキストをステータス状態として使用します。絵文字は任意です)
• 5: 競争中

自動プレゼンスの例 (ランタイムヘルスシグナル):

{
channels: {
discord: {
  autoPresence: {
    enabled: true,
    intervalMs: 30000,
    minUpdateIntervalMs: 15000,
    exhaustedText: "token exhausted",
  },
},
},
}

自動プレゼンスはランタイムの可用性を Discord ステータスに対応付けます: healthy => online、degraded または unknown => idle、exhausted または unavailable => dnd。任意のテキスト上書き:

• autoPresence.healthyText
• autoPresence.degradedText
• autoPresence.exhaustedText ({reason} プレースホルダーをサポート)

Discord は DM でのボタンベースの承認処理をサポートし、任意で承認プロンプトを元のチャンネルに投稿できます。

設定パス:

• channels.discord.execApprovals.enabled
• channels.discord.execApprovals.approvers (任意。可能な場合は commands.ownerAllowFrom にフォールバック)
• channels.discord.execApprovals.target (dm | channel | both、デフォルト: dm)
• agentFilter、sessionFilter、cleanupAfterResolve

Discord は enabled が未設定または "auto" で、execApprovals.approvers または commands.ownerAllowFrom から少なくとも1人の承認者を解決できる場合、ネイティブの実行承認を自動的に有効化します。Discord はチャンネルの allowFrom、レガシーの dm.allowFrom、またはダイレクトメッセージの defaultTo から実行承認者を推測しません。Discord をネイティブ承認クライアントとして明示的に無効化するには、enabled: false を設定します。

/diagnostics や /export-trajectory などの機密性の高い所有者専用グループコマンドでは、OpenClaw は承認プロンプトと最終結果を非公開で送信します。呼び出し元の所有者に Discord 所有者ルートがある場合は、まず Discord DM を試します。利用できない場合は、Telegram など、commands.ownerAllowFrom から利用可能な最初の所有者ルートにフォールバックします。

target が channel または both の場合、承認プロンプトはチャンネルに表示されます。解決済みの承認者だけがボタンを使用できます。他のユーザーには一時的な拒否が返されます。承認プロンプトにはコマンドテキストが含まれるため、チャンネル配信は信頼済みチャンネルでのみ有効にしてください。セッションキーからチャンネル ID を導出できない場合、OpenClaw は DM 配信にフォールバックします。

Discord は他のチャットチャンネルで使用される共有承認ボタンも描画します。ネイティブ Discord アダプターは主に、承認者 DM ルーティングとチャンネルファンアウトを追加します。 これらのボタンが存在する場合、それらが主要な承認 UX です。OpenClaw は、 ツール結果がチャット承認を利用できない、または手動承認が唯一の経路であることを示す場合にのみ、 手動の /approve コマンドを含める必要があります。 Discord ネイティブ承認ランタイムがアクティブでない場合、OpenClaw は ローカルで決定論的な /approve <id> <decision> プロンプトを表示したままにします。 ランタイムはアクティブだが、ネイティブカードをどのターゲットにも配信できない場合、 OpenClaw は保留中の承認から正確な /approve コマンドを含む同一チャットのフォールバック通知を送信します。

Gateway 認証と承認解決は共有 Gateway クライアント契約に従います (plugin: ID は plugin.approval.resolve 経由で解決され、その他の ID は exec.approval.resolve 経由で解決されます)。承認はデフォルトで30分後に期限切れになります。

実行承認を参照してください。

• Message Content Intent を有効にします
• ユーザー/メンバー解決に依存する場合は Server Members Intent を有効にします
• インテントを変更した後に Gateway を再起動します

• groupPolicy を確認します
• channels.discord.guilds の下にあるギルド許可リストを確認します
• ギルドの channels マップが存在する場合、一覧にあるチャンネルだけが許可されます
• requireMention の動作とメンションパターンを確認します

有用なチェック:

openclaw doctor
openclaw channels status --probe
openclaw logs --follow

よくある原因:

• groupPolicy="allowlist" に一致する guild/channel allowlist がない
• requireMention が誤った場所に設定されている（channels.discord.guilds または channel entry 配下にある必要がある）
• 送信者が guild/channel の users allowlist によってブロックされている

典型的なログ:

• Slow listener detected ...
• stuck session: sessionKey=agent:...:discord:... state=processing ...

Discord Gateway キューの調整項目:

• 単一アカウント: channels.discord.eventQueue.listenerTimeout
• 複数アカウント: channels.discord.accounts.<accountId>.eventQueue.listenerTimeout
• これは Discord Gateway リスナーの処理だけを制御し、エージェントのターン継続時間は制御しない

Discord は、キューに入ったエージェントターンに channel 所有のタイムアウトを適用しません。メッセージリスナーは即座に引き渡し、キューに入った Discord 実行は、セッション/ツール/ランタイムのライフサイクルが完了するか処理を中断するまで、セッションごとの順序を保持します。

{
channels: {
discord: {
  accounts: {
    default: {
      eventQueue: {
        listenerTimeout: 120000,
      },
    },
  },
},
},
}

OpenClaw は接続前に Discord の /gateway/bot メタデータを取得します。一時的な失敗時は Discord のデフォルト Gateway URL にフォールバックし、ログではレート制限されます。

メタデータタイムアウトの調整項目:

• 単一アカウント: channels.discord.gatewayInfoTimeoutMs
• 複数アカウント: channels.discord.accounts.<accountId>.gatewayInfoTimeoutMs
• config が未設定の場合の env フォールバック: OPENCLAW_DISCORD_GATEWAY_INFO_TIMEOUT_MS
• デフォルト: 30000（30 秒）、最大: 120000

OpenClaw は起動時とランタイム再接続後に Discord の Gateway READY イベントを待ちます。起動の段階的実行を伴う複数アカウント構成では、デフォルトより長い起動時 READY ウィンドウが必要になる場合があります。

READY タイムアウトの調整項目:

• 起動時の単一アカウント: channels.discord.gatewayReadyTimeoutMs
• 起動時の複数アカウント: channels.discord.accounts.<accountId>.gatewayReadyTimeoutMs
• config が未設定の場合の起動時 env フォールバック: OPENCLAW_DISCORD_READY_TIMEOUT_MS
• 起動時のデフォルト: 15000（15 秒）、最大: 120000
• ランタイムの単一アカウント: channels.discord.gatewayRuntimeReadyTimeoutMs
• ランタイムの複数アカウント: channels.discord.accounts.<accountId>.gatewayRuntimeReadyTimeoutMs
• config が未設定の場合のランタイム env フォールバック: OPENCLAW_DISCORD_RUNTIME_READY_TIMEOUT_MS
• ランタイムのデフォルト: 30000（30 秒）、最大: 120000

channels status --probe の権限チェックは、数値の channel ID でのみ機能します。

slug key を使用している場合、ランタイムの照合は引き続き機能する可能性がありますが、probe は権限を完全には検証できません。

• DM 無効: channels.discord.dm.enabled=false
• DM ポリシー無効: channels.discord.dmPolicy="disabled"（legacy: channels.discord.dm.policy）
• pairing モードで pairing 承認待ち

デフォルトでは、bot が作成したメッセージは無視されます。

channels.discord.allowBots=true を設定する場合は、ループ動作を避けるために厳格な mention と allowlist ルールを使用してください。 bot をメンションする bot メッセージのみを受け入れるには、channels.discord.allowBots="mentions" を推奨します。

{
channels: {
discord: {
  accounts: {
    mantis: {
      // Mantis listens to other bots only when they mention her.
      allowBots: "mentions",
    },
    molty: {
      // Molty listens to all bot-authored Discord messages.
      allowBots: true,
      mentionAliases: {
        // Lets Molty write "@Mantis" and send a real Discord mention.
        Mantis: "MANTIS_DISCORD_USER_ID",
      },
    },
  },
},
},
}

• Discord voice receive recovery logic が含まれるように、OpenClaw を最新に保つ（openclaw update）
• channels.discord.voice.daveEncryption=true（デフォルト）を確認する
• channels.discord.voice.decryptionFailureTolerance=24（upstream デフォルト）から始め、必要な場合のみ調整する
• 次のログを監視する:
  • discord voice: DAVE decrypt failures detected
  • discord voice: repeated decrypt failures; attempting rejoin
• 自動再参加後も失敗が続く場合は、ログを収集し、discord.js #11419 と discord.js #11449 の upstream DAVE 受信履歴と比較する