OpenClaw
OpenClaw では専用 Key と /v1 Base URL の OpenAI 互換 provider を使えます。OpenClaw の設定に gateway とモデルを保存し、専用の予算とモデル許可リストを設定してから、サービスを再起動し、チャネルを公開する前に非公開のテストメッセージを 1 回確認します。
開始前
現在の公式配布元から提供されるクライアント版だけをインストールしてください。ローカル設定を変更する前にコンソールで専用 API Key を作成し、個人用、共有用、または本番デプロイ用の Key を使い回さないでください。
Windows、macOS、Linux
- Windows: 現在の Windows インストーラーまたは PowerShell 手順を使い、設定変更後はすべてのクライアントプロセスを終了します。
- macOS: CPU に合う署名済みアプリまたは公式ターミナルインストーラーを使います。ホームディレクトリの設定はその macOS ユーザーに属します。
- Linux / WSL: ディストリビューションまたは公式 CLI の最新手順に従います。WSL は Windows プロファイルではなく Linux のホームディレクトリを読みます。
モデルを選ぶ
専用 Key で GET /v1/models を呼び、返された data[].id を一つ選びます。Key ごとの一覧が正であり、以前の設定、記事、クライアントの選択肢はアクセス保証ではありません。
設定
json
{
"models": {
"providers": {
"aishop": {
"baseUrl": "https://ai.tavonilo.com/v1",
"apiKey": "sk-your-own-key"
}
}
},
"agents": {
"defaults": { "model": { "primary": "aishop/your-console-model" } }
}
}確認
Key を /v1/models で確認し、機密を含まない小さなリクエストを 1 回実行します。サポートには時刻、ルート、モデル、HTTP 状態、request ID だけを残してください。タイムアウトは課金対象の生成が未処理である証拠ではないため、長い生成や画像リクエストを無条件に再送しないでください。
安全な復旧
- 401: 不完全、失効、または誤った Key を置き換えます。サポート依頼に Key を貼り付けないでください。
- 403: Key のグループ、モデル表示、残高、ルート権限を確認します。
- 404: ここに示す Base URL を使い、完全な endpoint や二重の /v1 を設定しません。
- 429: 作業をキューイングし、ある場合は Retry-After に従います。バッチを並列再送しないでください。
- 5xx / timeout: 安全に再試行できる操作だけを限定して再試行します。時刻、route、model、HTTP status、request ID を匿名化ログに残します。
認証情報の境界
端末またはワークロードごとに Key を分けます。API Key、auth.json、完全な非公開プロンプト、パスワード、認証コード、決済情報をサポートへ送らないでください。漏えいが疑われた Key は直ちに無効化して置き換えます。