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 | bashWindows 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 statusaicentos/gpt-4o が表示され、ステータスが正常なら、接続設定は成功です。
注意事項
- OpenClaw はカスタム Provider 機能を公式サポートしており、OpenAI-compatible または Anthropic-compatible モードを選択できます
- 現在のサービスに対しては、OpenAI-compatible モードを優先的に使うことをおすすめします
- API Key を直接入力するのがデフォルトのやり方で、環境変数参照はあくまで任意の選択肢です
- ツールで設定を自動書き込みしたい場合は、
cc-switchツールの利用を検討してください - 公式ドキュメントには他のインストール・設定方法も記載されており、実際のニーズに応じて選択できます