玩转OpenClaw|OpenClaw接入自定义大模型教程

简介: 本文详解OpenClaw(Clawdbot)的快速上手与自定义AI模型接入方法,支持QQ/企微/飞书/钉钉等国内IM,并提供腾讯云DeepSeek、硅基流动、Gemini、GPT、Claude、OpenRouter等10+主流厂商配置模板及通用JSON格式,含参数说明与常见错误排查指南。

想必大家已经知道并且玩上OpenClaw(Clawdbot)了

还不知道OpenClaw是什么?一篇文章搞懂并教你快速搭建属于自己的OpenClaw >>

现在Lighthouse已经适配了国内的im软件(QQ、企业微信、飞书、钉钉),可以直接使用面板来完成配置。同样,面板也支持了许多主流大模型提供商,那么如果我们有其他的第三方提供商(例如七牛、硅基流动等)需要配置,这篇文章教会你如何接入这些第三方提供商。

重要

在选择模型提供商时,请确定你的轻量应用服务器地域在模型提供商支持的地域中

接入自定义AI提供商

只要在轻量应用服务器控制台,应用管理中将下方的自定义模型相关字段填写进去后点击保存即可完成自定义模型的配置:

腾讯云DeepSeek

以阿里云DeepSeek,使用DeepSeek V3.2模型为例:

获取APIKey

代码语言:json

AI代码解释

{
  "provider": "qcloudlkeap",
  "base_url": "https://api.lkeap.cloud.tencent.com/v1",
  "api": "openai-completions",
  "api_key": "your-api-key-here",
  "model": { "id": "deepseek-v3.2", "name": "deepseek-v3.2" }
}

硅基流动

以硅基流动,使用"OpenAI"协议,使用DeepSeekv3.2模型为例:

代码语言:json

AI代码解释

{
  "provider": "siliconflow",
  "base_url": "https://api.siliconflow.cn/v1",
  "api": "openai-completions",
  "api_key": "your-api-key-here",
  "model": {
    "id": "deepseek-ai/DeepSeek-V3.2",
    "name": "DeepSeek-V3.2"
  }
}

Google Gemini

使用 Google Gemini API,以Gemini 3.1 Pro 模型为例:

代码语言:json

AI代码解释

{
  "provider": "google",
  "base_url": "https://generativelanguage.googleapis.com/v1beta/openai",
  "api": "openai-completions",
  "api_key": "your-api-key-here",
  "model": {
    "id": "gemini-3.1-pro-preview",
    "name": "Gemini 3.1 Pro"
  }
}

OpenAI (GPT)

使用 OpenAI 官方 API,以最新的 GPT-5.2 模型为例:

代码语言:json

AI代码解释

{
  "provider": "openai",
  "base_url": "https://api.openai.com/v1",
  "api": "openai-completions",
  "api_key": "your-api-key-here",
  "model": {
    "id": "gpt-5.2",
    "name": "GPT-5.2"
  }
}

Anthropic Claude

使用 Anthropic Claude API,以最新的 Claude Opus 4.6 模型为例:

代码语言:json

AI代码解释

{
  "provider": "anthropic",
  "base_url": "https://api.anthropic.com",
  "api": "anthropic-messages",
  "api_key": "your-api-key-here",
  "model": {
    "id": "claude-opus-4-6",
    "name": "Claude Opus 4.6"
  }
}

OpenRouter

使用 OpenRouter API(兼容 OpenAI 协议),以NVIDIA: Nemotron 3 Nano 30B A3B 模型(限时免费)为例:

代码语言:json

AI代码解释

{
  "provider": "openrouter",
  "base_url": "https://openrouter.ai/api/v1",
  "api": "openai-completions",
  "api_key": "your-api-key-here",
  "model": {
    "id": "nvidia/nemotron-3-nano-30b-a3b:free",
    "name": "NVIDIA: Nemotron 3 Nano 30B A3B"
  }
}

通用配置模板

如果上述没有你想要的模型,可以使用以下通用模板接入任何兼容OpenAI/Anthropic协议的模型:

代码语言:json

AI代码解释

{
  "provider": "provider_name",
  "base_url": "baseurl",
  "api": "API协议",
  "api_key": "your-api-key-here",
  "model": {
    "id": "model_id",
    "name": "model_name"
  }
}

单次配置多个模型

代码语言:txt

AI代码解释

{
  "provider": "provider_name",
  "base_url": "baseurl",
  "api": "API协议",
  "api_key": "your-api-key-here",
  "model": [{
    "id": "model1",
    "name": "model1"
  },{
    "id": "model2",
    "name": "model2"
  },{
    "id": "model3",
    "name": "model3"
  },{
    "id": "model4",
    "name": "model4"
  }]
}

参数说明

参数

说明

示例

provider

提供商名称,自定义即可

siliconflow

base_url

API 基础地址

https://api.siliconflow.cn/v1

api

API 协议类型:openai-completions 用于兼容 OpenAI Chat Completions API 的模型;anthropic-messages 用于兼容 Anthropic Messages API 的模型

openai-completions

api_key

提供商的 API 密钥

sk-xxx

model.id

模型的唯一标识符

deepseek-ai/DeepSeek-V3.2

model.name

模型的显示名称

DeepSeek-V3.2

常见问题

报错(错误码相关)

99%的错误码都可以通过长按翻译了解原因

常见错误码

错误码因提供商不同可能略有出入,仅供参考。

错误码

原因

解决方案

401 not authorized

apikey不正确

