OpenClaw 接入第三方 LLM API 完整指南 | 含 NixAPI 配置

详细讲解 OpenClaw 如何接入第三方 LLM API，包括配置文件方式和对话方式。融合 NixAPI 实现低成本 GPT-5、Claude 等模型接入。

2026 年 3 月更新：本文基于 OpenClaw 最新版本编写，配置方式已验证有效。

快速开始

什么是 OpenClaw？

OpenClaw 是一个自托管网关，可以将你的聊天应用（WhatsApp、Telegram、Discord 等）连接到 AI 助手。它支持：

多通道网关：一个 Gateway 服务多个聊天应用
多代理路由：不同用户/场景使用不同模型
插件扩展：支持 Mattermost 等扩展
媒体支持：图片、音频、文档处理

为什么需要接入第三方 LLM API？

OpenClaw 默认使用 Pi 代理，但你可以接入自己的 LLM API 来获得：

更低的成本 - 使用 NixAPI 等中转服务
更好的模型 - GPT-5、Claude 3.5、Gemini 等
更高的可控性 - 自定义模型参数、上下文长度
数据隐私 - 自建服务，数据不经过第三方

接入方式一：配置文件方式（推荐）

1. 找到配置文件

OpenClaw 配置文件位于：

~/.openclaw/openclaw.json

2. 添加 NixAPI 提供商

在 models.providers 部分添加 NixAPI 配置：

{
  "models": {
    "mode": "merge",
    "providers": {
      "nixapi": {
        "baseUrl": "https://api.nixapi.com/v1",
        "apiKey": "${NIXAPI_API_KEY}",
        "api": "openai-completions",
        "models": [
          {
            "id": "gpt-5",
            "name": "GPT-5",
            "contextWindow": 200000,
            "maxTokens": 8192
          },
          {
            "id": "gpt-5.4",
            "name": "GPT-5.4",
            "contextWindow": 256000,
            "maxTokens": 8192
          },
          {
            "id": "gpt-5-mini",
            "name": "GPT-5 Mini",
            "contextWindow": 200000,
            "maxTokens": 8192
          },
          {
            "id": "claude-3-5-sonnet-20241022",
            "name": "Claude 3.5 Sonnet",
            "contextWindow": 200000,
            "maxTokens": 8192
          }
        ]
      }
    }
  }
}

3. 设置环境变量

在配置文件中添加 API Key：

{
  "env": {
    "NIXAPI_API_KEY": "nix-你的 API Key"
  }
}

或者在终端中设置：

export NIXAPI_API_KEY="nix-你的 API Key"

4. 配置代理模型

在 agents.defaults.model 中设置默认和备用模型：

{
  "agents": {
    "defaults": {
      "model": {
        "primary": "nixapi/gpt-5.4",
        "fallbacks": [
          "nixapi/gpt-5",
          "nixapi/gpt-5-mini",
          "nixapi/claude-3-5-sonnet-20241022"
        ]
      }
    }
  }
}

5. 为不同代理配置不同模型

{
  "agents": {
    "list": [
      {
        "id": "main",
        "model": "nixapi/gpt-5.4"
      },
      {
        "id": "coding-agent",
        "name": "coding-agent",
        "model": "nixapi/claude-3-5-sonnet-20241022",
        "identity": {
          "name": "Coding Assistant",
          "emoji": "💻"
        }
      },
      {
        "id": "cheap-agent",
        "name": "cheap-agent",
        "model": "nixapi/gpt-5-mini",
        "identity": {
          "name": "Budget Assistant",
          "emoji": "💰"
        }
      }
    ]
  }
}

6. 完整配置示例

