OpenClaw

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 工具
• 官方文档还提供了其他安装和配置方式，可根据实际需求选择

相关链接复制锚点链接

• 官方文档：https://docs.openclaw.ai/install/index