Documentation

ドキュメント

Zelett Bot の導入・設定・運用に必要な情報をまとめています。

1はじめに

Zelett Bot は Luna / OpenClaw 系の Discord Bot です。Slash Command を中心に、会話 AI 対話・情報整理・外部 API 連携を提供します。

前提条件

• Discord サーバーの管理者権限
• Discord アカウント (13歳以上)
• 本番・開発の 2 サーバー構成を推奨

2サーバー設定

要件定義書に従い、最低 2 つのサーバーを用意してください。

開発・検証サーバー

• 管理者・開発者のみ参加
• 開発用 Bot token を使用
• Slash Command の挙動確認
• #dev-* チャンネルを配置

本番サーバー

• 一般利用者の参加を許可
• 本番用 Bot token を分離
• Administrator 権限は禁止
• 監査ログ・インシデント対応完備

3ロール・権限

ロール名	説明	権限レベル
Server Owner	サーバーオーナー	最高権限
Admin	サーバー管理者	管理権限
Moderator	モデレーター	モデレーション権限
Developer	Bot 開発者	開発・デバッグ権限
Bot	Bot 専用ロール	最小権限（原則）
Verified User	認証済み一般利用者	一般利用権限
Guest	ゲスト	閲覧のみ

警告: Bot ロールに Administrator 権限を付与しないでください。本番サーバーでは最小権限原則を厳守してください。

4チャンネル構成

情報カテゴリ

welcome参加者への案内

rulesサーバールール

announcements重要なお知らせ

bot-statusBot 稼働状況

利用カテゴリ

bot-chatBot との会話 (全員)

bot-commandsコマンド実行 (全員)

faqよくある質問

supportサポート依頼

運用カテゴリ

moderator-onlyMod・Admin のみ

bot-logsBot 動作ログ (管理者のみ)

incident-response障害対応

audit監査ログ

開発カテゴリ (開発サーバーのみ)

dev-bot-testBot テスト

dev-command-testコマンドテスト

dev-errorsエラーログ

dev-api-checkAPI 疎通確認

5コマンド一覧

/status管理者

Bot の稼働状態・バージョン確認

例: /status

/new全員

新しい会話セッションを開始

例: /new

/reset全員

会話履歴をクリア

例: /reset

/compact全員

会話履歴を圧縮・要約

例: /compact

/help[コマンド名]全員

ヘルプを表示

例: /help reset

/ping管理者

Bot の応答速度を確認

例: /ping

6Bot 設定 (Developer Portal)

Application 所有

本番用アプリは Developer Team 所有にする
チームメンバーは必要最小限に絞る
全メンバーのメール認証・2FA を必須化

Installation 設定

Install Link → Discord Provided Link を使用
User Install → applications.commands のみ
Guild Install → applications.commands + bot
Guild Install 時に必要権限を明示選択

OAuth2 / Redirect URI

Redirect URI は Developer Portal 登録値と完全一致が必要
ローカル検証: http://127.0.0.1/callback
本番: https://zelett.com/callback

公開要件 (本番公開時)

Terms of Service URL: https://zelett.com/terms ✓
Privacy Policy URL: https://zelett.com/privacy ✓
Team ownership の設定
verification 要件の充足 (100サーバー超の場合)

7セキュリティ要件

Bot token を平文で共有・コミットしない
API キー・トークンは環境変数または秘密管理サービスで保持
本番 token と開発 token を必ず分離する
サーバー管理者アカウントは 2FA を必須化
Bot 権限は最小権限原則で設計（Administrator は禁止）
Message Content Intent は必要な場合のみ採用
監査ログを保全する（最低 90 日）

8運用・障害対応

日常運用チェック

Bot の稼働状況を毎日確認 (/status コマンド or ステータスページ)
切断時の自動再接続状況を #bot-status チャンネルで監視
Slash Command の疎通確認 (/ping)
#bot-logs チャンネルのエラーを定期確認

障害対応フロー

障害検知 — #bot-status または監視通知で障害を確認

ユーザーへ通知 — #announcements で障害発生と影響範囲を告知

原因調査 — #bot-logs・#incident-response でログを確認

復旧作業 — Bot 再起動・設定修正・外部 API 確認

復旧確認 — /status・/ping で正常稼働を確認

事後対応 — #audit にインシデントレポートを記録

9よくある質問

Bot が応答しない場合はどうすればいいですか？

#bot-commands チャンネルで /ping を実行し、応答があるか確認してください。応答がない場合は #support チャンネルでお問い合わせください。

コマンド権限エラーが出ます

コマンドによっては特定のロール（Moderator 以上）が必要です。利用できるコマンドはロールによって異なります。サーバー管理者にお問い合わせください。

Message Content Intent は使っていますか？

基本的には Slash Command 中心の設計で Message Content Intent を使用しません。DM・メンション・Bot 自身のメッセージは Intent なしでアクセス可能です。

Bot を開発サーバーでテストしたい

開発サーバーへの参加は管理者・開発者のみ許可されています。参加希望の場合は管理者にご連絡ください。

個人情報はどう扱われますか？

プライバシーポリシーをご確認ください。会話本文の永続保存は行わず、セッション終了後に削除されます。