# OpenClaw

來源: https://docs.aicentos.com/zh-TW/clients/openclaw

Language: zh-TW

> 在 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)