OpenClaw付费模型API Key怎么配置?

阿萱吖_1756

阿萱吖_1756

2026-07-28

702人浏览

原创

openclaw接入付费大模型需确保使用openai兼容接口,api key必须通过环境变量openai_api_key、config.toml中llm区块或web ui的openai compatible选项正确配置,base_url须为/v1/chat/completions格式的兼容地址。

☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

openclaw付费模型api key怎么配置?

你需要在 OpenClaw 中接入付费大模型(比如 OpenAI、Anthropic、DeepSeek 商用版等),但填完 API Key 后始终提示“Authentication failed”或模型列表为空——这通常不是密钥本身错了,而是配置路径、环境变量或 TOML 文件结构出了问题。

确认模型服务商与 OpenClaw 兼容性

OpenClaw 当前(2026年7月)仅支持通过 OpenAI 兼容 API 接入的付费模型。这意味着:你不能直接填 Anthropic 的原生 Claude API Key,也不能直接填百度文心一言的 aip.baidubce.com 地址;必须使用已部署的、提供 /v1/chat/completions 接口的代理服务,或厂商明确标注“OpenAI-compatible”的商用 endpoint(如 DeepSeek-R1 在华为 MaaS、阿里云百炼、腾讯混元控制台中开启的 OpenAI 模式)。

不兼容的典型例子:https://api.anthropic.com/v1/messages → 会报错;https://dashscope.aliyuncs.com/api/v1/services/aigc/text-generation/generation → 不识别;https://api.deepseek.com/v1/chat/completions → ✅ 可用(DeepSeek 官方已开放 OpenAI 兼容接口)。

配置 API Key 的三种方式

方法一:环境变量(推荐用于 Docker 部署)
在启动容器前,将密钥写入宿主机 shell 环境:

export OPENAI_API_KEY=sk-xxxxxx-your-real-key-here
然后运行 docker run -e OPENAI_API_KEY -p 3000:3000 openclaw/openclaw。
【注意】环境变量名必须是 OPENAI_API_KEY,不能写成 CLAW_API_KEY 或 ANTHROPIC_API_KEY,否则 OpenClaw 启动时读不到。

Claude Cost Cli
Claude Cost Cli

通过命令行查询 Claude API 用量与费用报告。使用 macOS 钥匙串安全存储 Admin API 密钥。支持表格/JSON 输出。

下载

方法二:修改 config.toml(适用于本地 CLI 或 GUI 直接运行)
找到 OpenClaw 安装目录下的 config.toml(通常在 ~/.openclaw/config.toml 或项目根目录);
定位到 [llm] 区块;
确保以下三行存在且未被注释:

