【完全ガイド】Clawdbot を Discord から操作できるようにする設定手順

はじめに

この記事では、AI アシスタント「Clawdbot」を Discord と連携させ、Discord のチャンネルから AI に話しかけられるようにする手順を解説します。

実際に設定作業を行いながら試行錯誤した内容をまとめたので、つまずきやすいポイントも含めて紹介します。

この記事でできるようになること

✅ Discord から @ボット名質問 で AI に話しかけられる
✅ Clawdbot から Discord にメッセージを送信できる
✅ スマホの Discord アプリからも操作可能

目次

必要なもの
Step 1: Discord Developer Portal でボットを作成
Step 2: ボットをサーバーに招待
Step 3: Clawdbot の設定
Step 4: Gateway の再起動と動作確認
トラブルシューティング
まとめ

（以下は、Discordからnano-banana proを呼び出し画像生成した例）

必要なもの

Discord アカウント
自分が管理者権限を持つ Discord サーバー（なければ新規作成）
Clawdbot がインストールされた環境
ブラウザ（Discord Developer Portal にアクセス用）

Step 1: Discord Developer Portal でボットを作成

1.1 Developer Portal にアクセス

https://discord.com/developers/applications にアクセスし、Discord アカウントでログインします。

1.2 新しいアプリケーションを作成

右上の 「New Application」 をクリック
アプリケーション名を入力（例：MoltApp、MyBotなど）
利用規約に同意して 「Create」 をクリック

1.3 ボットトークンを取得

左メニューの 「Bot」 をクリック
「Reset Token」 をクリックしてトークンを生成
トークンをコピーして安全な場所に保存

⚠️ トークンは一度しか表示されません！必ずコピーして保存してください。

1.4 Privileged Gateway Intents を有効化（超重要！）

Bot ページの下部にある 「Privileged Gateway Intents」 セクションで、以下を すべて ON にします：

Intent	説明
PRESENCE INTENT	ユーザーのオンライン状態を取得
SERVER MEMBERS INTENT	サーバーメンバー情報を取得
MESSAGE CONTENT INTENT	メッセージ内容を読み取る（必須！）

🚨 MESSAGE CONTENT INTENT が OFF だと、ボットはメッセージの内容を読めず、メンションしても反応しません！ これが最もハマりやすいポイントです。

最後に 「Save Changes」 をクリックして保存します。

Step 2: ボットをサーバーに招待

2.1 招待リンクを生成

左メニューの 「OAuth2」→「URL Generator」 を開く
SCOPES セクションで bot にチェック
BOT PERMISSIONS セクションで以下にチェック：
- ✅ View Channels
- ✅ Send Messages
- ✅ Read Message History
- ✅ Add Reactions（任意）
ページ下部に生成された URL をコピー

2.2 サーバーにボットを追加

コピーした URL をブラウザで開く
ボットを追加するサーバーを選択
「認証」 をクリック

💡 サーバーが表示されない場合
「表示するアイテムがありません」と出る場合は、そのサーバーで「サーバー管理」権限が必要です。自分専用のテストサーバーを作成することをお勧めします。

2.3 サーバーを新規作成する場合

Discord アプリ左側の 「＋」 をクリック
「サーバーを作成」 を選択
「自分と友達のため」→ サーバー名を入力 → 作成
再度招待 URL を開き、新しいサーバーを選択

Step 3: Clawdbot の設定

3.1 サーバー ID とチャンネル ID を取得

まず、Discord の開発者モードを有効化します：

Discord の設定（⚙️）を開く
「アプリ設定」→「詳細設定」
「開発者モード」を ON

次に、ID をコピーします：

対象	取得方法
サーバー ID	サーバーアイコンを右クリック →「サーバー ID をコピー」
チャンネル ID	チャンネル名を右クリック →「チャンネル ID をコピー」

3.2 設定ファイルを編集

~/.clawdbot/clawdbot.json を編集します：

{
  "channels": {
    "discord": {
      "enabled": true,
      "token": "ここにボットのトークンを貼り付け",
      "groupPolicy": "allowlist",
      "guilds": {
        "サーバーID": {
          "channels": {
            "チャンネルID": {
              "allow": true,
              "enabled": true
            }
          }
        }
      }
    }
  }
}

または、コマンドで設定することもできます：

clawdbot configure --section discord

Step 4: Gateway の再起動と動作確認

4.1 Gateway を再起動

設定を反映するため、Gateway を再起動します：

clawdbot gateway restart

4.2 Clawdbot → Discord のテスト

Clawdbot から Discord にメッセージを送信してみます：

message action=send channel=discord target="チャンネルID" message="テストメッセージ"

Discord にメッセージが届けば成功です！✅

