OpenClaw 完全开源，你可以在 OpenClaw 的 GitHub 仓库浏览源码、提交 Issue 或参与贡献。本教程涵盖安装、配置，以及将 OpenClaw 对接 AiXor API 的完整步骤。

一、自行配置接入

📦 接入前准备

在开始接入 Aixor API 之前，建议先按 OpenClaw 官方当前推荐流程把 Gateway 和 Control UI 跑起来。这样后续排查问题时，更容易区分是 OpenClaw 本身未启动，还是模型提供商配置有误。

1. 安装 OpenClaw（macOS/Linux）

其他安装方式可参考 OpenClaw 官方文档：Getting Started。

2. 运行引导向导

该向导会完成基础认证、Gateway 设置，以及可选的渠道初始化。这里的目标是先把 OpenClaw 跑起来，后面再把默认模型切到 Aixor API。

3. 检查 Gateway 与 Control UI

如果浏览器能打开 Control UI，说明 OpenClaw 基础运行已经正常。这个阶段不需要先配置 Telegram、Discord、飞书等消息渠道。

4. 定位配置文件

OpenClaw 的配置文件通常位于 ~/.openclaw/openclaw.json，你可以在引导向导生成的基础上继续修改。

🚀 使用 AiXor API 作为模型提供商

OpenClaw 支持通过 models.providers 接入自定义或兼容 OpenAI 接口的模型网关。对于 AiXor API，最常见的做法是把它作为一个自定义 provider 加进配置里，再把默认模型指向 aixorapi/模型ID。

接入思路

在 models.providers 下声明一个 aixorapi provider

将 baseUrl 指向你的 AiXor API 地址，并确保包含 /v1

将 api 设为 openai-completions

在 models 中列出你希望 OpenClaw 使用的模型 ID

在 agents.defaults.model.primary 中把默认模型切到 aixorapi/...

推荐做法：用环境变量保存密钥

先在当前 shell、服务环境，或 OpenClaw 可读取的 .env 中提供你的 AiXor API 密钥：

然后在 openclaw.json 里补充或修改以下片段：

{
  models: {
    mode: "merge",
    providers: {
      aixor: {
        baseUrl: "https://<your-aixorapi-domain>/v1",
        apiKey: "${AIXORAPI_API_KEY}",
        api: "openai-completions",
        models: [
          { id: "gpt-5.2", name: "gpt-5.2" },
          { id: "gpt-5", name: "gpt-5" },
        ],
      },
    },
  },

  agents: {
    defaults: {
      model: {
        primary: "aixorapi/gpt-5.2",
        fallbacks: ["aixorapi/gpt-5"],
      },
      models: {
        "aixorapi/gpt-5.2": { alias: "gpt-5.2" },
        "aixorapi/gpt-5": { alias: "gpt-5" },
      },
    },
  },
}

这不是一份必须原样照抄的完整配置，而是接入 AiXor API 最关键的部分。只要 provider、模型 ID 和默认模型引用对应正确，OpenClaw 就能通过 AiXor API 调用你暴露出来的模型资源。

关键配置说明

配置项	说明
`models.mode`	建议设为 `merge`，在保留 OpenClaw 内置 provider 的同时追加 `aixorapi`
`models.providers.aixorapi.baseUrl`	你的 AiXor API 地址，通常需要带上 `/v1`
`models.providers.aixorapi.apiKey`	AiXor API 密钥，推荐通过 `${AIXORAPI_API_KEY}` 注入
`models.providers.aixorapi.api`	对于 AiXor API 这类 OpenAI 兼容网关，使用 `openai-completions`
`models.providers.aixorapi.models`	这里列出的模型 ID 必须与你的 AiXor API 实际暴露的模型名称一致
`agents.defaults.model.primary`	默认主模型，格式必须是 `provider/model-id`
`agents.defaults.model.fallbacks`	备选模型列表，主模型失败时自动切换
`agents.defaults.models`	可选，用来给模型起别名，方便在 UI 或会话里引用