MENU

OpenClaw講座 第4回:Discord連携|AIエージェントと会話できる環境を構築する

前回の第3回では、SOUL.mdやHEARTBEAT.mdを使ってエージェントの人格と行動ルールを設定しました。今回は、そのエージェントと実際に会話するための窓口を作ります。OpenClawではDiscordを通じてエージェントに指示を出し、報告を受け取ることができます。

この記事の手順を終えれば、Discordのチャンネルでエージェントにメンションを付けてメッセージを送るだけで、AIが応答してくれる環境が整います。

前回の記事はこちら:OpenClaw講座 第3回:初めてのエージェント作成|SOUL.md・USER.md・AGENTS.mdの設定方法

目次

準備するもの

  • Discordのアカウント
  • 第2回で構築したOpenClaw環境(インストール・認証が完了している状態)
  • ブラウザ(Discord Developer Portalにアクセスするため)

所要時間の目安は30分〜1時間程度です。Discord Developer Portalでの設定が初めての方は、少し余裕を持って取り組んでください。

ステップ1:AI専用のDiscordサーバーを作る

まず、OpenClawのエージェント用に新しいDiscordサーバーを作成します。普段使いのサーバーではなく、AI専用のサーバーを新しく作るのがおすすめです。理由は、エージェントに管理者権限を付与するため、他のメンバーがいるサーバーだとセキュリティ上のリスクがあるからです。

Discordの設定から「開発者モード」もONにしておいてください。チャンネルIDの取得などで必要になります。

ステップ2:Discord Developer PortalでBotを作成する

ブラウザで以下のURLにアクセスします。

https://discord.com/developers/applications

アプリケーションの作成

「New Application」をクリックして、アプリケーション名を入力します。エージェントの名前を付けるとわかりやすいです。アイコンも設定できますが、後から変更可能なので最初はスキップしても問題ありません。

Botの設定

左メニューから「Bot」を選択し、以下の設定を行います。

  • Presence Intent → ONにする
  • Server Members Intent → ONにする
  • Message Content Intent → ONにする

この3つのIntentが全てONになっていないと、Botがメッセージを受け取れません。忘れがちなポイントなので注意してください。

一般権限で「管理者」にチェックを入れます。

Botトークンの取得

「Reset Token」をクリックしてBotトークンを取得します。このトークンは一度しか表示されないので、必ずコピーして安全な場所に保存しておいてください。紛失した場合は再度「Reset Token」で新しいトークンを生成できますが、古いトークンは無効になります。

ステップ3:BotをDiscordサーバーに招待する

左メニューから「OAuth2」を選択します。

「OAuth2 URL Generator」で以下の設定を行います。

  • SCOPESで「BOT」にチェック
  • Bot Permissionsで「管理者」にチェック

画面下部に生成されたURLをコピーして、ブラウザの新しいタブで開きます。ステップ1で作成したAI専用サーバーを選択して、認証作業を完了させてください。

ステップ4:OpenClawとDiscord Botを紐づける

ターミナルに戻ります。第2回のセットアップでチャンネル選択をスキップした場合は、設定画面を開き直してください。

セットアップの流れで「Discord bot token」の入力を求められたら、ステップ2で取得したBotトークンを貼り付けます。

続けて以下の設定を行います。

Configure Discord channels access? → YES

チャンネルアクセスの設定画面が表示されます。3つの選択肢があります。

  • Allowlist (recommended):指定したチャンネルだけでBotが反応します。セキュリティを重視する場合におすすめです
  • Open (allow all channels):サーバー内の全チャンネルでBotが反応します。個人利用や小規模なサーバーならこれでOKです
  • Disabled (block all channels):全チャンネルでBotの反応を無効にします

最初はOpenで始めて問題ありません。運用に慣れてきたらAllowlistに切り替えて、エージェントが反応するチャンネルを制限する運用がおすすめです。

Configure skills now? → NO

スキル(拡張機能)の設定は後から追加できるので、ここではスキップします。

