OpenClaw 配置API

OpenClaw 是一款开源的个人 AI 助手平台，支持多模型接入、自动化任务和本地化操作。本指南介绍如何将放心API 接入 OpenClaw。

系统要求

macOS 10.15+ 或主流 Linux 发行版（Ubuntu 18.04+、Debian 10+、CentOS 7+ 等）

步骤 1：安装 OpenClaw

在终端中执行以下命令：

安装完成后，验证：

步骤 2：在放心API创建两个分组的 API Key

OpenClaw 需要分别接入 Claude 和 Codex 两个不同厂商，对应放心API中的两个分组，需要各自创建一个 API Key。

打开浏览器，访问 https://fangxinapi.com，注册账号并登录

进入「API 密钥」或「令牌管理」页面

创建 Claude Code 分组 的 API Key，复制保存

创建 Codex 分组 的 API Key，复制保存

两个 Key 都要妥善保存，页面关闭后无法再次查看。

步骤 3：配置 OpenClaw

OpenClaw 的配置文件位于：

~/.openclaw/openclaw.json

如果文件不存在，先创建目录和文件：

用编辑器打开配置文件：

将 models 部分替换为以下内容。两个 provider 使用不同的 API Key，请分别在放心API控制台创建对应分组的密钥后填入：

{
  "models": {
    "mode": "merge",
    "providers": {

      "fangxin_claude": {
        "baseUrl": "https://fangxinapi.com",
        "apiKey": "放心API【Claude Code 分组】的 API Key",
        "api": "anthropic-messages",
        "models": [
          {
            "id": "claude-sonnet-4-6",
            "name": "claude-sonnet-4-6",
            "api": "anthropic-messages",
            "reasoning": false,
            "input": ["text"],
            "cost": {
              "input": 0,
              "output": 0,
              "cacheRead": 0,
              "cacheWrite": 0
            },
            "contextWindow": 200000,
            "maxTokens": 8192
          },
          {
            "id": "claude-opus-4-6",
            "name": "claude-opus-4-6",
            "api": "anthropic-messages",
            "reasoning": false,
            "input": ["text"],
            "cost": {
              "input": 0,
              "output": 0,
              "cacheRead": 0,
              "cacheWrite": 0
            },
            "contextWindow": 200000,
            "maxTokens": 8192
          }
        ]
      },

      "fangxin_codex": {
        "baseUrl": "https://fangxinapi.com/v1",
        "apiKey": "放心API【Codex 分组】的 API Key",
        "api": "openai-completions",
        "models": [
          {
            "id": "gpt-5.4",
            "name": "GPT-5.4",
            "reasoning": true,
            "input": ["text"],
            "cost": {
              "input": 0,
              "output": 0,
              "cacheRead": 0,
              "cacheWrite": 0
            },
            "contextWindow": 204800,
            "maxTokens": 131072
          }
        ]
      }

    }
  }
}

两个 provider 的区别：

	fangxin_claude	fangxin_codex
对应厂商	Anthropic Claude	OpenAI Codex
baseUrl	`https://fangxinapi.com`	`https://fangxinapi.com/v1`
API 格式	`anthropic-messages`	`openai-completions`
放心API分组	Claude Code 分组	Codex 分组

fangxin_claude 模型列表：

模型 ID（不可改）	name（可自定义）	说明
`claude-sonnet-4-6`	Claude Sonnet 4.6	Claude Sonnet 最新版，速度与能力均衡
`claude-opus-4-6`	Claude Oopus 4.6	Claude Opus 最新版，能力最强

fangxin_codex 模型列表：

模型 ID（不可改）	name（可自定义）	说明
`gpt-5.4`	GPT-5.4	OpenAI 最新代码生成模型

id 字段必须与放心API支持的模型 ID 完全一致，填错会导致请求失败。name 字段仅用于在 OpenClaw 界面中显示，可以自由修改为任意名称。

保存退出（nano 用户：Ctrl + X → Y → 回车）。

步骤 4：重启 OpenClaw 网关

配置文件修改完成后，需要重启网关让配置生效：

步骤 5：验证配置并切换模型

重启网关后，尝试发起一次对话，确认模型可以正常响应。

在对话框中输入以下命令可以切换模型：

/model fangxin_claude/claude-sonnet-4-6
/model fangxin_claude/claude-opus-4-6
/model fangxin_codex/gpt-5.4

格式为 provider名/模型ID，与配置文件中的 fangxin_claude、fangxin_codex 和各模型的 id 字段对应。

常见问题

❌ 连接失败 / 无法访问模型

排查步骤：

确认 baseUrl 填写正确，末尾不要有多余的斜杠（/）

确认 apiKey 已替换为实际密钥，不是占位文字

登录放心API控制台，确认该 Key 处于启用状态且有余额

检查 JSON 格式是否合法（可用 https://jsonlint.com 验证）

❌ JSON 格式错误导致 OpenClaw 无法启动

解决方法：用 JSON 校验工具检查配置文件，常见问题是多了或少了逗号、括号不匹配。

输出格式化后的 JSON 说明格式正确；若报错则按提示修复对应行。

❌ 模型列表为空

解决方法：确认 models 数组中至少有一个模型配置，且 id 字段与放心API支持的模型 ID 一致。登录放心API控制台查看当前可用的模型列表。

相关资源#

系统要求#

步骤 1：安装 OpenClaw#

步骤 2：在放心API创建两个分组的 API Key#

步骤 3：配置 OpenClaw#

步骤 4：重启 OpenClaw 网关#

步骤 5：验证配置并切换模型#

常见问题#

❌ 连接失败 / 无法访问模型#

❌ JSON 格式错误导致 OpenClaw 无法启动#

❌ 模型列表为空#

相关资源