# OpenClaw

来源: https://docs.aicentos.com/clients/openclaw

Language: zh-CN

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