OpenClawをDiscordに設定する: DMペアリング、サーバーチャンネル、音声

Name

Soren Atelier

更新日 2026/4/8

OpenClaw を Discord で使いたいなら、最も速くて安全な手順は次のとおりです。Discord ボットを作成し、OpenClaw を動かしているマシンにボットトークンを設定し、gateway を起動し、最初の DM ペアリングを承認してから、プライベートサーバーを guild ワークスペースに変えます。

これが重要なセットアップ手順なのは、Discord 上の OpenClaw が単なる「もう 1 つの bot」ではないからです。Discord の各チャンネルは、それぞれ独立したコンテキスト、承認、ルーティングルールを持つ個別のエージェントセッションになり得ます。ペアリング、allowlist、メンション設定を省略すると、ボットトークンが正しくてもセットアップは壊れているように感じられることがよくあります。

OpenClaw Discord docs を探しているなら、一次情報は OpenClaw の Discord チャンネルガイドです: Discord setup docs (opens in a new tab)。このページはその上に載る実践編です。最初に何を設定するべきか、何を非公開に保つべきか、そして DM テストから実用的なプライベート Discord ワークスペースへどう移行するかを説明します。

まず製品全体の位置づけを知りたいなら、NVIDIA NemoClaw vs OpenClaw vs ZeroClaw: Differences, Pi Agent, and Nanobot in 2026 を読んでください。もし本当に欲しいのが Discord ベースのアシスタントではなく、リポジトリローカルなコーディング支援なら、How to Use Codex と How to Use OpenCode のほうが適しています。

すぐ答え: Discord で OpenClaw を最短で動かすには？

信頼できるセットアップ順は次のとおりです。

1. Discord ボットを作成する
2. 必要な intents を有効にする
3. ボットトークンを安全に設定する
4. gateway を起動する
5. 最初の DM ペアリングを承認する
6. サーバーを guild allowlist に追加する
7. 返信に @mention が必要か決める
8. テキストチャットが安定してから voice を追加する

Discord 上の OpenClaw で実際に得られるもの

Discord 上の OpenClaw は、単一の共有ボットメモリではありません。

現在の OpenClaw ドキュメントによると、Discord では次をサポートしています。

• DMs
• guild テキストチャンネル
• forum チャンネルの thread ワークフロー
• native command handling
• approval buttons
• optional voice-channel sessions

重要なのは、実際の形が単なる DM bot ではなく、エージェントセッションの Discord ワークスペース だという点です。

実際には、次のように使えます。

• Discord DMs を最初の低リスクなペアリング手段にする
• 各 guild チャンネルで別々のコンテキストを持たせる
• 承認とルーティングを、リクエストが発生した Discord 上の場所に紐づける
• 必要なら後から voice を重ねる

クイックスタート

公式 Discord docs では、ボットを作成し、トークンを設定してから gateway を起動する方法が推奨されています。最小構成は次のようになります。

export DISCORD_BOT_TOKEN="YOUR_BOT_TOKEN"
openclaw config set channels.discord.token --ref-provider default --ref-source env --ref-id DISCORD_BOT_TOKEN
openclaw config set channels.discord.enabled true --strict-json
openclaw gateway

OpenClaw がすでにバックグラウンドプロセスとして動いている場合は、新しいコピーを起動せず gateway を再起動してください。

その後、Discord でボットに DM を送り、ペアリングコードを承認します。

これが、「Discord ボットトークンはある」状態から「OpenClaw が Discord から実際に到達可能」な状態へ進む最短ルートです。

ステップ 1: Discord ボットを正しく作成する

公式の Discord setup docs (opens in a new tab) では、OpenClaw は標準的な Discord bot の流れを推奨しています。

1. Discord Developer Portal に行く
2. 新しい application を作成する
3. bot を追加する
4. bot token をコピーする

OAuth URL の baseline scopes は次です。

• bot
• applications.commands

一般的な baseline permissions は次です。

• View Channels
• Send Messages
• Read Message History
• Embed Links
• Attach Files

本当に必要な場合を除き、Administrator は避けてください。最小権限のプライベートサーバーのほうが、より安全なデフォルトです。

