コンテンツにスキップ

セットアップ:CLIProxyAPI

ローカルのChat CompletionsプロキシであるCLIProxyAPIを介して、TomoriBotを認可されたアップストリームに接続します。

公式のクイックスタートに従ってください。リリースアーカイブにはそのまま実行できるバイナリが含まれています。OSとCPUを選択し、アーカイブを展開してチェックサムを検証してください。Gitクローンからのビルドは任意です。

起動する前にCLIProxyAPIを設定します。インストーラーがサービスを起動した場合は、先に停止してください。

実行ファイル(Windowsでは cli-proxy-api.exe)の横に config.yaml を作成します。別の設定フォルダーを使用することもできますが、これらの例では両方のファイルを同じ場所に置きます。クライアントキーのプレースホルダーは、パスワードマネージャーで生成したhexまたはbase64エンコード済みの32バイト以上のランダムな値に置き換えてください。

config-version: 8
server:
host: "127.0.0.1"
port: 8317
discovery:
enabled: false
management:
allow-remote: false
secret-key: ""
disable-control-panel: true
access:
api-keys:
- "REPLACE_WITH_RANDOM_CLIENT_KEY"
oauth:
auth-dir: "~/.cli-proxy-api"

access.api-keys 配下のクライアントキーは、CLIProxyAPIに対してTomoriBotを認証します。config.yaml と oauth.auth-dir の認証情報ファイルは非公開で保管し、Gitに含めないでください。アクセス権はご自身のアカウントとプロセス用アカウントのみに制限してください。

MANAGEMENT_PASSWORD は未設定のままにし、--password や管理TUIの使用は避けてください。管理シークレットを空にすることで、トンネルの背後を含め管理ルートが無効のまま維持されます。お使いのバージョンで設定形式が異なる場合は、同梱の config.example.yaml にこれらの設定を適用してください。

3. アップストリームを接続する

Section titled “3. アップストリームを接続する”

CLIProxyAPIがモデルプロバイダーに対して認証する方法を選択します。どちらの方法も上記の基本設定を使用します。

実行ファイルと config.yaml が含まれるフォルダーからログインコマンドを実行します。以下の例ではAntigravityを使用しているため、お使いのプロバイダーのフラグに置き換え、サインイン前に同意画面を確認してください:

プロバイダーログインフラグ
Antigravity--antigravity-login
Claude--claude-login
Codex--codex-login または --codex-device-login
Terminal window
$configPath = (Resolve-Path .\config.yaml).Path
.\cli-proxy-api.exe --config $configPath --antigravity-login

ブラウザーでのサインインを完了し、ターミナルに成功が表示されるまで待ちます。CLIProxyAPIは認証情報を oauth.auth-dir に保存します。OAuthのみのセットアップではアップストリームAPIキーブロックは不要です。OAuthコールバックリスナーはローカルに限定し、ログインと起動には同じ設定パスを使用してください。その他のログインフラグは --help とアップストリームプロバイダーガイドに記載されています。

config.yaml が含まれるフォルダーからサーバーを起動します。必要に応じて実行ファイルの実際のパスやインストールされたコマンドに置き換えてください。このファイルを読み込むために --config は維持してください。

Terminal window
$configPath = (Resolve-Path .\config.yaml).Path
.\cli-proxy-api.exe --config $configPath

サーバーを実行したままステップ5に進みます。server.host は 127.0.0.1 のまま維持してください。インバウンドのファイアウォール例外やルーターのポートフォワーディングは不要です。

  1. CLIProxyAPIと同じコンピューターで動作する非本番ボットの場合は、TomoriBotの環境設定で ALLOW_PRIVATE_NETWORK=127.0.0.1:8317 を設定し、ボットを再起動します。上で設定したローカルリスナーを使用するため、トンネルは不要です。
  2. /providers(サーバー管理者)または /personal providers を実行し、次の設定で OpenAI互換 のカスタムエンドポイントを追加します:
フィールド値
エンドポイントURLhttp://127.0.0.1:8317/v1
認証トークンaccess.api-keys のクライアントキー

保存した接続を選択し、CLIProxyAPIが提供するIDまたはエイリアスを使用してテキストモデルを追加し、Discordで返信されることを確認します。

このURLは、ボットがホスト上で直接動作していることを前提としています。Dockerでは 127.0.0.1 がコンテナー自身を指すため、そのアドレス経由ではホストのリスナーに到達できません。本番モードで動作するボットには引き続きホストされた本番ルートが必要です。

利用可能なモデルを一覧表示する方法

CLIProxyAPIを実行した状態で、別のターミナルを開いてモデルIDを一覧表示します。クライアントキーを読み込む前に、PowerShellのトランスクリプトやシェルのトレースを無効にしてください。完了したらこのターミナルを閉じてください。

