OpenClaw 如何配置第三方 API？

OpenClaw 是作为一个近期爆火 AI 助理系统，可以连接各种大模型服务（如 Claude、OpenAI、Gemini 等）。然而国内很多模型不够智能，很多人邮箱使用 OpenAI、Claude 等模型就要以来第三方API。如何让 OpenClaw 正常调用第三方模型或服务。今天结合 OpenClaw 配置生成器工具 实现更快速的配置第三方 API。

Openclaw 配置生产器

openclaw配置生成器

OpenClaw 的核心是通过一个配置文件（通常是 openclaw.json 或 config.yaml）来定义：

  • 哪个 API 提供商（Provider）
  • API 的基础地址（Base URL）
  • 访问令牌（API Key）
  • 使用的模型 ID
    等信息，让 OpenClaw 能够通过这些信息调用第三方 API 服务来生成 AI 响应等功能。

配置文件在哪里？

默认情况下，OpenClaw 的配置文件位于用户目录下，例如：

~/.openclaw/openclaw.json     # Linux / macOS
%USERPROFILE%\.openclaw\openclaw.json  # Windows

这个文件是 OpenClaw 核心配置的入口，所有第三方 API 及模型都在这里定义。

第一步：准备 API Key

在开始配置之前，你需要为要接入的第三方服务准备 API Key。例如我使用的是 ：

V-API

先在 https://api.gpt.ge/ 中登录并创建 API Key。

这里也可以使用自己的第三方API服务商， 请确保这些 Key 是有效的，并遵循服务商的使用规范。

第二步 使用配置生成器快速生成基础配置

如果你不想手写 JSON，可以使用在线配置生成工具 OpenClaw Config Generator：

🔗 官方生成器示例：https://coclaw.com/openclaw-config-generator/

这个工具提供可视化界面帮助你填写：

  • Base URL（API 地址）
  • 提供商名称
  • API 模式
  • 模型 ID
  • API Key

填写完毕后，点击按钮生成 JSON 配置内容，并复制粘贴到你的配置文件中即可。

例如，一个基础生成示例结构如下：

{
  "agents": {
    "defaults": {
      "model": {
        "primary": "anthropic/claude-opus-4.6"
      },
      "sandbox": {
        "mode": "non-main"
      }
    }
  },
  "gateway": {
    "mode": "local",
    "port": 18789,
    "bind": "loopback",
    "auth": {
      "mode": "token",
      "token": "${OPENCLAW_GATEWAY_TOKEN}"
    }
  },
  "tools": {
    "profile": "coding",
    "sandbox": {
      "tools": {
        "allow": [
          "bash",
          "process",
          "read",
          "write",
          "edit",
          "sessions_list",
          "sessions_history",
          "sessions_send",
          "sessions_spawn"
        ],
        "deny": [
          "browser",
          "canvas",
          "nodes",
          "cron",
          "discord",
          "gateway"
        ]
      }
    }
  }
}

在生成器中填写完毕后，即可得到这类完整段落 JSON，用于配置 OpenClaw。

第三步：手动编辑配置文件

如果你选择手工编辑配置文件，可以参照以下基本示例来添加第三方 API：

{
  "models": {
    "mode": "merge",
    "providers": {
      "openai": {
        "baseUrl": "https://api.openai.com/v1",
        "apiKey": "你的 OpenAI API Key",
        "api": "openai-completions",
        "models": [
          {
            "id": "gpt-4o",
            "name": "gpt-4o"
          }
        ]
      },
      "anthropic": {
        "baseUrl": "https://api.anthropic.com/v1",
        "apiKey": "你的 Claude API Key",
        "api": "anthropic-messages",
        "models": [
          {
            "id": "claude-sonnet-4-5",
            "name": "claude-sonnet-4-5"
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "openai/gpt-4o"
      }
    }
  }
}

上面的配置中同时定义了 OpenAI 和 Anthropic。你只需根据自己使用的服务提供商填写对应的 baseUrl 与 apiKey。

第四步：验证并重启 OpenClaw

编辑完后，确保你的 API Key 和模型 ID 都是正确的，然后重新启动 OpenClaw 的网关：

openclaw gateway restart

或直接运行：

openclaw gateway

此时 OpenClaw 就可以成功调用配置的第三方 API 了。正确的话你应该能在代理界面或日志中看到连接成功的信息。

标签

相关文章