玩转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 用量与计费情况

相关文章
|
4天前
|
人工智能 自然语言处理 文字识别
阿里云百炼Qwen3.7-Max简介:能力、优势、支持订阅计划参考
Qwen3.7-Max是阿里云百炼面向智能体时代推出的新一代旗舰模型,对标GPT-5.5、Claude Opus 4.7等闭源旗舰。该模型支持百万级token上下文窗口,具备顶级推理能力、多模态搜索与视觉理解增强、流式输出低延迟响应等核心优势,覆盖编程、办公、长周期自主执行等复杂场景。同时支持OpenAI接口兼容,便于系统快速迁移。用户可通过Token Plan团队或节省计划等订阅方式灵活调用,适合企业级高要求场景使用。
1984 7
阿里云百炼Qwen3.7-Max简介:能力、优势、支持订阅计划参考
|
12天前
|
人工智能 开发工具 iOS开发
Claude Code 新手完全上手指南:安装、国产模型配置与常用命令全解
Claude Code 是一款运行在终端环境中的 AI 编程助手,能够直接在命令行中完成代码生成、项目分析、文件修改、命令执行、Git 管理等开发全流程工作。它最大的特点是**任务驱动、终端原生、轻量高效、多模型兼容**,无需图形界面、不依赖 IDE 插件,能够深度融入开发者日常工作流。
3370 10
|
14天前
|
Shell API 开发工具
Claude Code 快速上手指南(新手友好版)
AI编程工具卷疯啦!Claude Code凭借任务驱动+终端原生的特性,成了开发者的效率搭子。本文从安装、登录、切换国产模型到常用命令,手把手带新手快速上手,全程避坑,30分钟独立用起来。
3420 24
|
8天前
|
人工智能 Linux BI
国内用 Claude Code 终于不用翻墙了:一行命令搞定,自动接 DeepSeek
JeecgBoot AI专题研究 一键脚本:Claude Code + JeecgBoot Skills + DeepSeek 全平台接入 一行命令装好 Claude Code + JeecgBoot Skills + DeepSeek 接入,无需翻墙使用 Claude Code,支持 Wind
2517 5
国内用 Claude Code 终于不用翻墙了:一行命令搞定,自动接 DeepSeek
|
27天前
|
人工智能 JSON 供应链
畅用7个月无影 JVS Claw |手把手教你把JVS改造成「科研与产业地理情报可视化大师」
LucianaiB分享零成本畅用JVS Claw教程(学生认证享7个月使用权),并开源GeoMind项目——将JVS改造为科研与产业地理情报可视化AI助手,支持飞书文档解析、地理编码与腾讯地图可视化,助力产业关系图谱构建。
23606 15
畅用7个月无影 JVS Claw |手把手教你把JVS改造成「科研与产业地理情报可视化大师」
|
6天前
|
人工智能 自然语言处理 安全
Claude Code 全攻略:命令大全+三种模式+记忆体系+实战工作流完整手册
Claude Code 是当前最流行的终端级 AI 编程助手,能够直接在命令行中完成代码生成、项目理解、文件修改、命令执行、错误修复等全流程开发工作。它不依赖图形界面、不占用额外资源,却能深度理解项目结构,自动生成规范代码,大幅提升研发效率。
1081 3
|
13天前
|
存储 Linux iOS开发
【2026最新】MarkText中文版Markdown编辑器使用图解(附安装包)
MarkText是一款免费开源、跨平台的Markdown编辑器,主打所见即所得实时预览,支持Windows/macOS/Linux。内置数学公式、流程图、代码高亮、多主题及PDF/HTML导出,是Typora的轻量免费替代首选。(239字)

热门文章

最新文章