OpenClaw の接続

難易度 ⌨️ 上級　|　インターフェース形式 OpenAI 互換　|　base_url https://byesu.com/v1

接続情報 · これらを入力

API アドレスhttps://byesu.com/v1

API キーsk-xxxxxxxxコンソールで作成 →

モデルgpt-5.5

API 形式 OpenAI 互換 · モデル名はコンソールに準拠

OpenClaw（🦞）は、カスタムのモデルプロバイダーに対応したオープンソースの個人向け AI アシスタントです。Byesu を指定するだけで利用でき、Windows / macOS / Linux のいずれでも手順は同じです。

始める前に

まずコンソール → トークンでトークンを作成してください（グループの選択を参照）。

方法その一：ウィザード（最も簡単）

インストール後に内蔵ウィザードを実行し、指示に従って「カスタム / OpenAI 互換」プロバイダーを選択します。

bash

openclaw onboard

順番に入力します。

インターフェースアドレス / baseUrl：https://byesu.com/v1
API key：ご自身の sk-xxxx
モデル：Byesu 上のモデル名を入力（例：gpt-5.5、claude-opus-4-8）

方法その二：設定ファイルを手動で編集

OpenClaw の設定ファイル（~/.openclaw/openclaw.json、JSON5 形式）の models.providers の下に、カスタムプロバイダーを 1 つ追加します。

json5

{
  agents: {
    defaults: { model: { primary: "byesu/gpt-5.5" } },   // 既定で使用するモデル
  },
  models: {
    mode: "merge",                   // 内蔵プロバイダーを上書きせず統合する
    providers: {
      byesu: {
        baseUrl: "https://byesu.com/v1",
        apiKey: "${BYESU_API_KEY}",      // 平文を避けるため環境変数の利用を推奨
        api: "openai-completions",       // OpenAI 互換
        models: [
          { id: "gpt-5.5", name: "Byesu GPT-5.5" },
          { id: "claude-opus-4-8", name: "Byesu Claude Opus 4.8" },
        ],
      },
    },
  },
}

いくつかのポイント

baseUrl には /v1 を付けます（OpenAI 互換）。
apiKey は環境変数 ${BYESU_API_KEY} の利用を推奨します（実際の key を環境変数に格納してください）。平文のまま git にコミットしないでください：export BYESU_API_KEY="sk-xxxx"。
Gateway をバックグラウンドサービス / デーモンとして実行する場合、サービスプロセスの環境にもこの変数を設定してください（現在のターミナルで export しただけでは読み取れず、401 エラーになります）。ローカルでのみ使用し git に入れない場合は、設定ファイルに key を直接書いても構いません。
models 内の id はコンソールのモデル名と一致させてください。
設定ファイルの正確なパスは openclaw onboard ウィザードが生成したものに従ってください（一部のバージョンでは ~/.config/openclaw/ にあります）。

接続を確認する

bash

openclaw models list     # byesu/ プレフィックス付きのモデルが選択肢に現れることを確認

openclaw dashboard で UI を開き、そのまま一言送って動作を試すこともできます。

うまくいかないときは？

エラーの意味が分からないときは、まず openclaw gateway --port 18789 でフォアグラウンド起動し、ログとエラーを直接観察してください。

401 / トークンが無効 → key の入力ミス、またはバックグラウンドサービスが環境変数 BYESU_API_KEY を読み取れていない（上記のポイントを参照）（詳細）
利用可能なチャネルがありません → モデルがトークンのグループに含まれていない（グループの選択、詳細）
その他はよくあるエラーと解決方法を参照

OpenClaw の接続 ​

方法その一：ウィザード（最も簡単） ​

方法その二：設定ファイルを手動で編集 ​

接続を確認する ​

うまくいかないときは？ ​

OpenClaw の接続

方法その一：ウィザード（最も簡単）

方法その二：設定ファイルを手動で編集

接続を確認する

うまくいかないときは？