ステップ 2: 他をデバッグする前に、正しい intents を有効にする

これは最も時間を失いやすいポイントの 1 つです。

OpenClaw の Discord docs では、次の intents が挙げられています。

• Message Content Intent: 必須
• Server Members Intent: 推奨。role allowlist と name matching に必要
• Presence Intent: 任意

ボットがサーバーに参加しているのに挙動がおかしい場合、intent の不足はまず確認すべき項目です。

ステップ 3: トークンを chat に出さない

Discord bot token は秘密情報です。agent の chat に貼り付けないでください。

OpenClaw を動かしているマシン上で、environment variable か SecretRef ベースの config path を使ってください。ドキュメントでは、トークンをローカルで設定し、その local secret に config を紐づける方法が明確に推奨されています。

安全な基本形は次のとおりです。

export DISCORD_BOT_TOKEN="YOUR_BOT_TOKEN"
openclaw config set channels.discord.token --ref-provider default --ref-source env --ref-id DISCORD_BOT_TOKEN
openclaw config set channels.discord.enabled true --strict-json

その後、gateway を起動します。

openclaw gateway

これで text chat が動かない場合は、guild policy に触る前に token、intents、gateway を先に確認してください。

ステップ 4: まず Discord DM でペアリングする

OpenClaw の現在の Discord docs では、DM が最も簡単な最初のチェックポイントとして扱われています。

実際の流れは次のとおりです。

1. gateway が動いていることを確認する
2. Discord で bot に DM する
3. pairing code を待つ
4. 既存の OpenClaw チャンネルまたは CLI からその code を承認する

DM から始める理由:

• bot token と routing が正しいか最短で確認できる
• 最初のテストから guild-level policy を外せる
• サーバー全体を workspace に変える前に bot が生きていることを確認できる

最初の DM に反応がない場合は、次へ進まないでください。たいていの原因は次のいずれかです。

• token が間違っている
• gateway が動いていない
• DMs がブロックされている
• intents が不足している

ステップ 5: プライベート Discord サーバーを guild ワークスペースにする

DM ペアリングが動いたら、次に有効なのは「もっとチャンネルを増やす」ことではありません。「1 つのプライベート Discord サーバーを正しく構成する」ことです。

公式 docs では、guild ワークスペースを推奨しています。理由は、各チャンネルが独立した OpenClaw セッションを持つからです。Discord がここで面白いのはまさにその点です。たとえば次のようなチャンネルを作れます。

• #coding
• #research
• #home
• #ops

そして、それぞれに異なるコンテキストを持たせられます。

最初の config の変更は、サーバーを guild allowlist に追加することです。

{
  channels: {
    discord: {
      groupPolicy: "allowlist",
      guilds: {
        YOUR_SERVER_ID: {
          requireMention: true,
          users: ["YOUR_USER_ID"],
        },
      },
    },
  },
}

これは、bot が応答する場所と利用できる人を制限できるため、より安全なデフォルトです。

ステップ 6: サーバーで @mention を必須にするか決める

デフォルトでは、Discord 上の OpenClaw は便利さより安全性を優先しています。

共有サーバーでは、これは普通は正しい判断です。しかし、あなたと bot だけのプライベートサーバーなら、すべてのメッセージで @mention を要求すると使い勝手が悪くなります。

docs では、特定の guild で mention-only 行動を無効化できることが示されています。

{
  channels: {
    discord: {
      guilds: {
        YOUR_SERVER_ID: {
          requireMention: false,
        },
      },
    },
  },
}

これは信頼できるサーバーでのみ使ってください。共有サーバーでは、mention 要件は有効のままにしてください。

ステップ 7: 「共有コンテキスト」を期待する前に memory model を理解する

これは Discord docs の中でも特に重要な概念です。

OpenClaw は、すべての Discord 会話を 1 つの巨大な shared memory pool として扱うわけではありません。

docs では次のように説明されています。

• DMs はメインの agent session にまとまることがある
• guild チャンネルは分離された session である
• long-term memory はすべての guild チャンネルに同じようには自動読み込みされない

つまり、#research と #home が自動的に同じ assistant thread のように振る舞うとは期待しないでください。その分離は有用ですが、そこにあると理解していないと驚くことになります。

