Discord Bot & クラウドリレー
サバちゃん Discord Bot の設定と、ポート開放なしでサーバーを制御できるクラウドリレーのペアリングの流れ。
Discord Bot & クラウドリレー
サバちゃんの Discord Bot は、クラウドのリレーサーバー上で運営される公式ボット です。ボットのプロセスを動かしたり Discord のトークンを管理したりする必要はありません。公式ボットを自分の Discord サーバーに招待し、サバちゃんアプリのコードで一度ペアリングするだけです。
1. 仕組み
- 1サバちゃんデーモンDiscordリレー
新しいコマンドを待つ(ロングポーリング)
- 2DiscordDiscordリレー
コマンド入力 /saba … またはチャット
- 3Discordリレーサバちゃんデーモン
コマンドを渡す
- 4サバちゃんデーモン
権限を確認
- 5サバちゃんデーモンゲームサーバー
起動・コンソールコマンド
- 6サバちゃんデーモンDiscordリレー
結果を送る
- 7DiscordリレーDiscord
結果を返信
- ボット自体は リレーサーバーの中 で動作します。PC にボット関連のものは何もインストールされません。
- ゲームサーバーは PC 上で動作します。PC 上のサバちゃんデーモンが ロングポーリング でリレーサーバーに外向きに接続し、コマンドを取得して結果を送り返します。
- デーモンはゲームのコマンドを stdin(サーバーのコンソール)→ REST → RCON の順に送ります。Palworld は REST API を使います。RCON は RCON しか対応していないゲームでのみ使い、ループバック(127.0.0.1)でのみ接続します。
- デーモン ↔ リレー間の通信は PC から外向きの HTTPS だけです。ルーターのポート開放は不要です。
- 音楽は PC を経由せずリレー側で処理されるため、PC の電源が切れていても動作します。
2. ペアリング
ペアリングは、ホスト(サバちゃんデーモン) と ノード(Discord サーバー) をリレーサーバーに登録する手続きです。コードを一度入力するだけで完了します。
2.1 フロー図
- 1GUIアプリサバちゃんデーモン
ペアリングコードを要求
- 2サバちゃんデーモンDiscordリレー
コードの発行を依頼
- 3Discordリレーサバちゃんデーモン
コード+ポーリング用シークレット(5分有効)
- 4サバちゃんデーモンGUIアプリ
コードを表示
- 5DiscordDiscordリレー
/saba connect code:…
- 6Discordリレー
PCを登録・ノードトークン発行
- 7GUIアプリサバちゃんデーモン
3秒ごとに状態確認
- 8サバちゃんデーモンDiscordリレー
状態確認(シークレット付き)
- 9Discordリレーサバちゃんデーモン
接続済み+ノードトークン(1回だけ)
- 10サバちゃんデーモン
トークン保存・リレー接続開始
- 11サバちゃんデーモンGUIアプリ
「接続済み」を表示
- ペアリングコードは32文字で、
pollSecretは48文字です。コードの有効期間は5分です。 - トークンは ちょうど一度だけ 返されます(アトミックスワップ)。GUI ではなくデーモンが、受け取ると同時に
.node_tokenに保存し、リレー接続を開始します。アプリは poll secret を PC 上のデーモンにだけ渡し、デーモンはそれを URL ではなくヘッダーに入れてリレーへ送ります。 - 誰かにペアリングコードを見られても、
pollSecretがなければトークンを横取りできません。 - 1 つの Discord アカウントに複数の PC を接続できます。すでに PC があるアカウントで接続すると、
新しいPCとして接続と、以前の PC を選ぶ再接続のボタンが出ます。再接続すると、その PC の以前のトークンは使えなくなります。1 つの Discord サーバーにも複数の人の PC がつながれます(Discord 連携)。
2.2 アプリ側の手順
- サバちゃんアプリで Discord → 接続 を開き、Discordサーバーを接続 をクリックします。
- 公式のサバちゃんボットがまだ Discord サーバーにいない場合は、先に ボットを招待 で招待します。
- 画面に接続コードと入力するコマンドが表示されます。コピー をクリックし、Discord のチャンネルで
/saba connect code:<コード>として入力します(アプリには韓国語名の/사바쨩 연결 코드:<code>が表示されることがありますが、同じコマンドです)。 - このコマンドを実行できるのは、その Discord サーバーで サーバー管理 権限を持つメンバーだけです。ボットとの DM で送ると、Discord サーバーなしで PC だけを自分のアカウントに接続します。
- サバちゃんを初めて使う Discord アカウントなら、ボットがまず登録を案内します。
登録するからウェブサイトで規約を確認して登録すると、その返信が接続の確認に切り替わります。同意する前は PC を接続しません。 - ボットが接続するかどうかを尋ねるボタンを表示したら、
接続を押します。他人から渡されたコードを入れるとその人の PC が自分のアカウントに接続されるので、サバちゃんアプリで自分で受け取ったコードのときだけ押してください。 - アプリはデーモンを通じて3秒ごとに状態を確認し、デーモンが
.node_tokenを保存すると「接続済み」に切り替わります。
ペアリングが済むと、デーモンはリレーサーバーとのロングポーリング接続を自動で維持します。アプリで コマンド中継 のスイッチをオフにすると、PC は Discord のコマンドを受け取らなくなり、ボットは応答しません。
2.3 コードなしで別の Discord サーバーを接続する
Discord アカウントがすでにペアリング済みなら、別の Discord サーバーで /saba connect(コードなし)を実行するだけで済みます。
- ボットが、そのアカウントに紐付いた PC をすべてその Discord サーバーにすぐ接続します。PC で別途承認したり PC を選んだりする必要はありません。
- 初めて使うアカウントなら、先に登録します。登録するとその Discord サーバーもサバちゃんに登録され、接続した PC がなければ PC なしのサーバーとして残ります(§2.5)。登録済みのアカウントで PC がない場合、ボットはペアリングコードで接続するよう案内します。
- こうして接続した Discord サーバーには、最初はゲームサーバーが1つも表示されません。PC のサバちゃんアプリで、その Discord サーバーで使うサーバーを選んでください。
- ペアリングコードで接続した Discord サーバーは、アプリの Discord の接続画面にある 新しい Discord サーバーに自分のサーバーをすぐ開く 設定に従います。オンならすべてのサーバーがすぐ表示され、オフなら自分で選びます。
- コードを使う場合と同様に サーバー管理 権限が必要です。他の PC がすでに接続されている Discord サーバーでも、それを奪わずに自分の PC を一緒に接続します。
2.4 ペアリングの解除
- アプリで 接続を解除 をクリック → デーモンがコマンド中継を停止し、
.node_tokenを削除します。この PC はすべての Discord サーバーから切断されます。 - 特定の Discord サーバーだけを切り離すには、そのサーバーで
/saba disconnectを実行します。使えるのは接続した本人か Discord サーバーのオーナーだけで、そのサーバーのチャンネル割り当ても一緒に削除されます。
2.5 PC なしの Discord サーバー
サバちゃんアプリをインストールしていない人でも、ボットを招待して、うたうサバちゃん、おしゃべりサバちゃん、読み上げサバちゃん、サーバー管理コマンド、ゲームの戦績を使えます。
- 設定はリレーに保存されます。Discord サーバーのオーナーか サーバー管理 権限を持つ人が、言語、おしゃべりサバちゃん・うたうサバちゃんのチャンネル割り当て、絵文字アップスケール、おしゃべりサバちゃんの設定、読み上げサバちゃんの設定を変更します。Discord の
/sabaコマンドかサバちゃんウェブで行い、初めて変更するときに登録します。 - サバちゃんのレベル(権限の階段)とゲームサーバーのコマンドはありません。通知・ゲームチャット・ステータスボードのチャンネルは PC が送るものなので、割り当てられません。
- 後で PC を接続すると設定がそのまま引き継がれ、その時点から設定の原本はその PC になります。
- 音楽を聴いたり会話したりといった一般メンバーの利用には、登録は不要です。
3. ボットのスラッシュコマンド
公式ボットのルートコマンドの下にあるコマンドです。韓国語以外の言語に設定された Discord クライアントでは、ルートは /saba、サブコマンドは英語名で表示されます。韓国語では /사바쨩 です。PC を接続していない Discord サーバーには、接続・割り当て・言語・設定・読み上げ・ウェブ・絵文字アップスケール・ヘルプだけが表示され、「ノードオーナー」の代わりに Discord サーバーのオーナーか サーバー管理権限を持つ人が使います。それ以外のスラッシュコマンド(/tts、/stats、/clear など)はコマンドにあります。
| コマンド | 対象 | 動作 |
|---|---|---|
/saba status | 誰でも | このサーバーに接続された PC と各ゲームサーバーの状態(CPU、RAM)を表示 |
/saba connect [code] | サーバー管理権限 | ペアリングコードで接続。コードを空にすると自分のアカウントの PC をすべてこのサーバーに接続する(§2.3)。初めてなら登録から |
/saba disconnect | 接続した本人またはサーバーオーナー | このサーバーを PC から切断 |
/saba permission <level> [user] | ノードオーナー | ユーザーを選ぶとそのメンバーにコマンドレベルを付与(レベル一覧の 解除 は個別のレベルを消して既定のレベルに戻す)。空にするとレベルを個別に持たないメンバーの既定レベル(最初はユーザー)。レベル一覧はこのサーバーの権限の階段 |
| メンバーを右クリック → アプリ → Change Saba-chan level | ノードオーナー | そのメンバーのコマンドレベルを一覧から選ぶ(解除 もある)。/saba permission と同じ操作。サーバー管理権限を持つ人にだけメニューが表示される |
/saba sleep | ノードオーナー | このサーバーでボットをスリープさせる(すべてのメッセージを無視) |
/saba wake | ノードオーナー | ボットを起こす |
/saba assign kind:<おしゃべりサバちゃん|うたうサバちゃん|通知|ゲームチャット|Status board> | ノードオーナー・サーバーオーナー | このチャンネルを、おしゃべりサバちゃんのチャンネル(複数可、最大20。おしゃべりサバちゃんはそこでのみ会話)、うたうサバちゃんのチャンネル(1つ。通常のメッセージは削除されるため確認を求める)、通知チャンネル(1つ。サーバーのクラッシュ、アップデート、バックアップ、予約再起動の通知と、クラッシュ通知の 再起動 ボタン)、ゲームチャットチャンネル(1つ。ゲームサーバー内のチャットを転送)、ステータスボードチャンネル(1つ。起動中のサーバーごとに状態カード1枚)のいずれかに割り当てる。詳しくはコマンドのチャンネル機能を参照。1つのチャンネルに割り当てられる種類は1つだけで、同じ種類をもう一度実行すると解除される。アプリの Discord サーバー → サーバー管理 タブの サバちゃんの割り当て でも変更可能 |
/saba language <language> | ノードオーナー | このサーバーでボットが返答する言語(Auto = 紐付いたアプリの言語に従う) |
/saba reading | ノードオーナー | このサーバーの読み上げサバちゃんの音量・速度・ピッチと名前を呼ぶ設定。自分にだけ表示される |
/saba big-emoji state:<On|Off> | ノードオーナー・サーバーオーナー | カスタム絵文字だけを送った投稿を大きい画像に差し替えて投稿する(既定はオフ) |
/saba web | 誰でも(自分のアカウント) | サバちゃんウェブのワンタイムリンク(5 分)。PC があればその PC も、なければ自分が管理する Discord サーバーの設定だけ。自分にだけ見える |
/saba settings | ノードオーナー | このサーバーのおしゃべりサバちゃんの設定(オン/オフ、割り込み、記憶、AI モデレーション、実行前の確認段階、カテゴリごとのツール、呼び出しワード)を変更。アプリで全体許可ツールから外したツールはオンにできない。自分にだけ表示される |
/saba help | 誰でも | サバちゃんの使い方とコマンド一覧を表示(自分にだけ表示される) |
/mysaba web | 誰でも(自分のアカウント) | /saba web と同じ。どのサーバーでも DM でも使える |
/mysaba my-pcs | 誰でも(自分の PC) | 自分の Discord アカウントに接続した PC の一覧、名前の変更・削除(自分にだけ見えます) |
/mysaba agent | 誰でも(自分のアカウント) | 自分の Discord アカウントに接続した AI エージェント(リモート MCP)の確認と切断。なければエージェントに入れるアドレスを表示。DM でも使え、自分にだけ見える(AI エージェント連携) |
/saba update | PC を接続した人 | このサーバーに接続された PC のサバちゃんのアップデートを確認し、確認ボタンを押すと適用 |
/mysaba は自分のアカウントに関するコマンドなので、サーバーのメンバー一覧には表示されません。PC を接続するとボットが表示する 自分のアカウントにインストール ボタンでサバちゃんを自分の Discord アカウントにインストールすると、どのサーバーでも DM でも自分にだけ表示されます。ボットとの DM では、インストールしなくても /saba web・/saba my-pcs・/saba agent として使えます。
PC を接続した Discord サーバーでは、権限・スリープ・言語・うたうサバちゃん・読み上げサバちゃんの設定の原本は PC のサバちゃんの設定なので、これらのコマンドは PC の電源が入っているときに反映されます(PC なしのサーバーは§2.5)。同じ設定は、アプリの Discord サーバー画面でも変更できます。権限は インスタンス タブでサーバーをクリックして開く レベル別コマンド・メンバー別レベル 画面、うたうサバちゃん・読み上げサバちゃんはそれぞれのタブ、言語・プレフィックス・スラッシュコマンドの形は ボット設定 タブです。すべての Discord サーバーをまとめてスリープさせるのは、Discord → 接続 画面で行います。
3.1 サーバーごとのスラッシュコマンドと作業メニュー
ペアリング後、ボットは各 Discord サーバーに追加のコマンドを登録します。
/<サーバー名> command:<コマンド> arg1:… arg2:…: ゲームサーバーのインスタンスごとにコマンドが1つできます。Discord のコマンド一覧にはサーバーごとに1行だけ表示されます。コマンド 欄をクリックすると、そのサーバーで使えるコマンド(起動・停止・状態、作業、モジュールのコマンド)が一覧で表示され、文字を入力すると名前で絞り込まれます。引数欄は、選んだコマンドに合わせて選択肢の一覧、はい/いいえ、数値の範囲、入力の案内を表示します。- コマンド一覧からは、自分のレベルでは使えないコマンドと、今のサーバーの状態に合わないコマンド(起動中のサーバーの起動、停止中のサーバーの停止)が除かれ、そのサーバーで最近使ったコマンドが先に表示されます。実際に使えるかどうかは、サバちゃんアプリがあらためて判断します。
- 作業: サバちゃんアプリが Discord に公開する作業(再起動・バックアップなど)も、同じコマンド一覧に入ります。聞き返しの設定(§5)で確認が必要な作業は、変更内容を表示し、依頼した人が実行ボタンを押す必要があります。サバちゃんアプリのアップデートはタスクメニューにはなく、
/saba updateで行います。 - プレイヤー: 接続者の確認に対応したゲームのサーバーにだけ
プレイヤーコマンドが一覧に入ります。今の接続人数と名前を表示します。 - バックアップを復元: 復元するバックアップを一覧から選びます(入力すると候補が絞られます)。サーバーが起動中なら先に止めるか確認し、停止して続行 を押すとサーバーを止めてから復元します。復元は危険な作業なので、実行前にもう一度確認します。ボタンを押せるのは依頼した人だけです。
- 起動完了の通知:
/<サーバー名>スラッシュコマンド、通知の 再起動 ボタン、おしゃべりサバちゃんでサーバーを起動・再起動すると、接続を受け付けられるようになった時点で同じチャンネルに知らせます。最後まで起動できなかった場合は理由を一行で知らせます。 - そのサーバーで許可されたインスタンスだけが表示されます(アプリの Discord サーバー → インスタンス タブ)。
4. チャットコマンド(プレフィックス)
ペアリングが済めば、Discord のテキストチャンネルからプレフィックス付きのコマンドでサーバーを操作できます。
サバちゃん <サーバー> <コマンド> [引数…]
既定のプレフィックスは サバちゃん です。アプリの Discord サーバー → ボット設定 タブの コマンドプレフィックス で、Discord サーバーごとに変更したり追加したりできます。
<サーバー> には、インスタンス名、サーバーのエイリアス、モジュール名またはそのエイリアスを使えます。すべてのモジュールに共通のコマンド:
| コマンド | 説明 |
|---|---|
start | サーバーを起動。例:サバちゃん minecraft start |
stop | サーバーを停止 |
status | 状態を照会 |
サーバーとコマンドの呼び名は、アプリのサーバー画面 → Discord タブで設定します。全コマンド一覧は コマンド ドキュメントを参照してください。
5. 権限レベル
レベルは オーナー (3) > 管理者 (2) > ユーザー (1) > ゲスト (0) > 禁止 (-1) です。レベルは累積で、上のレベルは下のレベルが使えるコマンドをすべて使えます。
- オーナー は、サーバーを接続した人(ノードオーナー)です。すべてのコマンドを使え、降格されることはありません。
- 各コマンドにはリスク(安全、注意、危険)があります。既定のプリセットでは、必要なレベルは 安全 = ゲスト、注意 = ユーザー、危険 = 管理者 です。アプリの Discord サーバー → インスタンス タブでサーバーをクリックし、レベル別コマンド の階段でプリセット(ゆるめ、標準、厳しめ)を選んだり、コマンドのチップを別のレベルに移したりできます。メンバーのレベルと既定のレベルは同じ場所の メンバー別レベル で設定し、Discord サーバーのすべてのサーバーに共通で適用されます。
- ヘルプと一覧は、禁止でなければ誰でも使えます。禁止 のメンバーは、うたうサバちゃんとおしゃべりサバちゃんを含むボットのすべての機能を使えません。
- おしゃべりサバちゃんを経由したリクエストは、おしゃべりサバちゃんの上限(既定はゲスト)を超えられません。
聞き返し: 実行前に依頼者へ確認ボタンで尋ねるかどうかは、アプリの Discord サーバー → ボット設定 タブの 聞き返し カード(または saba-chan-cli bot confirm)で決めます。ボットに直接頼んだリクエスト(プレフィックス・スラッシュ)は最初は危険なコマンドだけ、おしゃべりサバちゃんは最初はすべてのコマンドを尋ね、どちらも すべてのコマンド・注意以上・危険なコマンドだけ・尋ねない から選びます。コマンドごとに聞き返しに使うリスクの段階は、権限画面のチップ編集ウィンドウで変更できます(必要なレベルは変わりません)。おしゃべりサバちゃんが選んだ管理系の作業は、設定にかかわらず必ず尋ねます。確認ボタンを押せるのは依頼した人だけです。
6. うたうサバちゃん
音楽の再生は、リレーサーバーと並んで動作する 公式の音楽サーバー(music-server) が担当します。
サバちゃん music play …のようなコマンドを実行すると、ボットがそれを音楽サーバーに渡し、音楽サーバーが Discord のボイスチャンネルに音声をストリーミングします。- PC に ffmpeg/yt-dlp をインストールする必要はありません。
- 音楽コマンドはどのチャンネルでも使えます。
/saba assign kind:うたうサバちゃんでうたうサバちゃんのチャンネルを設定すると、そこではプレフィックスなしでコマンド(または検索語だけ)を入力でき、プレイヤー画面が表示されます。 - うたうサバちゃんは既定でオンで、アプリの Discord サーバー → うたうサバちゃん タブでオフにできます。オンのサーバーには
/musicスラッシュコマンドができます(コマンド 5節)。
7. おしゃべりサバちゃん (AI 会話)
- おしゃべりサバちゃんは、アプリで API キーを登録し、Discord サーバーごとにオンにして初めて動作します(Discord サーバー画面の おしゃべりサバちゃん タブか
/saba settings。新しいサーバーはオフ)。キーを知っているのは PC とリレーだけで、Discord に表示されることはありません。 - 使うツール(ゲームサーバーの操作、ウェブ検索、LoL・TFT・PUBG の戦績、メイプルストーリーのキャラクター、複数ゲームの検索、生活情報、画像生成)も Discord サーバーごとにオンにします。アプリの共通メニューで 全体許可ツール から外したツールは、どのサーバーでも使いません。ゲームサーバーのツールをオンにしなければ、サーバーは扱いません。
- おしゃべりサバちゃんは
/saba assign kind:おしゃべりサバちゃんで割り当てたチャンネルでのみ会話します。それ以外のチャンネルでは、呼びかけられても応答しません。 - おしゃべりサバちゃんが使えるのは、モジュールや拡張機能がおしゃべりサバちゃんに公開したアクションだけで、それ以外は拒否されます。
- 照会はすぐに実行されます。何かを変更するアクションはまず計画になり、聞き返しの段階(§5、最初はすべてのコマンド)に従って確認ボタンを待ちます。管理系のアクションは必ず確認ボタンを待ちます。ボタンを押せるのは依頼した人だけです。
- 実行できる範囲は、おしゃべりサバちゃんの上限(§5)を超えません。
- おしゃべりサバちゃんがオンのとき、デーモンが認識できないチャットコマンドはおしゃべりサバちゃんが正確なコマンドに変換し、もう一度試します。
- おしゃべりサバちゃんにログを聞くと、以前の実行分も含めてサーバーのログを読みます。ファイルで欲しいと頼むと、AI を通さずに
.logファイルとして添付します(最大 4 MiB、超えた分は新しい側のみ、IP・秘密値・パスは伏せます)。
8. セキュリティモデル
- デーモンは、ペアリングで得たノードトークン(
sbn_{hostId}.{secret})をAuthorization: Bearerヘッダーに入れて HTTPS で送ります。リレーは保存している Argon2 ハッシュとこのトークンを照合します。 - リレーサーバーはトークンそのものを保存せず、Argon2 ハッシュと照合します。
- デーモンは外部からの接続を一切受け付けません。ゲームサーバーのパスワードはリレーに送られません。
9. トラブルシューティング
| 症状 | 原因 / 解決方法 |
|---|---|
| ボットが応答しない | プレフィックス(既定 サバちゃん)と、その後ろにスペースがあるかを確認します。ボットがサーバーにいること、ペアリングが完了していること、アプリで コマンド中継 がオンであることが必要です。/saba sleep でボットがスリープしていないかも確認してください |
サバちゃん … start → サーバーが見つからない | 最初の単語がサーバー(インスタンス名/エイリアスまたはモジュール名/エイリアス)、2番目がコマンドです。同じゲームのサーバーを複数動かしている場合は、インスタンス名かサーバーのエイリアスを使ってください |
| ペアリングコードの期限切れ | コードの有効期間は5分で、その時間が過ぎました。アプリで新しいコードを取得してください |
| アプリが待機したまま | /saba connect スラッシュコマンドを実際に実行したか、サーバー管理権限があるかを確認してください |
| Discord のコマンドが PC に届かない | 別の場所でペアリングする際に 再接続 でこの PC が選ばれると、この PC の以前の接続は切れます。この PC をもう一度ペアリングしてください |
より詳しいトラブルシューティングの流れは トラブルシューティング ドキュメントを参照してください。