前提条件
- Discord アカウント
- サーバーの管理 権限を持つ Discord サーバー
- LemonClaw インスタンス:
- ホスト型: Claw インスタンスを作成する
- セルフホスト型: LemonClaw をインストールする
セットアップガイド
Discord アプリケーションの作成
- Discord Developer Portal にアクセスします
- New Application をクリックします
- 名前(例:「My AI Bot」)を入力し、Create をクリックします
ボットの作成
- アプリケーション内で Bot タブに移動します
- Add Bot → Yes, do it! をクリックします
- Privileged Gateway Intents の下で、以下を有効にします:
- Message Content Intent(必須)
- Server Members Intent(推奨)
- Reset Token をクリックしてボットの token を生成します
- token をコピーします。次のステップで必要になります
サーバーにボットを招待する
- OAuth2 タブ → URL Generator に移動します
- Scopes の下で、
bot、applications.commandsを選択します - Bot Permissions の下で、
Send Messages、Read Message Historyを選択します - 生成された URL をコピーしてブラウザで開きます
- サーバーを選択し、Authorize をクリックします
LemonClaw WebUI を開く
- ホスト型の Claw を使用している場合は、Claw Dashboard に移動し、Open WebUI をクリックします
- LemonClaw をセルフホストしている場合は、自身の WebUI(例:
http://your-ip:18789)を開き、token でサインインします - WebUI で Settings → Channels に移動します
- Discord セクションを展開します
- Bot Token を貼り付けます
- Save をクリックします
サーバーでの使用
グループ設定
LemonClaw WebUI の Channels 設定でサーバー(ギルド)の動作を設定します:| 設定 | オプション | 説明 |
|---|---|---|
| Group Policy | Open (デフォルト) / Allowlist / Disabled | サーバーチャンネルへのアクセスを制御します |
| Require @mention | On / Off | ボットがメンションされた時のみ応答します(推奨) |
| Group IDs | ギルド ID のリスト | 特定のサーバーに制限します(空の場合はすべてのサーバー) |
Discord では、グローバルなグループ allowlist の代わりに、ギルドごとのユーザー allowlist を使用します。高度なギルドごとのユーザーフィルタリングについては、LemonClaw の設定ファイルで直接設定してください。
DM ポリシー
ボットにダイレクトメッセージを送信できるユーザーを制御します:| ポリシー | 動作 |
|---|---|
| Pairing (デフォルト) | 新規ユーザーにはペアリングコードが発行されます。WebUI に入力して認証してください |
| Allowlist | 指定したユーザー ID のみがボットに DM を送信できます |
| Open | 誰でもボットに DM を送信できます(注意して使用してください) |
トラブルシューティング
ボットはオンラインだが応答しない
ボットはオンラインだが応答しない
- Developer Portal で Message Content Intent が有効になっていることを確認してください
- ボットの token が正しいことを確認してください
- ボットにチャンネルでのメッセージの読み取りおよび送信権限があることを確認してください
ボットがオフラインと表示される
ボットがオフラインと表示される
- ダッシュボードでインスタンスのステータスを確認してください(緑色/実行中である必要があります)
- インスタンスの再起動を試してください
- Developer Portal で token がリセットされていないか確認してください
ログに 409 Conflict エラーが表示される
ログに 409 Conflict エラーが表示される
- これは、2 つのインスタンスが同じボット token を使用しようとしたときに発生します
- この token で設定されている LemonClaw インスタンスが 1 つだけであることを確認してください