openclaw配置第三方api记录

2026-05-06阅读 0热度 0

Chrome OpenClaw AI编程

为OpenClaw配置第三方API：一份详细指南

在成功安装OpenClaw之后，很多用户下一步都想接入自己的第三方大模型API，让这个强大的AI助手真正“为我所用”。今天，我们就来详细拆解一下配置过程。核心思路很简单：使用OpenClaw默认的 `agent main`，通过添加Provider（供应商）来实现。整个流程可以浓缩为几个关键步骤。

需要特别提醒的是，配置时请注意文件路径和字段名称的一致性，这是成功的关键。

配置流程总览

整个过程分为四步，其中第二步已被证实为非必需步骤，我们可以直接跳过：

第一步：修改主配置文件 `~/.openclaw/openclaw.json`，添加并定义models字段。这一步至关重要，它决定了在OpenClaw聊天框的agent菜单中，你的自定义模型选项是否可见。

第二步：配置 `~/.openclawagents/main/agent/models.json` —— 经过验证，此步不需要。

第三步：配置 `~/.openclawagents/main/agent/auth-profiles.json`，在这里填入你从第三方平台获取的API密钥和端点信息。

第四步：重启OpenClaw应用，让所有配置生效。

逐步详解与配置示例

下面，我们逐一看下每个需要修改的配置文件具体该怎么写。为了清晰起见，我们用“myapi”作为自定义Provider的名称，你在操作时完全可以换成其他名字，但务必确保所有出现该名称的地方都保持一致。

第一步：修改主配置文件 (~/.openclaw/openclaw.json)

这个文件是OpenClaw的核心设置所在。我们需要在JSON结构中添加一个 “models” 字段，并正确配置其中的 “providers”。

{
“meta”: {
“lastTouchedVersion”: “2026.2.17”,
“lastTouchedAt”: “2026-02-19T07:16:21.127Z”
},
“wizard”: {
“lastRunAt”: “2026-02-19T07:00:40.233Z”,
“lastRunVersion”: “2026.2.17”,
“lastRunCommand”: “doctor”,
“lastRunMode”: “local”
},
“models”: {
“providers”: {
“myapi”: { // 关键点：此处定义的“myapi”名称需全局一致
“baseUrl”: “你的第三方api的url”,
“apiKey”: “你的第三方token”,
“api”: “openai-completions”, // 注意：亲测填“openai compatible”不行，多数第三方平台支持此格式
“models”: [
{
“id”: “claude-3-7-sonnet-20250219”, // 替换为你实际调用的模型ID
“name”: “claude-3-7-sonnet-20250219”, // 模型显示名称
“contextWindow”: 200000,
“maxTokens”: 8192
}
]
}
}
},
“agents”: {
“defaults”: {
“model”: { // 此处设置默认使用的API
“primary”: “myapi/claude-3-7-sonnet-20250219”, // 格式为：Provider名称/模型ID
“fallbacks”: []
},
“models”: {
“openai/gpt-5.1-codex”: {
“alias”: “GPT”
},
“myapi/claude-3-7-sonnet-20250219”: { // 同样需要在此处添加别名映射
“alias”: “Claude”
}
},
“workspace”: “~/.openclaw/workspace”,
“compaction”: {
“mode”: “safeguard”
},
“maxConcurrent”: 4,
“subagents”: {
“maxConcurrent”: 8
}
},
“list”: [
{
“id”: “main”,
“name”: “main”,
“workspace”: “~/.openclaw/workspace”,
“agentDir”: “~/.openclaw/agents/main/agent”,
“model”: “myapi/claude-3-7-sonnet-20250219” // 指定main agent使用的模型
}
]
},
// … 文件其余部分保持不变
}

第二步：修改Agent认证配置文件 (~/.openclawagents/main/agent/auth-profiles.json)

这个文件负责具体的API认证信息。其结构与第一步的部分内容类似，但需要填写真实的URL和Key。

{
“models”: {
“providers”: {
“myapi”: {
“baseUrl”: “http://XXXXXXX”, // 你的第三方API服务地址
“apiKey”: “sk-XXXXXX”, // 你的API密钥
“api”: “openai-completions”, // 再次强调，填“openai-compatible”可能无法工作
“models”: [
{
“id”: “claude-3-7-sonnet-20250219”,
“name”: “claude-3-7-sonnet-20250219”,
“api”: “openai-completions”, // 这里也建议修改一下，确保一致性
“contextWindow”: 200000,
“maxTokens”: 8192
}
]
}
}
},
“agents”: {
“defaults”: {
“model”: {
“primary”: “myapi/claude-3-7-sonnet-20250219” // 名称保持一致是关键
},
“workspace”: “~/.openclaw/workspace”,
“compaction”: {
“mode”: “safeguard”
}
}
}
}

最后一步：重启与验证

完成以上所有文件的编辑和保存后，务必完全重启OpenClaw应用程序。重启后，打开聊天界面，检查agent菜单中是否出现了你自定义的模型选项（例如上文设置的“Claude”）。如果一切配置正确，现在你就可以开始使用自己的第三方API与OpenClaw进行交互了。

整个过程看似涉及多个文件，但只要抓住“全局名称一致”和“API格式正确”这两个要点，配置起来就能事半功倍。