OpenClaw 向け Discord スキル

OpenClaw Discord スキル概要

Discord スキルは、Discord API を介して OpenClaw を Discord サーバーに接続し、AI エージェントを強力な Discord アシスタントに変えます。インストールすると、メッセージの送信、スレッドの管理、投票の実施、絵文字のアップロード、さらにはモデレーションまで、すべて自然言語コマンドで操作できます。

Discord は、開発者コミュニティ、オープンソースプロジェクト、チームコミュニケーションで最も人気のあるプラットフォームの一つです。OpenClaw Discord スキルを使えば、ターミナルと Discord の間でコンテキストスイッチする必要がなくなります。コミュニティチャンネルの監視、質問への回答、サーバー設定の管理など、OpenClaw との簡単な会話で完了します。

一般的なワークフロー：

1. OpenClaw に Discord チャンネルでメッセージを送信したり、最近のアクティビティを確認するよう依頼します。
2. エージェントが適切なアクション（例：sendMessage、readMessages）で Discord API を呼び出します。
3. 結果が読みやすい要約で返されます — コンテキストスイッチは不要です。

Discord スキルの前提条件

Discord スキルをインストールする前に、以下を準備してください：

• OpenClaw がインストールされ実行中であること（v1.0+）
• 管理したいサーバーへのアクセス権を持つ Discord アカウント
• Developer Portal でボットトークン付きの Discord ボット が作成済みであること
• 必要な権限を持つボットが サーバーに招待済み であること
• スキル管理用の clawhub CLI がインストール済みであること

セットアップを確認：

# OpenClaw のバージョンを確認
openclaw --version

# clawhub CLI を確認
clawhub --version

Discord ボットの作成

まだボットを作成していない場合は、以下の手順に従ってください：

1. Discord Developer Portal にアクセスし、New Application をクリックします。
2. Bot タブに移動し、Add Bot をクリックします。
3. ボットトークン をコピーします — 設定時に必要になります。
4. Privileged Gateway Intents で、スキルがメッセージ内容を読み取る必要がある場合は Message Content Intent を有効にします。
5. OAuth2 URL Generator を使用して、bot スコープと必要な権限を持つ招待リンクを作成します。

Discord スキルのインストール方法

Discord スキルを 1 つのコマンドでインストール：

npx clawhub@latest install discord

インストールを確認するには：

clawhub list

インストール済みスキルの一覧に discord が表示されるはずです。インストール前に clawhub inspect discord でスキルをプレビューすることもできます。

Discord スキルの設定

Discord スキルは認証にボットトークンが必要です。まだ作成していない場合は、Discord Developer Portal でボットを作成してください。

環境設定

# Discord ボットトークンを設定
export DISCORD_BOT_TOKEN=your_bot_token_here

重要： トークンを設定ファイルにハードコードしないでください。環境変数または 1Password などのシークレットマネージャーを使用してください。

Gateway Intents

スキルはイベントを受信するために Discord Gateway Intents を使用します。3 つのインテントは特権インテントであり、Developer Portal で有効にする必要があります：

| インテント | 用途 | 必須？ | |--------|---------|-----------| | MESSAGE_CONTENT | メッセージテキスト、埋め込み、添付ファイルの読み取り | readMessages を使う場合は必須 | | GUILD_MEMBERS | メンバーの参加/退出イベントとメンバーリストへのアクセス | memberInfo を使う場合のみ | | GUILD_PRESENCES | ユーザーのオンライン/オフライン状態の追跡 | ほとんど不要 |

ユースケースに必要なインテントのみを有効にしてください。ほとんどの場合、MESSAGE_CONTENT だけで十分です。

アクションゲーティング

Discord スキルはきめ細かなアクション制御をサポートしています。ほとんどのアクションはデフォルトで有効ですが、機密性の高いアクションは無効になっています：

| アクション | デフォルト | 説明 | |--------|---------|-------------| | discord.actions.moderation | false | ユーザーのタイムアウト、キック、BAN | | discord.actions.roles | false | メンバーのロールの追加・削除 |