Enable hooks? → Skip for now

Shift+Spaceで「Skip for now」を選択してEnterを押します。

How do you want to hatch your bot?

「Hatch in TUI (recommended)」を選べば、ターミナル上でBotの起動を確認できます。どれを選んでも動作に違いはないので、好みで選んでOKです。

ステップ5:動作確認

Discordを開いて、Botを招待したサーバーのチャンネルで、Botに対してメンション付きでメッセージを送ってみましょう。

@BotName こんにちは、自己紹介をお願いします

Botから返答が来れば、Discord連携は成功です。第3回で設定したSOUL.mdの内容が反映された口調で返答してくれるはずです。

もし反応がない場合は、以下を確認してください。

  • openclaw gateway status でOpenClawが起動しているか
  • Discord Developer Portalで3つのIntent(Presence / Server Members / Message Content)が全てONになっているか
  • Botがサーバーに正しく招待されているか
  • Botトークンが正しく入力されているか

運用で気をつけるべきこと

Bot同士の無限ループに注意

Discord上で複数のBotが稼働している場合、Bot同士がメッセージに反応し合って無限ループに陥ることがあります。これは冗談ではなく、実際に起きる問題です。

私の環境でも、エージェント同士がメンションなしで会話できる設定にしていたところ、エラーメッセージに対してAIが反応し、そのエラーにまたAIが反応するという無限ループに陥ったことがあります。「止まって」「反応するな」とメッセージを送っても止まらず、最終的にはMac miniのターミナルに直接アクセスしてプロセスを強制停止する必要がありました。

しかも、2026年4月の仕様変更以降は従量課金になっているため、無限ループが続く間もトークンが消費され続けます。放置すると高額請求につながります。

対策としては、エージェントが他のBotのメッセージに反応しない設定にしておくことが基本です。また、複数のエージェントを同じサーバーで運用する場合は、チャンネルを分けてお互いのメッセージが見えないようにするのが安全です。

チャンネル設計のポイント

個人利用であれば1つのチャンネルで十分ですが、エージェントを複数体運用する場合や、チームで使う場合は、チャンネルを分けることを検討してください。

たとえば、エージェントごとにチャンネルを分ける構成が考えられます。秘書エージェントには「#秘書」、経理エージェントには「#経理」、マーケティングエージェントには「#マーケ」というように。こうすることで、各エージェントが自分宛のメッセージだけに反応し、他のエージェントのやり取りに干渉しなくなります。

従量課金を意識した運用

前述の通り、2026年4月以降はAPIの利用が従量課金になっています。エージェントが不要なメッセージに反応しないよう、Allowlistでチャンネルを絞っておくことがコスト管理にもつながります。

また、HEARTBEATで設定した定期タスクもトークンを消費します。特に30分間隔のHeartbeatをOpusモデルで24時間稼働させると、それだけで月数万円のコストになる場合があります。モデルの使い分け(日常的なタスクはSonnet、高度な判断が必要なときだけOpus)も検討してください。コスト試算の詳細は「OpenClawで月額50万円!? Claudeの従量課金化で何が起きたのか」で解説しています。

まとめ

今回の手順で、Discordを通じてAIエージェントに話しかけられる環境が整いました。第2回でインストール、第3回で人格を設定し、今回で対話の窓口ができました。ここまでの3回分の設定が全て連動して、あなた専用のAIエージェントが動いています。

ここからは、実際に日々の業務でエージェントを使いながら、SOUL.mdの調整やHEARTBEATのタスク追加を繰り返していくフェーズです。最初から完璧を目指す必要はありません。使いながら育てていくのが、エージェント運用のコツです。


NEXT INNOVAITION株式会社 OpenClawの導入でお困りの方は、お気軽にご相談ください。 80台以上のOpenClaw導入実績。

公式サイト:https://ai-advisors.jp/

よかったらシェアしてね!
  • URLをコピーしました!
  • URLをコピーしました!

コメント

コメントする

目次