4.3 Discord → Clawdbot のテスト

Discord のチャンネルで、ボットをメンションします：

@MoltApp こんにちは！

⚠️ @ を手入力するのではなく、入力候補からボットを選択してメンションしてください。

Clawdbot が返信すれば成功です！✅

4.4 診断コマンド

問題がある場合は診断を実行します：

clawdbot doctor --non-interactive

トラブルシューティング

❌ 「401: Unauthorized」エラー

原因： ボットトークンが無効、または期限切れ

解決策：

Developer Portal → Bot → Reset Token で新しいトークンを生成
設定ファイルのトークンを更新
Gateway を再起動

❌ 「Unknown Channel」エラー

原因： 指定したチャンネルが存在しない、またはボットがアクセスできない

解決策：

チャンネル ID が正しいか確認
ボットがそのチャンネルを見れる権限があるか確認
チャンネルの権限設定でボットを許可

❌ メンションしても反応しない

原因： MESSAGE CONTENT INTENT が無効

解決策：

Developer Portal → Bot → Privileged Gateway Intents
MESSAGE CONTENT INTENT を ON にする
Save Changes
Gateway を再起動

clawdbot doctor を実行すると、MESSAGE CONTENT INTENT が無効の場合は警告が表示されます：

discord default: Message Content Intent is disabled. Bot may not see normal channel messages.

❌ サーバー選択時「表示するアイテムがありません」

原因： サーバー管理権限がない

解決策：

自分が管理者のサーバーを使用する
または新しいサーバーを作成する

❌ ボットがオフライン表示

原因： Gateway が起動していない、または接続エラー

解決策：

clawdbot gateway status
clawdbot gateway restart

設定の全体像

┌─────────────────────────────────────────────────────────────┐
│                    Discord Developer Portal                 │
│  ┌─────────────────────────────────────────────────────┐    │
│  │ Application (MoltApp)                               │    │
│  │  ├─ Bot Token: xxxxxxxxxx                           │    │
│  │  └─ Intents: MESSAGE CONTENT ✅                     │    │
│  └─────────────────────────────────────────────────────┘    │
└─────────────────────────────────────────────────────────────┘
                              │
                              ▼
┌─────────────────────────────────────────────────────────────┐
│                      Discord Server                         │
│  ┌─────────────────────────────────────────────────────┐    │
│  │ Server ID: xxxxxxxxxxxxxxxxxxx                      │    │
│  │  └─ Channel ID: xxxxxxxxxxxxxxxxxxx                 │    │
│  │      └─ Bot: MoltApp (オンライン)                     │    │
│  └─────────────────────────────────────────────────────┘    │
└─────────────────────────────────────────────────────────────┘
                              │
                              ▼
┌─────────────────────────────────────────────────────────────┐
│                        Clawdbot                             │
│  ┌─────────────────────────────────────────────────────┐    │
│  │ ~/.clawdbot/clawdbot.json                           │    │
│  │  ├─ discord.enabled: true                           │    │
│  │  ├─ discord.token: (Bot Token)                      │    │
│  │  └─ discord.guilds.{ServerID}.channels.{ChannelID}  │    │
│  └─────────────────────────────────────────────────────┘    │
└─────────────────────────────────────────────────────────────┘

使い方

Discord から Clawdbot に話しかける

@MoltApp 今日のニュースを教えて
@MoltApp 天気予報を確認して
@MoltApp リマインダーを設定して

Clawdbot から Discord にメッセージを送る

message action=send channel=discord target="チャンネルID" message="送信したいメッセージ"

チェックリスト

設定完了の確認用チェックリストです：

Discord Developer Portal でアプリケーション作成済み
Bot Token を取得済み
MESSAGE CONTENT INTENT を ON にした ← 最重要！
ボットをサーバーに招待済み
サーバー ID を取得済み
チャンネル ID を取得済み
clawdbot.json に設定を追加済み
Gateway を再起動済み
Clawdbot → Discord の送信テスト成功
Discord → Clawdbot のメンションテスト成功

まとめ

Clawdbot と Discord の連携設定は、以下の流れで行います：

Discord Developer Portal でボットを作成し、MESSAGE CONTENT INTENT を有効化
OAuth2 URL Generator でボットをサーバーに招待
clawdbot.json にトークン・サーバーID・チャンネルIDを設定
Gateway を再起動 して動作確認

最もハマりやすいポイントは MESSAGE CONTENT INTENT の有効化 です。これを忘れると、ボットはメッセージを読めないため、メンションしても一切反応しません。

設定がうまくいかない場合は、clawdbot doctor コマンドで診断すると原因が特定しやすくなります。

この記事が参考になれば幸いです！質問があればコメントでお気軽にどうぞ 🙌