Skip to Content
aicentos

OpenClaw

OpenClaw で aicentos を使う —— カスタム Provider による接続

最終更新:

OpenClaw は AI コーディングアシスタントのコマンドラインツールで、カスタム Provider を通じて OpenAI 互換の API サービスに接続できます。公式では openclaw onboard ウィザードでの設定完了が推奨されており、設定ファイルを手動で書くこともできます。

準備

システムが以下の要件を満たしていることを確認します:

  • Node.js 22+ バージョン
  • macOS / Linux / Windows
  • ソースからビルドする場合は pnpm の追加インストールが必要

Node.js のインストール

macOS(Homebrew を使用):

brew install node

その他のシステム:

Node.js 公式サイトから LTS バージョンをダウンロードします:https://nodejs.org/en/download

インストールの確認

node -v
npm -v

注意: Windows ユーザーは WSL2 環境で OpenClaw を実行することをおすすめします。

OpenClaw のインストール

公式インストールスクリプトを使用します(推奨):

macOS / Linux

curl -fsSL https://openclaw.ai/install.sh | bash

Windows PowerShell

iwr -useb https://openclaw.ai/install.ps1 | iex

インストールスクリプトは不足している依存関係を自動検出して補完します。Node 環境をすでに自分で管理している場合は、npm や pnpm でのインストール方法も使えます(詳細は公式ドキュメントをご覧ください)。

セットアップウィザードの起動

ウィザードコマンドを実行します:

openclaw onboard

ウィザードで以下の情報を順に入力します:

  • Provider タイプ:Custom Provider を選択
  • Compatibility:OpenAI-compatible を選択
  • Base URL:https://aicentos.com/v1
  • API Key:あなたの API Key を入力
  • Model ID:コンソール「モデル広場」のモデル名を参考に入力
  • Endpoint ID:aicentos を推奨

注意: API Key は平文をそのまま入力すればよく、改めて環境変数 OPENAI_API_KEY にする必要はありません。

デフォルトモデルの設定

ウィザード完了後、デフォルトモデルを次のように設定します:

aicentos/gpt-4o

これで以降の使用時には、設定済みのモデルが自動的に使われます。

手動設定(任意)

ウィザードを使わない場合は、OpenClaw の provider 設定ファイルを直接編集できます:

{
  "models": {
    "providers": {
      "aicentos": {
        "baseUrl": "https://aicentos.com/v1",
        "apiKey": "your_api_key_here",
        "api": "openai-completions",
        "models": [
          { "id": "gpt-4o", "name": "gpt-4o" }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": { "primary": "aicentos/gpt-4o" }
    }
  }
}

設定には API Key の平文を直接書けるほか、環境変数参照も使えます(SecretRef 方式のほうが好みの場合)。

設定の確認

モデルのステータスをチェックして、接続が成功したことを確認します:

openclaw models list
openclaw models status

aicentos/gpt-4o が表示され、ステータスが正常なら、接続設定は成功です。

注意事項

  • OpenClaw はカスタム Provider 機能を公式サポートしており、OpenAI-compatible または Anthropic-compatible モードを選択できます
  • 現在のサービスに対しては、OpenAI-compatible モードを優先的に使うことをおすすめします
  • API Key を直接入力するのがデフォルトのやり方で、環境変数参照はあくまで任意の選択肢です
  • ツールで設定を自動書き込みしたい場合は、cc-switch ツールの利用を検討してください
  • 公式ドキュメントには他のインストール・設定方法も記載されており、実際のニーズに応じて選択できます

関連リンク