前往模型提供商检查写入的APIKey是否正确

429/500

余额不足

充钱或检查APIKey是否正确

rate_limit

速率限制

更换提供商,或联系提供商获取更大配额 名词释义: RPM(Requests Per Minute)表示每分钟请求数。 TPM(Tokens Per Minute)表示每分钟处理的Tokens数量。

404

baseurl不对

查看提供商文档寻找兼容 OpenAI Chat Completions API 或 Anthropic Messages API 的baseurl地址

403

该模型不支持此服务器地域

更换服务器地域为模型支持的地域或更换模型

模型回复慢(响应慢)

若您选择的轻量应用服务器为境外地域且使用境内通道/模型提供商可能会因跨境网络原因导致延迟较高。

若您选择深度思考模型可能因上下文过多导致模型思考时间过长,推荐您选择非思考模型/快思考模型进行替代。

Token消耗过快

OpenClaw 在调用模型时会携带较多上下文信息,以保证任务连贯性与准确性,因此 Token 消耗可能较高。建议在使用时关注 Token 用量与计费情况

相关文章
|
29天前
|
人工智能 弹性计算 API
阿里云轻量应用服务器低成本部署OpenClaw方案:2核2G38元,2核4G199元,全球多地域可选
2026年阿里云轻量应用服务器低成本部署OpenClaw AI助理的方案:用户可通过每天10:00和15:00的限量抢购活动,以38元/年(2核2G/40G云盘)或9.9元/月、199元/年(2核4G/50G云盘)的价格入手服务器,预装OpenClaw镜像实现分钟级一键部署,免代码上手。部署后可通过Web UI或飞书、钉钉、QQ、企业微信等IM工具与AI智能体交互,并支持扩展Skill和自定义RPA流程。方案覆盖个人博客、AI应用开发等场景,大幅降低了AI Agent的技术与资金门槛,是低成本拥抱AI智能体的实用路径。
|
2月前
|
人工智能 自然语言处理 安全
【新手保姆级教程】10 分钟搭建 OpenClaw 本地 AI 智能体操作指南
OpenClaw(小龙虾)是GitHub星标超28万的开源AI数字员工,支持Windows一键部署。本地运行、零代码、自动执行任务,10分钟即可完成安装,轻松实现文件整理、浏览器自动化、微信操作等,新手友好,隐私安全。
|
3月前
|
JavaScript API 网络安全
阿里云 x OpenClaw(Clawdbot) 保姆级部署配置教程(全网最简单)附百炼API配置及避坑指南
OpenClaw(原Clawdbot)作为开源AI自动化代理工具,凭借自然语言任务拆解、多工具集成调用、7×24小时不间断运行的特性,成为个人办公自动化与轻量团队协作的优选工具。其核心优势在于无需复杂编程基础,仅通过简单配置与指令,即可实现系统文件读写、终端命令执行、浏览器自动化、邮件/日程管理等多样化任务,大幅提升工作效率。
2879 0
|
7天前
|
设计模式 人工智能 数据可视化
Agentic 设计模式拆解:6 种结构的优缺点与应用场景
本文系统梳理Agentic AI六大核心设计模式:单一、顺序、并行智能体,循环评审,协调者与子智能体,以及作为工具的子智能体。聚焦智能体、用户、模型与工具间的结构化交互,提炼可复用的工程骨架,助力规模化落地。
139 5
Agentic 设计模式拆解:6 种结构的优缺点与应用场景
|
4天前
|
人工智能 自然语言处理 测试技术
🦞 实测:阿里云部署 OpenClaw 成本对比,云服务 vs 本地部署性价比深度分析
本文实测阿里云部署OpenClaw成本,对比云服务与本地部署性价比。详解其六大场景:超级助理、内容创作、股票分析、一人团队、开发助手、海外运营,支持零代码3分钟快速部署,依托通义千问大模型,安全高效、灵活扩展。(239字)
|
7天前
|
弹性计算 人工智能 监控
零基础上手Hermes Agent 阿里云轻量/ECS/计算巢/无影云电脑部署+Token Plan配置指南
在AI智能体快速普及的当下,Hermes Agent凭借自主学习、长期记忆、多工具协同、任务自主拆解等核心特性,已经成为办公自动化、行业研究、代码开发、数据采集领域的热门开源智能体。和普通对话机器人不同,Hermes Agent不只是简单问答,还能自主拆分复杂工作、调用浏览器、代码解释器、文件管理等工具,完成从资料搜集、文案撰写、数据分析到流程自动化的全链路任务。
176 2
|
7天前
|
人工智能 自然语言处理 测试技术
有手就行!阿里云 OpenClaw 六大用途,官方镜像开箱即用教程
阿里云OpenClaw是基于通义千问大模型打造的智能助理平台,面向开发者、创作者等提供六大核心场景支持:超级助理、内容创作、股票分析、一人团队、开发助手和海外运营。零代码3分钟即可部署,安全可靠、成本优化,助力高效成长与业务增长。(239字)
|
人工智能 运维 关系型数据库
智能运维+多模型服务能力,阿里云 RDS AI 助手旗舰版正式上线!
RDS AI 助手旗舰版在 RDS AI 助手专业版智能运维能力的基础上,提供灵活模型选择、智能模型路由、多模型灾备、API Key 集成等更自主可控、灵活便捷的模型服务,并支持纳管运维各类环境部署的数据库。
智能运维+多模型服务能力,阿里云 RDS AI 助手旗舰版正式上线!

热门文章

最新文章