Discord アクティビティ

Discord Activities を使用すると、エージェントはインタラクティブで自己完結型の HTML ウィジェットを現在の Discord チャンネルに投稿できます。メッセージには Open widget ボタンが含まれ、クリックすると Discord 内でウィジェットが起動します。この機能はデフォルトで無効です。OpenClaw は、channels.discord.activities が存在し、クライアントシークレットを解決できる場合にのみ、Activity HTTP ルート、show_widget エージェントツール、起動ボタンハンドラーを登録します。非推奨の discord_widget エイリアスは、1 リリースの間、引き続き使用できます。

前提条件

既存の OpenClaw Discord ボット
OpenClaw Gateway に到達可能な公開 HTTPS ホスト名
ボットの Discord アプリケーションに対して Activities と OAuth2 を設定する権限

任意の HTTPS リバースプロキシまたはトンネルを使用できます。名前付き Cloudflare Tunnel を使用すると、Gateway ポートを直接公開せずに安定したホスト名を利用できます。

# ~/.cloudflared/config.yml
tunnel: openclaw-discord
credentials-file: /home/you/.cloudflared/TUNNEL-ID.json
ingress:
  - hostname: openclaw.example.com
    service: http://127.0.0.1:18789
  - service: http_status:404

cloudflared tunnel login
cloudflared tunnel create openclaw-discord
cloudflared tunnel route dns openclaw-discord openclaw.example.com
cloudflared tunnel run openclaw-discord

通常の Gateway 認証は有効なままにしてください。公開されるのは Activity プレフィックスのみであり、Plugin 自体が OAuth、Activity インスタンスのメンバーシップ、チャンネルの関連付け、セッション、1 回限りのドキュメントケイパビリティを検証します。

セットアップ

Gateway を HTTPS 経由で公開する

トンネルまたはリバースプロキシを起動し、Activities の設定を追加した後に https://openclaw.example.com/discord/activity/ が Gateway に到達することを確認します。例のホスト名は自分のものに置き換えてください。

Discord で Activities を有効にする

Discord Developer Portal で既存のボットアプリケーションを開きます。Activities を開いて Activities を有効にし、URL マッピングを作成します。

プレフィックス: ROOT（/）
ターゲット: openclaw.example.com/discord/activity

ターゲットは公開ホスト名に /discord/activity を加えたもので、末尾にスラッシュは付けません。

OAuth2 クライアントシークレットをコピーする

Developer Portal で OAuth2 を開きます。Discord ではリダイレクト URI が少なくとも 1 つ必要なため、アプリケーションにまだ設定されていない場合は、ループバックアドレスなどのローカルプレースホルダーを追加してください。Activity のリターンフローは Embedded App SDK が処理します。アプリケーションのクライアントシークレットをコピーするか、リセットします。これは認証情報として扱い、チャット、ログ、またはコミットされる設定ファイルに貼り付けないでください。

OpenClaw を設定する

ウィジェットを提供する Discord アカウントに、次のブロックを 1 つ追加します。

{
  channels: {
    discord: {
      token: "${DISCORD_BOT_TOKEN}",
      activities: {
        clientSecret: "${DISCORD_CLIENT_SECRET}",
        // 省略可能。デフォルトでは、起動時に取得したボットアプリケーション ID が使用されます。
        applicationId: "YOUR_DISCORD_APPLICATION_ID",
      },
    },
  },
}

DISCORD_CLIENT_SECRET が設定されている場合は、ブロックから clientSecret を省略できます。オプトインするには、ブロック自体は必ず残す必要があります。通常の Discord アクセス設定は別に適用されます。たとえば、allowFrom は引き続きエージェントに DM を送信できるユーザーを制御しますが、チャンネルにすでに投稿されたウィジェットを開けるユーザーは制御しません。

再起動してテストする

Gateway を再起動します。Discord の会話で、インタラクティブなウィジェットを表示するようエージェントに依頼します。エージェントが show_widget を呼び出したら、投稿されたメッセージの Open widget をクリックします。

セキュリティモデル

