# OpenClaw

出典: https://docs.aicentos.com/ja/clients/openclaw

Language: ja

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

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

## 準備

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

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

### Node.js のインストール

**macOS（Homebrew を使用）：**

```bash
brew install node
```

**その他のシステム：**

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

### インストールの確認

```bash
node -v
npm -v
```

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

## OpenClaw のインストール

公式インストールスクリプトを使用します（推奨）：

### macOS / Linux

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

### Windows PowerShell

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

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

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

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

```bash
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` にする必要はありません。

## デフォルトモデルの設定

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

```text
aicentos/gpt-4o
```

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

## 手動設定（任意）

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

```json
{
  "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 方式のほうが好みの場合）。

## 設定の確認

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

```bash
openclaw models list
openclaw models status
```

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

## 注意事項

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

## 関連リンク

* 公式ドキュメント：[https://docs.openclaw.ai/install/index](https://docs.openclaw.ai/install/index)