モデレーションアクションを有効にするには、OpenClaw の設定を更新してください：

# モデレーションアクションを有効にする（慎重に使用してください）
openclaw config set discord.actions.moderation true

Discord スキルの使用例

1. チャンネルにメッセージを送信

あなた： 「#announcements チャンネルに『バージョン 2.0 がリリースされました！リリースノートで詳細をご確認ください。』というメッセージを送信して。」

エージェントはターゲットチャンネル ID を指定して sendMessage アクションを使用します。メッセージを投稿し、メッセージリンクとともに配信を確認します。

2. コミュニティの質問を監視

あなた： 「#help-forum の最新 10 件のメッセージを読んで、未回答の質問をまとめて。」

エージェントは指定されたチャンネルで readMessages を呼び出し、返信のないメッセージをフィルタリングして、各スレッドへのリンク付きで未回答の質問の要約を返します。

3. コミュニティ投票を実施

あなた： 「#general で『次にどの機能を開発すべき？』という投票を作成して。選択肢：ダークモード、モバイルアプリ、API 改善、ドキュメント改善。24 時間実施して。」

エージェントは poll アクションを使用して最大 10 個の回答オプション付きで投票を作成します。期間を設定し、投票リンクとともに確認を返します。

4. カスタム絵文字をアップロード

あなた： 「この画像を 'ship_it' というカスタム絵文字としてサーバーにアップロードして。」

エージェントは emojiUpload を使用して画像（PNG/JPG/GIF、最大 256KB）をサーバー絵文字として追加します。アップロードを確認し、メッセージで使用するための絵文字コード :ship_it: を表示します。

セキュリティとベストプラクティス

Discord スキルはサーバーに対して書き込み操作を実行でき、メッセージの送信や — 有効な場合は — モデレーション操作も含まれます。安全に使用するために以下のガイドラインに従ってください：

• 最小権限の原則を守る。 ボットに実際に必要な権限のみを付与してください。絶対に必要でない限り、Administrator 権限を付与しないでください。
• モデレーションはデフォルトで無効に。 スキルは moderation と roles アクションをデフォルトで無効にしています。特定のニーズがあり、その影響を理解している場合にのみ有効にしてください。
• 必要なインテントのみを有効に。 MESSAGE_CONTENT や GUILD_MEMBERS などの特権インテントは、ワークフローに依存する場合にのみ有効にしてください。
• ボットトークンを定期的にローテーション。 トークンが漏洩した疑いがある場合は、Developer Portal で直ちに再生成してください。
• 確認してから承認。 OpenClaw は破壊的なアクションに対して確認を求めます。特にモデレーションや一括操作では、承認前に必ずアクションの要約を確認してください。
• ボットのアクティビティを監査。 Discord の監査ログを使用して、ボットが実行したアクションを追跡し、期待通りであることを確認してください。

よくあるエラーのトラブルシューティング

"401: Unauthorized"

ボットトークンが未設定、無効、または再生成されています。

1. 環境に DISCORD_BOT_TOKEN が設定されていることを確認してください。
2. トークンが Developer Portal のボット設定のものと一致することを確認してください。
3. トークンが最近再生成された場合は、環境変数を更新してください。

# トークンが設定されていることを確認
echo $DISCORD_BOT_TOKEN

"50001: Missing Access"

ボットにターゲットチャンネルまたはサーバーへのアクセス権がありません。

1. ボットが正しい権限でサーバーに招待されていることを確認してください。
2. ボットをブロックしている可能性のあるチャンネルレベルの権限オーバーライドを確認してください。
3. permissions アクションを使用して、チャンネルに対するボットの実効権限を確認してください。

"MESSAGE_CONTENT intent is required"

メッセージ内容を読み取ろうとしていますが、MESSAGE_CONTENT 特権インテントが有効になっていません。

1. Developer Portal → アプリケーション → Bot タブに移動してください。
2. Privileged Gateway Intents で Message Content Intent を有効にしてください。
3. 認証済みボット（75 以上のサーバー）の場合、ポータルからこのインテントの申請が必要です。