ウィジェットのメタデータが返される前に、OAuth によって Discord ユーザーを識別します。
Discord の Get Activity Instance API は、OAuth ユーザーが現在の Activity インスタンスに参加していることを確認する必要があります。インスタンスのチャンネルは、ウィジェットが投稿されたチャンネルと一致する必要があります。
Discord によってそのチャンネルへの参加を許可された全員が、そのチャンネルのウィジェットを開けます。対象者を限定するには、Discord のチャンネル権限を使用してください。OpenClaw のコマンドおよび DM の許可リストは、すでに投稿されたチャンネルコンテンツへのアクセスを付与または削除しません。
OAuth セッションは 15 分後に期限切れになります。ウィジェットのドキュメントケイパビリティは 60 秒後に期限切れになり、1 回だけ使用できます。
ウィジェットは 7 日後に期限切れになり、Discord Plugin インスタンスごとに最大 64 個が保持されます。
ウィジェットの HTML はエージェントによって作成されるため、信頼できるコンテンツとして扱う必要があります。不具合のあるウィジェットに公開されたくないシークレットを埋め込まないでください。
ウィジェットは、独自の入れ子になったフレーム内を移動できます。sandbox="allow-scripts" iframe はトップレベルのナビゲーション、ポップアップ、同一オリジンへのアクセスをブロックし、Content Security Policy はネットワーク接続と外部リソースをブロックします。これらの制御は多層防御であり、ウィジェットを作成したエージェントに対するセキュリティ境界ではありません。
Activities が無効な場合、/discord/activity は一切登録されません。

有効にすると、公開 Activity シェルとトークン交換ルートがトンネル経由で到達可能になります。有効な OAuth セッションと 1 回限りのドキュメントケイパビリティがなければ、ウィジェットの HTML は公開されません。

トラブルシューティング

Activity に「Gateway offline」と表示される

トンネルが実行中であり、Gateway の実際のバインドポートにルーティングされていることを確認する
Developer Portal のターゲットに /discord/activity が含まれていることを確認する
Discord または OpenClaw の設定を変更した後、Gateway を再起動する
Activities のクライアントシークレットが見つからないことを示す 1 行の警告が Gateway ログにないか確認する

Discord で空白ページが開く、または `blocked:csp` が報告される

URL マッピングが ROOT を使用し、2 つ目の /discord/activity セグメントを追加していないことを確認する
シェル、shell.js、SDK モジュールのすべてが Discord プロキシ経由で返されることを確認する
Gateway ログで /discord/activity/ 配下のリクエストを調べる

ウィジェットのネットワークリクエストは意図的にブロックされます。ウィジェットに必要な CSS、JavaScript、画像、データはすべてインライン化してください。エージェントが投稿したチャンネルからボタンを起動してください。クリックされると OpenClaw は起動をサーバー側で追跡するため、Discord がボタンのカスタム ID を省略または破損した場合でも、新しい起動記録から正確なウィジェットを特定できます。カスタム ID と起動記録のどちらからも特定できない場合、OpenClaw はそのチャンネルで最後に投稿された有効なウィジェットを開きます。古いウィジェットも、カスタム ID が保持されたボタンから引き続き指定できます。

「You cannot launch Activities in this channel」

Discord はフォーラム投稿のスレッドから Activities を起動しません。OpenClaw はそこにウィジェットのメッセージとボタンを投稿できますが、Activity は代わりに通常のテキストチャンネルから起動してください。この制限は OpenClaw ではなく Discord によるものです。

Overview

Mainstream messaging

Developer and self-hosted

Regional platforms

Configuration

Discord アクティビティ

前提条件

セットアップ

セキュリティモデル

トラブルシューティング

Activity に「Gateway offline」と表示される

Discord で空白ページが開く、または `blocked:csp` が報告される

「Widget unavailable」

「You cannot launch Activities in this channel」

​前提条件

​セットアップ

​セキュリティモデル

​トラブルシューティング

​Activity に「Gateway offline」と表示される

​Discord で空白ページが開く、または blocked:csp が報告される

​「Widget unavailable」

​「You cannot launch Activities in this channel」

前提条件

セットアップ

セキュリティモデル

トラブルシューティング

Activity に「Gateway offline」と表示される

Discord で空白ページが開く、または `blocked:csp` が報告される

「Widget unavailable」

「You cannot launch Activities in this channel」