Skip to main content
Gateways は Alter を Discord と Telegram のボットに接続し、これらのアプリから Alter とチャットできるようにします。各 Gateway は Mac 上でローカルに動作します — メッセージを処理するには Alter が開いたまま実行されている必要があります。
Gateways（Discord/Telegram ボット）は、サードパーティアプリ向けに OpenAI 互換エンドポイントを提供する 設定 → Router の API Gateway とは異なります。その機能については API Gateway ガイド を参照してください。

​
Gateways の機能

Gateways を使うと、すでに開いているチャットプラットフォームから Alter を利用できます：
  • Discord — ボットに DM を送るか、サーバーチャンネルでメンションする（設定済みの場合）。
  • Telegram — プライベートチャットまたはグループでボットにメッセージを送る。
各 Gateway インスタンスには、名前、デフォルト Action、アクセス制御、接続設定があります。会話は Hub チャットと同様に Mac 上の Alter に保存されます — Gateway は会話を開始・継続する別の方法です。 誰かがメッセージを送ると、Alter は次のように動作します：
  1. プラットフォームのボット接続経由で受信する。
  2. 選択された Alter Action（例：Ask Anything）を実行する。
  3. 返信を Discord チャンネルまたは Telegram チャットにストリーミングで返す。
  4. 受信した添付ファイルをダウンロードし、ツール実行の出力ファイルをアップロードできる。

​
Gateways 設定を開く

1

Settings を開く

⌘,（Command + カンマ）を押すか、メニューバーの Alter アイコンから 設定… を選ぶか、notch の ⋯ メニューから 設定 を開きます。
2

Integrations → Gateways へ

設定サイドバーで Integrations を開き、Gateways を選択します。
直接ディープリンクも利用できます：com.wearedevx.alter://settings?id=gateways Gateways ページには構成済みの Gateway がすべて表示されます。Gateway を追加 で Discord または Telegram 接続を作成します。

​
セットアップガイド

Discord gateway

Discord ボットを作成し、intent を有効化してサーバーに招待し、Alter で接続します。

Telegram gateway

BotFather でボットを作成し、トークンを Alter に貼り付けます。

​
Gateway 設定リファレンス

すべての Gateway で共通のフィールド： プラットフォーム固有の 接続 フィールドはセットアップガイドに記載されています： 有効な Gateway を保存すると、Alter は @username として接続済み のようなステータス行、または対処可能なエラーを表示します。

​
蓋を閉じたまま Gateways をオンラインに保つ

MacBook では、蓋を閉じると通常 Mac がスリープし、Gateway ボットが切断されます。Alter は蓋を閉じたままでもアクティブな Gateway を利用可能にできます。 設定 → Integrations → Gateways の上部：

​
バッテリー保護

Alter はバッテリー寿命を守るため、蓋を閉じた状態の可用性を自動的に一時停止します：
  • 以下で一時停止 — Mac がバッテリー駆動で放電中、このレベル以下になると Alter は通常のスリープを復元します（デフォルト 20%、5% から 50% まで 5% 刻みで調整可能）。制限を超えて充電すると、蓋を閉じた可用性が再びオンになります。
  • 低電力モードで一時停止 — macOS の Low Power Mode がオンの間は常に尊重されます。
メインのトグルをオフにしても、インストール済みの管理者権限は保持されるため、再度オンにするときに再プロンプトは不要です。完全に取り消す場合は オプション… の 管理者権限を削除… を使用します。
蓋を閉じた可用性は、保護された macOS のスリープ設定を変更します。Alter はアプリが予期せず停止した場合に通常のスリープを復元する安全モニターも実行します。Gateway には引き続き Alter の実行が必要です — この機能は Mac を起きたままにするもので、Alter を閉じたままにするものではありません。

​
Gateway で使える Action

可用性 で外部プラットフォームにオプトインします。Action Editor で Gateways セクションを開き、可用性 を選択します：
同梱の Ask Anything Action は すべて がデフォルトです — 新しい Gateway の一般的な デフォルト Action です。ローカルのみにしたい場合は Ask Anything を なし に設定してください。カスタム Action は なし から始まり、プラットフォームまたは すべて を有効にするまで Gateway では使えません。
設定 → Integrations → Gateways では、各 Gateway にそのプラットフォーム向けの 利用可能な Action リストが表示されます。有効な Action を確認し、リストから Action Editor → Gateways を直接開けます。 プラットフォームで許可されている Action なら、/new [action] や Choose action ピッカーで会話ごとに Action を切り替えられます。

​
パラメータなしとパラメータありの Action