config.yaml が含まれるフォルダーから実行します。上記のレイアウトから最初のクライアントキーを読み取ります。

Terminal window
$keyMatch = [regex]::Match((Get-Content -LiteralPath .\config.yaml -Raw), '(?m)^access:\r?\n api-keys:\r?\n - "([A-Za-z0-9+/=_-]+)"[ \t]*\r?$')
if (!$keyMatch.Success) { throw 'Expected a quoted client key under access.api-keys in config.yaml.' }
$engineKey = $keyMatch.Groups[1].Value
$headers = @{ Authorization = "Bearer $engineKey" }
$base = 'http://127.0.0.1:8317/v1'
$models = Invoke-RestMethod "$base/models" -Headers $headers
$models.data | Select-Object id
Remove-Variable engineKey, keyMatch, headers

一覧が空の場合はアップストリーム設定が必要です。HTTP 401 は、サーバーは応答したもののクライアントキーを拒否したことを意味します。

症状対処
401アップストリームキーとは別に、クライアントキーを確認します。
404/chat/completions を付けずに /v1 ベースを使用し、モデルIDを確認します。
パラメーターの拒否コンテキストの上書きは空欄、思考レベルは「自動」のままにしてください。TomoriBotは出力開始前に、対象となるパラメーター拒否を自動的に再試行します。ツールを有効にしたりサンプリング制御に依存したりする前に、ログでフォールバックされたリクエストがないか確認してください。
403、HTMLログインページ、またはトンネルエラートンネルのセットアップを確認してください。Cloudflare Accessを有効にしている場合は、任意のAccessとCaddyのセットアップが必要です。DiscordパネルからはAccessヘッダーを直接送信できません。
ストリームが停止するPCのスリープ、アップストリームのクォータ、トンネルの健全性、およびCloudflareガイドのストリーム制限を確認してください。

マスキング済みのローカル再現環境で診断する場合を除き、リクエストやデバッグのログ記録はオフにしてください。クライアントキーが漏洩した場合は、CLIProxyAPIとTomoriBotの保存済みエンドポイント、およびそのキーを使用する任意のリレーでローテーションしてください。漏洩したアップストリーム認証情報は別途失効させてください。

アカウントログインを解除する

アップストリームのアカウント設定でアクセスを取り消し、プロキシを停止してから、ローカルの認証情報ファイルを削除します。ファイル削除だけではトークンは失効しません。

ローカルのバインドアドレスを確認する

ローカルAPIに到達できない場合は、CLIProxyAPIの実行中に別のターミナルからバインドアドレスを確認してください:

Terminal window
Get-NetTCPConnection -LocalPort 8317 |
Select-Object LocalAddress, LocalPort, State, OwningProcess

127.0.0.1 のみが表示されることを確認してください。0.0.0.0、::、*、またはLANアドレスが表示された場合は停止してください。既存のファイアウォールルール(Windowsでは wf.msc)を確認してください。インバウンドポートを開放したり、ルーターのポートフォワーディングを追加したりしないでください。WindowsのTCP状態レポートでは到達可能なエンドポイントを見逃すことがあるため、クエリにはすべての状態を含めています。任意のモデル一覧取得でAPIの到達性をテストできます。

ローカルで返信をテストする

モデルがDiscordで返信しない場合は、CLIProxyAPIの実行中に直接テストしてください。クライアントキーを読み込む前に、PowerShellのトランスクリプトやシェルのトレースを無効にしてください。

config.yaml が含まれるフォルダーから実行します。上記のレイアウトから最初のクライアントキーを読み取ります。

Terminal window
$keyMatch = [regex]::Match((Get-Content -LiteralPath .\config.yaml -Raw), '(?m)^access:\r?\n api-keys:\r?\n - "([A-Za-z0-9+/=_-]+)"[ \t]*\r?$')
if (!$keyMatch.Success) { throw 'Expected a quoted client key under access.api-keys in config.yaml.' }
$engineKey = $keyMatch.Groups[1].Value
$headers = @{ Authorization = "Bearer $engineKey" }
$base = 'http://127.0.0.1:8317/v1'
$body = @{
model = Read-Host 'Model ID to test'
messages = @(@{ role = 'user'; content = 'Reply with hello.' })
stream = $false
} | ConvertTo-Json -Depth 4
$reply = Invoke-RestMethod "$base/chat/completions" -Method Post -Headers $headers -ContentType 'application/json' -Body $body
$reply.choices.message.content
Remove-Variable engineKey, keyMatch, headers

返信が生成されればアップストリームへのアクセスが確認できたことになります。ソケット照会の結果がないことだけでは、APIに到達できない証明にはなりません。