📚 ドキュメント

すべての機能、すべての設定。

アプリができることと持っている設定のすべて — 実行中のバージョンに合わせて書かれています。メニューバーからスキルレジストリまで、完全なマニュアルです。

このページの内容

クイックスタート メニューバーアプリ 設定の解説 モデルタブ Telegram タブ ボットごとのページ アプリタブ スキルと機能 スキルレジストリ アップデート データとプライバシー トラブルシューティング

クイックスタート

  1. インストール。.dmg をダウンロードし、Telebot AI をアプリケーションフォルダへドラッグ。まだ公証されていないため、macOS に警告が出たらアプリを右クリック（Control クリック）して開くを選択 — 1回だけです。
  2. ボットを作成。Telegram で @BotFather にメッセージを送り、/newbot を実行してトークンをコピー。ボット1つにつきトークン1つ — 複数実行できます。
  3. トークンを追加。メニューバーから Telebot AI を開き、設定を開いて、ボットのトークンフィールドに貼り付けます。入力した瞬間に保存されます — 保存ボタンはありません。
  4. 頭脳を接続。モデルタブでサーバー URL（mlx-serve は http://localhost:11234、Ollama は http://localhost:11434）とモデル名を設定するか、任意の OpenAI 互換クラウド API を使用。テストで接続を確認します。
  5. ボットを起動。メニューバーに戻ってボットを起動を選択。Telegram でボットにメッセージを送ると、その瞬間から応答します。

ローカルモデルは初めて？ ガイドを読む — mlx-serve、Ollama、LM Studio の解説と、モデルごとに必要なメモリ量が載っています。

Telebot AI はメニューバー（⌘ アイコン）に住んでいます。メニューでできること：

設定の解説

設定ウィンドウのサイドバーには2種類のページがあります：

入力や切り替えのたびに自動保存されます。設定は ~/.mlx-serve/config.json に保存。

デフォルト → モデル

設定説明
サーバー URLOpenAI 互換エンドポイント。ローカルサーバーはキー不要です。
APIキーローカルサーバー（mlx-serve、Ollama、LM Studio）は空欄でOK。目のボタンで表示/非表示を切り替え。
モデル名そのサーバー上のモデル。例：deepseek-v4-flash-free。
テスト現在の値で接続を確認 — 保存前に試すのに便利です。
バックアップモデルプライマリが失敗・制限された場合に順に試行。それぞれにニックネーム、URL、キー、モデルに加え、テスト・並べ替え・削除が可能。最後の行が完成するまで追加はできません。

デフォルト → Telegram

設定説明
許可されたチャットIDボットと話せるユーザー/グループ ID（カンマ区切り）。空欄 = すべて許可。
デイリーブリーフィングの時刻ボットがデイリーブリーフィングを送る時刻 — 24時間制の時/分ドロップダウン（例：08:00）。
デイリーブリーフィングの内容ブリーフィングが扱う内容 — 例：「天気、今日のリマインダー、価格アラート」。
最大返信トークン返信の安全上限。長い回答は複数メッセージに自動分割されます。
チャットあたりの文脈ボットがチャットごとに文脈として保持する直近メッセージ数。
ユーザーあたりの記憶数ボットが回答するメッセージごとに、ユーザーあたりで呼び出す長期記憶の数。
記憶データベースサイズ（ユーザーあたり）ユーザーごとの記憶の最大保存数。超過分は古いものから削除されます。
調査レポートのトークン/research と /insiders レポートの予算。
API タイムアウト（秒）遅いプロバイダーを切り上げるまでの秒数 — 無料枠のキューは1分以上かかることもあります。
ソウルファイルボットが使用するペルソナ。このフォルダの .md ファイル（soul*.md、*persona*.md）が各ボットの「ペルソナ」ドロップダウンに表示されます。
ボットのトリガーワードグループでボットが応答するきっかけとなるカンマ区切りの言葉（@メンション・返信・コマンド以外）— 例：「momo、jarvis、hey bot」。
動画/音声クリップのトリガーワード添付の動画や音声をクリップとして保存するきっかけとなる言葉 — 例：「clip this、save this」。