どこでも安定した shared instructions が必要なら、チャンネル memory に頼るのではなく、global agent instruction layer に置いてください。

テキストチャットが動いてから voice を追加する

OpenClaw は Discord voice channels もサポートしていますが、それは text が安定してからにしてください。

docs によると、voice には次が必要です。

• native commands enabled
• channels.discord.voice の設定
• 対象 voice channel での Connect と Speak 権限

最小の auto-join 例は次のようになります。

{
  channels: {
    discord: {
      voice: {
        enabled: true,
        autoJoin: [
          {
            guildId: "123456789012345678",
            channelId: "234567890123456789",
          },
        ],
      },
    },
  },
}

これは強力ですが、最初の到達点ではありません。まず次を確認してください。

• DM pairing が動く
• guild text routing が動く
• allowlist が想定どおりに機能する

そのうえで voice を追加します。

よくある落とし穴

ボットトークンを chat に送る

やめてください。OpenClaw を動かしているマシン上でローカルに token を設定し、その local secret を OpenClaw config から参照してください。

DM ペアリングより先に guild チャンネルを試す

DM のチェックを飛ばすと、token、intents、gateway、guild policy、mention を一度にデバッグすることになります。

プライベートサーバーで requireMention を有効にしたまま、bot が壊れたと思い込む

プライベートサーバーでは、bot は正常でも、mention されるまでメッセージを無視しているだけかもしれません。それは故障ではなく policy です。

Discord の全チャンネルで 1 つの共有 memory を期待する

guild チャンネルは分離されるように設計されています。これは便利なことが多いですが、1 つの global chat history を期待していると驚きます。

text chat が動く前に voice を有効にする

voice はデバッグの層を 1 つ増やします。まずは text から始めてください。

トラブルシューティングチェックリスト

Discord 上の OpenClaw が応答しない場合、次の順で確認してください。

1. gateway が動いている
2. bot token が有効で、ローカルに設定されている
3. Message Content Intent が有効
4. pairing 用の DMs が許可されている
5. guild channels を試しているなら、サーバーが guild allowlist に入っている
6. requireMention が想定どおりに設定されている
7. sender が user または guild policy によってブロックされていない

OpenClaw docs では、診断に役立つコマンドも案内されています。

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

この Discord セットアップが適切でない場合

次のような目的なら、ここから始めないでください。

• repo-local な coding assistant が欲しい
• embedded deployment 用の zero-UI runtime が欲しい
• OpenClaw の代替を一般論として比較したい

その場合は、次のほうが適切です。

• How to Use Codex
• How to Use OpenCode
• NVIDIA NemoClaw vs OpenClaw vs ZeroClaw: Differences, Pi Agent, and Nanobot in 2026

FAQ

OpenClaw Discord setup で最初にテストすべきことは何ですか？

まず Discord DM pairing をテストしてください。token、gateway、基本的な routing が動いているかを最短で確認できます。

すべての Discord チャンネルで @mention が必要ですか？

必ずしもそうではありません。プライベートサーバーでは、requireMention: false を望む人が多いでしょう。共有サーバーでは、mention 要件を有効のままにするほうが安全です。

OpenClaw の Discord bot はオンラインなのに返信しないのはなぜですか？

最も多い原因は、token の不備、Message Content Intent の不足、停止した gateway、ブロックされた DMs、または allowlist や mention 条件を満たさない guild policy です。

Discord voice は最初に有効化すべきですか？

いいえ。まず DM pairing と guild text channels を動かし、その後に voice を追加してください。

これは一般的な「How to use OpenClaw」ガイドより優れていますか？

実用的な検索意図に対しては、はい。Discord setup にはより明確な役割があります。OpenClaw 全体を 1 ページで要約するのではなく、1 つの実際の integration を動かすことに集中できるからです。

関連ガイド

• NVIDIA NemoClaw vs OpenClaw vs ZeroClaw: Differences, Pi Agent, and Nanobot in 2026
• How to Use Codex
• How to Use OpenCode
• Parallel Code Agents Explained
• Cursor Review: Where It Still Wins and Where It Still Breaks