model = "deepseek-chat"
api_key = "sk-xxxxxx-your-real-key-here"
base_url = "https://api.deepseek.com/v1"
若使用其他厂商,请替换 base_url 为对应 OpenAI 兼容地址(例如百炼:https://dashscope.aliyuncs.com/compatible-mode/v1)。

方法三:首次启动时 Web UI 弹窗配置(仅限 Local GUI 模式)
启动 openclaw gui 后,浏览器自动打开 http://localhost:3000;
页面首次加载会弹出「LLM Setup」窗口;
选择 Provider → OpenAI Compatible(不是 OpenAI、不是 Anthropic);
在 Model 字段填具体模型名(如 deepseek-chat、qwen-max、claude-3-5-sonnet-20240620);
Base URL 填厂商提供的 OpenAI 兼容 endpoint;
【关键】API Key 必须粘贴进「API Key」输入框,而不是「Organization」或「Project」栏——后者留空即可。

验证配置是否生效

第一步:重启 OpenClaw 进程(如果是 Docker,先 docker stop 再 docker run;如果是本地 CLI,Ctrl+C 后重新执行 openclaw gui);
第二步:打开 http://localhost:3000,点击右上角齿轮图标 → 「LLM Settings」→ 查看「Status」栏是否显示绿色「Connected」;
第三步:在聊天框输入「请输出 JSON 格式:{"status": "ok", "model": "deepseek-chat"}」,观察是否返回合法 JSON 且无认证错误;
第四步:若返回 {"error": {"message": "Invalid API key", ...}},说明密钥格式错误或已被平台禁用;若返回 {"error": {"message": "Missing authorization header"}},说明 base_url 未生效或请求头未携带 key。

大量免费API接口:立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游,为数据API应用能力赋能!

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
OpenClaw如何卸载
OpenClaw如何卸载

《OpenClaw如何卸载?OpenClawAI小龙虾安全卸载最新指南》为您提供详尽、安全的卸载步骤,帮助用户彻底移除OpenClaw及其相关组件。本指南针对Windows与macOS系统分别说明操作流程,涵盖停止后台进程、清除配置文件、删除残留数据等关键环节,确保无痕卸载,避免系统冲突或隐私泄露。无论您是因更换工具、解决兼容问题,还是出于安全考虑,本文都将助您高效、安心地完成卸载操作。请务必按照最新版本指引执行,以保障设备稳定与数据安

2026.03.19

140

11

OpenClaw安装部署教程
OpenClaw安装部署教程

本合集涵盖2026最新版OpenClaw(小龙虾)本地部署全流程,适用于Windows系统,包含环境配置、模型接入、Web界面启动及飞书/Telegram/QQ等多平台对接。无论你是小白还是开发者,10分钟内即可完成安装,快速体验AI智能体“长手干活”的强大能力!

2026.03.19

201

11

OpenClaw初学者教程:如何使用和设置
OpenClaw初学者教程:如何使用和设置

《OpenClawAI初学者教程:如何使用和设置》是一套面向新手的入门指南,涵盖环境搭建、基础配置、模型加载及简单推理操作。通过本教程,你将快速掌握OpenClawAI的核心功能,轻松开启AI开发之旅。

2026.03.19

141

13

OpenClawAI技能系统基础介绍:OpenClawAISkills是什么
OpenClawAI技能系统基础介绍:OpenClawAISkills是什么

OpenClawAI Skills 是 OpenClaw 智能体的核心功能模块,用于定义和管理 AI 可执行的具体能力,如查询天气、发送消息、操作文件等。通过技能系统,用户可灵活扩展智能体功能,实现高度定制化的自动化任务。

2026.03.20

918

20

龙虾OpenClaw安全使用指南
龙虾OpenClaw安全使用指南

围绕龙虾OpenClawAI使用中的安全风险,本合集系统梳理常见漏洞与隐患,提供实用防护方法与最新安全指南,帮助用户在稳定运行的同时规避风险,提升整体使用安全性与体验。

2026.03.20

149

11

openclaw养虾硬件指南最新版
openclaw养虾硬件指南最新版

《OpenClawAI硬件指南最新版》合集聚焦AI硬件入门与进阶,从核心组件解析到实战搭建,系统讲解算力配置、设备选型与优化方案。内容通俗易懂,适合开发者与科技爱好者快速掌握AI硬件要点,构建高效稳定的智能计算环境。

2026.03.20

448

28

OpenClaw从新手到中级完整教程
OpenClaw从新手到中级完整教程

本专题专为零基础用户设计,带你从环境搭建到实战应用,系统掌握开源AI Agent OpenClaw。内容涵盖Node.js/Docker安装、API配置、Skills技能扩展及多平台集成,通过整理文件、自动化办公等真实案例,助你快速上手。无论你是想提升效率的职场人还是技术爱好者,都能在此找到从入门到精通的完整路径,打造专属的本地化AI助手。

2026.05.06

1062

32

OpenClaw免费大模型调用指南
OpenClaw免费大模型调用指南

PHP中文网特设OpenClaw免费大模型专区,提供详尽调用指南。涵盖免费API申请、模型配置及本地部署教程,助您零成本畅享AI智能体验。无论是新手入门还是进阶应用,这里都有实用干货,轻松跨越创作门槛,开启高效智能办公新方式。

2026.06.29

139

10

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程