ボットごとのページ

サイドバーの各ボットには専用ページがあります。空欄のフィールドはデフォルトを継承し、各行の下の説明が継承内容を示します。

設定説明
トークンボットの @BotFather トークン（目のボタンで表示）。変更するとサイドバーのボット名も変わります。
ニックネームステータス・ログ・サイドバーで使用 — 例：「Trading」。
許可されたチャットID / トリガーワード / クリップワード対応するデフォルトに対する、このボットの上書き設定。
サーバー URL、APIキー、モデルドロップダウンには「デフォルト → モデル」で設定したプロバイダーに加え、任意のカスタム値が表示されます。ボットごとに独自のバックアップモデルも追加可能。
デイリーブリーフィングの時刻 / 内容ボット専用ブリーフィング。「グローバルを使用」ボタンで上書きをクリアできます。
モードリサーチャー、アシスタント、コーダー、シェフ、またはなし — 空欄はデフォルトのモードを使用。
ソウルファイルこのボットのペルソナ上書き。ディスク上の soul/persona ファイルから選択します。
スキルボット専用のスキルシートを開く — デフォルトに加えてこのボットのスキルを無効化、またはデフォルトに戻す。

デフォルト → アプリ

設定説明
Dock に表示メニューバーアプリが Dock にも表示されるかどうか。
ログイン時に起動ログイン時に Telebot AI を起動します。
データディレクトリ設定・メモリー・リマインダー・ログの保存先（デフォルト ~/.mlx-serve）。
ログを開く / データフォルダを開くFinder でログファイルやデータフォルダに直接ジャンプ。
設定を書き出し完全な設定（API キー含む）をファイルに保存 — バックアップや Mac 移行用。
設定を読み込み設定ファイルを読み込んで即座に適用。

スキルと機能

ボットの能力はモデル駆動のスキル — モデルがツールとともに従う簡潔な指示です。コマンドを覚える代わりに、自然な言葉でやりたいことを伝えられます。グループごとにマスタースイッチがあり、個別スキルのオン/オフも可能。

グループスキルこんなふうに話しかけて
リサーチstock-research, stocks-crypto, insider-trading, currency「TSLA を調査」、「BTC の価格」、「AAPL のインサイダー取引」、「50 USD は何 CAD？」
デイリーbriefing, digest, reminders, habits, review, pomodoro, bookmarks, expenses「/briefing」、「このチャットを要約」、「午後5時にリマインド」、「今日の習慣を完了」、「週次レビュー」、「/pomodoro 25」、「ランチ25円を記録」
メディアmedia, voice, translation, feeds「この動画を分析」、「読み上げて」、「日本語に翻訳して」、「フィードに何か新しいことは？」
ツールmemory「昨日何を話したっけ？」
レジストリからレジストリからインストールしたスキル—

スキルレジストリ

レジストリタブでは、公開 anthropics/skills カタログから既製のスキルをインストールできます — PDF・文書処理、スプレッドシート、プレゼンテーション、Web アプリテスト、MCP サーバー構築、アートなど。カタログを読み込み、スキルを選ぶと、他のスキルと同じように「スキルと機能」タブに表示されます。

アップデート

アップデートタブは、ランディングサイトのマニフェストをインストール済みバージョンと照合し、最新リリースをダウンロードリンク付きで表示します。チェックは静かです — オフラインや到達不能でも「最新です」と表示されるだけ。更新方法：新しい .dmg をダウンロードしてアプリケーションフォルダの旧アプリにドラッグ。設定・ボット・メモリーはアプリの外にあるので、そのまま引き継がれます。

データとプライバシー

トラブルシューティング

Telebot AI をダウンロード · 気に入りましたか？ コーヒーを奢る ☕