Choose action（または /actions）で Action を選んだとき：
  • パラメータなし Action（Action Editor に入力フィールドがない）はすぐに開始 — 設定済みプロンプトで Action を実行します（Hub のワンクリック起動と同じ）。
  • パラメータあり Action（入力フィールドあり）は新しい会話を開始し、ユーザーが入力を送るまで次のメッセージを待ちます。## チャットコマンドと操作
Discord と Telegram は同じテキストコマンドをサポートします（通常のメッセージとして入力）。Telegram では /help@YourBotName のようなボット接尾辞でも動作します。 Discord では、ボット接続時に Alter はネイティブのスラッシュコマンド（/help、/new、/actions、/chats、/history、/stop、/status）も登録します。Server ID を設定すると、そのサーバー専用に登録されます。未設定の場合はボットアプリ全体にグローバル登録されます。 両プラットフォームとも、よく使う操作のボタンを提供します — 例：/help の New chat、Choose action、Past chats。Telegram はインラインキーボード、Discord はメッセージコンポーネントを使用します。Action が Ask User ツールを使う場合、Alter は同じインタラクティブコントロールで多肢選択質問を提示し（「Other」回答の入力も受け付けます）。 コマンド以外のメッセージは、現在の会話でのチャットターンとして扱われます。

​
日常の使い方

  1. Mac で Alter を実行し、Gateway を 有効 にします。MacBook では、蓋を閉じたままボットを接続したい場合は 蓋を閉じたまま Gateways をオンラインに保つ をオンにします。
  2. Discord または Telegram でボットにメッセージを送ります（サーバーでメンションを必須にする がオンの Discord サーバーでは @mention）。
  3. Alter は Action 実行中 Thinking… プレースホルダーを表示し、その後ストリーミング応答で更新します。Telegram DM では対応環境で Telegram ネイティブの下書きプレビュー経由でストリーミングできます。グループでは通常メッセージを編集します。
  4. Discord または Telegram でファイルを添付 — Alter はターン用にダウンロードし、ツールの出力ファイルをアップロードできます。Voice messages と audio files は選択した音声プロセッサ（設定 → Voice）で文字起こしされ、テキストとして Alter に送られます。長い音声は会議形式の文字起こしコンテキストとしても添付されます。
  5. /stop、Stop ボタン（Telegram グループと Discord）、または同じチャンネル/チャットで次のメッセージを送る前にターンの完了を待ちます。

​
一度に 1 件の応答

Alter はチャンネルまたはチャットごとに 1 件の進行中応答を処理します。Alter がまだ応答中に 2 件目のメッセージが届くと、ボットはそのチャンネル/チャットで既に応答中であると返します。現在のターンが終わるまで待ってから再送してください。

​
会話の継続性

各 Discord チャンネルまたは Telegram チャットには 1 つのアクティブな Alter 会話があります。/new で新規開始、/chats と /use で Mac 上の既存 Alter 会話を再開できます。 Discord で サーバーでの議論をスレッドで開始 を有効にすると、各新しいサーバートップレベルメッセージに専用スレッドと Alter チャットが付きます。既存スレッド内の返信は、新しいものを始めずにそのチャットを継続します。

​
プライバシーとデータ

  • Bot トークン は平文の設定ファイルではなく macOS Keychain に保存されます。
  • Gateway 設定（名前、アクセスリスト、default action）は Mac 上の Alter 設定にローカル保存されます。
  • チャンネルごとの状態（選択中の会話、保留中の Action）は Alter の Application Support フォルダに保存されます。
  • メッセージ処理は Hub と同じローカル Alter スタックを使用 — Gateway トラフィック用の別クラウド中継はありません。
ローカルデータとプライバシー も参照してください。

​
トラブルシューティング

​
接続とトークン

​
利用

​
蓋を閉じた状態での可用性

​
プラットフォームの注意

  • Alter は実行中である必要があります — Alter を終了すると Gateway ボットも停止し、再起動まで再開されません。MacBook では 蓋を閉じたまま Gateways をオンラインに保つ が Gateway 実行中に Mac を起きたままにしますが、Alter も開いたままである必要があります。
  • 両プラットフォームでボットメッセージは無視されます。
  • Discord は処理中に 👀 を付け、ターン終了時に ✅ または ❌ を付けます。ユーザーが追加したリアクションはコマンドやチャット入力として扱われません。
  • Telegram は message と callback_query 更新（インラインキーボードタップ）に long polling を使用。ターン完了後、Alter は 👍 または 👎 でリアクションすることがあります。グループチャットではアクティブなターン中に Stop ボタンが表示されます。
より広いツール・権限の問題は 設定 → Doctor または Tools not working を使用してください。

​
関連ページ