OpenClaw

模型调用暂未开放

本页内容用于接入准备。调用开放后，请使用你自己的可用 Key，并把示例中的模型占位值换成模型广场中实际开放的型号。

需要哪种接口

普通对话（OpenAI Chat Completions）。在模型广场的「端点类型」里选择 Chat。

开始之前

完成实名认证，认证通过后重新登录一次。
在主站「API 密钥」页面创建一把 Key，复制并妥善保存。
在模型广场的「端点类型」筛选里选择 Chat（窄屏时点“筛选”按钮），从列出的模型中复制模型 ID。

另外需要先安装好 OpenClaw，安装方法见 OpenClaw 官方文档。

配置步骤

添加服务商

在 OpenClaw 的配置文件 ~/.openclaw/openclaw.json 中，加入下面第一个标签里的 models 和 agents 部分。文件里已有这两部分时，只合并其中的 aiput 和 primary 两项，不要整段覆盖。

设置 Key

示例里的 ${AIPUT_API_KEY} 表示从环境变量读取 Key，见第二、三个标签。要让 OpenClaw 的后台服务也能读到，请按 OpenClaw 官方说明设置它的运行环境。

重新加载配置

保存后，按 OpenClaw 的方式重启或重新加载，让配置生效。

openclaw.json · 配置示例

{
  "models": {
    "mode": "merge",
    "providers": {
      "aiput": {
        "baseUrl": "https://api.aiput.top/v1",
        "apiKey": "${AIPUT_API_KEY}",
        "api": "openai-completions",
        "models": [
          {
            "id": "MODEL_ID_FROM_CATALOG",
            "name": "MODEL_ID_FROM_CATALOG"
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "aiput/MODEL_ID_FROM_CATALOG"
      }
    }
  }
}

终端 · 设置 Key

export AIPUT_API_KEY='YOUR_API_KEY'

PowerShell · 设置 Key

$env:AIPUT_API_KEY = "YOUR_API_KEY"

各项的含义：

baseUrl：AIPUT 的地址，带 /v1。
api: "openai-completions"：按普通对话格式发送请求。
models：可用的模型，id 填模型广场里的模型 ID，不要加 aiput/ 前缀。
mode: "merge"：保留你已有的其他服务商。
primary：默认使用的模型，写成 aiput/模型 ID。

不想手写配置时，也可以运行 openclaw configure，选择自定义服务商（Custom provider），按提示填写同样的地址、Key 和模型 ID。

怎样确认配置成功

让 OpenClaw 回答一个简单的问题，能收到回复就说明配置成功。主站的使用日志里也能看到这次调用。

常见问题

现象	处理
提示找不到模型	确认 `primary` 写成 `aiput/模型 ID`，并且这个模型已列在 `models` 里
`401`	环境变量 `AIPUT_API_KEY` 没有设置，或 OpenClaw 的后台服务读不到它
`404`	`baseUrl` 只写到 `/v1`，不要多写路径
提示无法解析返回内容	`baseUrl` 少写了 `/v1`
"无可用渠道"	账户还没有实名认证、模型 ID 写错，或模型当前不可用，见常见问题

本页按 2026 年 10 月的 OpenClaw 版本编写，界面和配置项可能随版本变化，以 OpenClaw 官方说明为准。OpenClaw 的名称和商标归其所有者所有，这里只表示兼容。

本页目录