OpenClaw

OpenClaw は TokenHub の OpenAI compatible 互換 API ゲートウェイ経由でモデルリクエストを送信できます。公式のインストール手順はそのまま使い、API key、Base URL、モデル ID だけを置き換えます。

このガイドで使う TokenHub endpoint は https://us-api.tokenhub.com/v1/chat/completions です。

使う場面

小さなリポジトリや検証用プロジェクトから始めます。まずは読み取り、コード説明、計画作成を試し、その後で編集や自動化タスクを有効にします。

インストールまたは起動

まず OpenClaw 公式ドキュメント に従ってインストールまたは起動します。画面名が違う場合は現在の公式ドキュメントを優先してください。

CLI ツールの場合、TokenHub 認証情報を追加する前に実行ファイルが使えることを確認します：

openclaw --version

TokenHub 認証情報を準備

TokenHub API key を作成し、TokenHub のモデル一覧からこのツールに適したモデルを選びます。

export TOKENHUB_API_KEY="sk-..."

キーはローカル shell、IDE のシークレット保存領域、またはツールの安全な API key 欄に保存します。リポジトリにはコミットしないでください。

TokenHub プロバイダーを設定

Models、Providers、API Keys、OpenAI Compatible などの設定画面で次の値を入力します。

Provider の値

Use the official custom provider guide for the current models.providers schema and OpenAI-compatible adapter behavior.

設定ファイルの場所

Store the key where the managed Gateway can read it:

TOKENHUB_API_KEY=your-local-tokenhub-key

Add the custom provider to ~/.openclaw/openclaw.json:

{
  models: {
    mode: 'merge',
    providers: {
      tokenhub: {
        baseUrl: '__API_BASE_URL__/v1',
        apiKey: '${TOKENHUB_API_KEY}',
        api: 'openai-completions',
        models: [
          {
            id: 'gpt-4.1',
            name: 'TokenHub / gpt-4.1',
            reasoning: false,
            input: ['text'],
            contextWindow: 128000,
            maxTokens: 8192,
          },
        ],
      },
    },
  },
  agents: {
    defaults: {
      model: {
        primary: 'tokenhub/gpt-4.1',
      },
    },
  },
}

Replace the example model metadata with the actual limits and capabilities of the TokenHub model you selected. Keep the catalog id bare, then add the provider prefix only when selecting it as tokenhub/gpt-4.1.

Restart the Gateway and verify the custom provider:

openclaw gateway restart
openclaw models list --provider tokenhub
openclaw models set "tokenhub/gpt-4.1"

The API key remains in ~/.openclaw/.env so launchd, systemd, Docker, and other managed Gateway processes can read it.

ツールが chat、edit、apply、fast model を分けている場合、最初のテストでは同じ TokenHub モデルを使います。動作確認後にコスト、レイテンシ、推論力で分けます。

一時環境変数はデバッグ用

一時変数は key、ネットワーク、モデル名の確認にだけ使います。確認後は同じ値を上の永続設定に移してください。

export TOKENHUB_API_KEY="sk-..."

接続を確認

まず読み取り専用のプロンプトで、モデルが文脈を読めること、ファイルを変更しないことを確認します。その後、編集や Agent タスクを試します。

このプロジェクトの README を読み、3 文で要約してください。ファイルは変更しないでください。

プロンプトが成功したら、TokenHub のリクエストログでモデル名、endpoint、token 使用量、課金グループを確認します。

トラブルシューティング