{
  "meta": {
    "lastTouchedVersion": "2026.3.13",
    "lastTouchedAt": "2026-03-19T00:00:00.000Z"
  },
  "env": {
    "NIXAPI_API_KEY": "nix-你的 API Key"
  },
  "models": {
    "mode": "merge",
    "providers": {
      "nixapi": {
        "baseUrl": "https://api.nixapi.com/v1",
        "apiKey": "${NIXAPI_API_KEY}",
        "api": "openai-completions",
        "models": [
          {
            "id": "gpt-5",
            "name": "GPT-5",
            "contextWindow": 200000,
            "maxTokens": 8192
          },
          {
            "id": "gpt-5.4",
            "name": "GPT-5.4",
            "contextWindow": 256000,
            "maxTokens": 8192
          },
          {
            "id": "gpt-5-mini",
            "name": "GPT-5 Mini",
            "contextWindow": 200000,
            "maxTokens": 8192
          },
          {
            "id": "claude-3-5-sonnet-20241022",
            "name": "Claude 3.5 Sonnet",
            "contextWindow": 200000,
            "maxTokens": 8192
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "nixapi/gpt-5.4",
        "fallbacks": [
          "nixapi/gpt-5",
          "nixapi/gpt-5-mini"
        ]
      },
      "workspace": "/root/.openclaw/workspace",
      "maxConcurrent": 4
    },
    "list": [
      {
        "id": "main",
        "model": "nixapi/gpt-5.4"
      }
    ]
  }
}

7. 重启 Gateway

配置完成后重启 OpenClaw Gateway：

# 重启 Gateway
openclaw gateway restart

# 或者停止后重新启动
openclaw gateway stop
openclaw gateway start

接入方式二：对话方式（动态配置）

OpenClaw 支持通过对话动态配置模型，适合临时切换。

1. 使用命令配置

通过 Telegram 或其他聊天通道发送命令：

/model nixapi/gpt-5.4

2. 查看当前模型

/status

返回示例：

📊 Session Status
Model: nixapi/gpt-5.4
Workspace: /root/.openclaw/workspace
Sessions: 3 active

3. 切换不同代理

/agent coding-agent

然后后续对话将使用 coding-agent 配置的模型。

NixAPI 价格对比

NixAPI 模型价格（2026 年 3 月）

模型	Model ID	价格 (¥/1M tokens)	适用场景
GPT-5	`gpt-5`	¥0.625	旗舰模型，最强推理
GPT-5.4	`gpt-5.4`	¥1.25	新款旗舰，平衡性能
GPT-5 Mini	`gpt-5-mini`	¥0.125	高性价比日常任务
Claude 3.5 Sonnet	`claude-3-5-sonnet-20241022`	¥1.5	代码能力强

💡 价格说明：以上为 NixAPI 人民币价格，1 人民币充值 = 1 美元额度。相比 OpenAI 官方价格节省约 94%！

常见问题解答

Q1: 如何获取 NixAPI API Key？

答：访问 NixAPI 官网注册账号，进入控制台 → API Keys → 新建，复制密钥（格式：nix-xxxxxxxxxxxx）。

Q2: 配置文件修改后不生效怎么办？

答：

检查 JSON 语法是否正确（使用 JSON Validator）
确保环境变量已设置
重启 Gateway：openclaw gateway restart
查看日志：openclaw gateway logs

Q3: 如何验证配置是否成功？

答：发送 /status 命令，查看当前使用的模型是否为配置的 NixAPI 模型。

Q4: 可以同时配置多个 API 提供商吗？

答：可以。在 models.providers 中添加多个提供商：

{
  "models": {
    "providers": {
      "nixapi": {
        "baseUrl": "https://api.nixapi.com/v1",
        "apiKey": "${NIXAPI_API_KEY}",
        "api": "openai-completions",
        "models": [...]
      },
      "moonshot": {
        "baseUrl": "https://api.moonshot.ai/v1",
        "apiKey": "${MOONSHOT_API_KEY}",
        "api": "openai-completions",
        "models": [...]
      }
    }
  }
}

Q5: 如何为不同用户配置不同模型？

答：创建多个 agent，每个 agent 配置不同模型：

{
  "agents": {
    "list": [
      {
        "id": "vip-agent",
        "model": "nixapi/gpt-5.4-pro"
      },
      {
        "id": "standard-agent",
        "model": "nixapi/gpt-5"
      },
      {
        "id": "budget-agent",
        "model": "nixapi/gpt-5-mini"
      }
    ]
  },
  "bindings": [
    {
      "agentId": "vip-agent",
      "match": {
        "channel": "telegram",
        "accountId": "vip_user_bot"
      }
    },
    {
      "agentId": "standard-agent",
      "match": {
        "channel": "telegram",
        "accountId": "standard_user_bot"
      }
    }
  ]
}

下一步

👉 注册 NixAPI — 免费体验，送 $0.2 额度
💰 模型价格 — 实时价格查询
🔧 API 文档 — 完整接口文档
📖 OpenClaw 官方文档 — 完整配置参考
💰 GPT-5 接入指南 — 5 分钟快速上手
🔧 模型对比评测 — 选择最适合的模型

关于作者：NixAPI Team 专注于大语言模型 API 服务，帮助 20 万 + 开发者低成本接入 GPT-5、Claude 等主流模型。

OpenClaw 接入第三方大语言模型 API 完整指南（含 NixAPI）