如何在 OpenClaw 配置腾讯云混元 API

OpenClaw x 腾讯云高性能模型限时折扣活动→ https://cloud.tencent.com/act/pro/moltbotandai

欢迎扫码加入OpenClaw×腾讯云大模型接入交流群：

🦞 OpenClaw 是什么

OpenClaw（原 Moltbot、Clawdbot）是一款开源的 AI 个人助手，支持本地部署，兼容 MacOS、Windows 及 Linux 等多种系统，并支持接入常用聊天工具，让用户通过自然语言控制各种设备和服务。 它是一个功能强大的自动化工具，支持混元、Claude、GPT 等主流大语言模型，能够帮助用户处理邮件、日程安排、市场调研等多种自动化任务。

使用场景举例：

• 24 小时在线的 AI 助手服务
• 自动化处理日常任务（邮件、日程、提醒等）
• 连接各种 API 和服务，实现自定义自动化流程
• 作为个人知识库，随时回答你的问题

💻 安装 OpenClaw 与配置混元 API

提示：Moltbot 于 2026.01.30 正式更名OpenClaw 。若执行 openclaw 命令报 command not found，请改用 moltbot。

1）安装与配置 OpenClaw

安装前置条件 确认 Node.js 版本：OpenClaw 要求 Node >= 22。如果不是 22+，需要先升级 Node。

node -v

一键安装OpenClaw 根据 OpenClaw 的安装指引，可以选择不同的安装方式。对 MacOS/Linux 用户，推荐官方一键安装脚本：

curl -fsSL https://openclaw.ai/install.sh | bash

Windows (PowerShell):

iwr -useb https://openclaw.ai/install.ps1 | iex

或者也可以通过全局安装的方式：

npm install -g openclaw@latest
pnpm add -g openclaw@latest

脚本跑完，会看到如下的 openclaw onboarding 指引，说明安装成功了👇🏻。

完成 OpenClaw 配置

2）开通获取腾讯云混元 API Key

OpenClaw 支持使用 models.providers（或 models.json）来添加自定义模型提供商或与 OpenAI/Anthropic 兼容的代理服务。 腾讯云混元的模型 API 调用支持 OpenAI SDK兼容接口，只需要登录 腾讯云大模型API，准备好： • 开通腾讯云混元 API 服务及付费方式（支持后付费、预付费两种方式）：系统设置 • 腾讯云混元 API key：获取混元 API Key • 模型调用地址 base_url： https://api.hunyuan.cloud.tencent.com/v1 • 模型名称 model code：如 hunyuan-turbos-latest、hunyuan-t1-latest

2.1如何购买腾讯云混元 API 服务预付费资源包？ 查看预付费说明，了解资源包规格，点击购买页，可进行腾讯云混元API服务预付费资源包购买。

2.2如何开通腾讯云混元 API 服务及后付费？ 登录 腾讯云大模型API，点击系统设置页面，开通后付费、腾讯混元大模型服务。

2.3如何获取 API key？ 登录 腾讯云大模型API，点击接入管理 页面，单击使用OpenAI SDK方式接入下的创建 API-KEY，创建后复制即可通过API KEY调用大模型。

3）修改 OpenClaw 配置文件

注意：OpenClaw 采用严格的配置校验机制，字段拼写错误或冗余定义均可能导致 Gateway 启动失败；出现异常时，建议优先通过openclaw doctor命令获取诊断信息。

OpenClaw 模型引用是 provider/model 的格式，我们需要按照 OpenClaw 可解析的方式把模型信息放到配置里。可以选择 Web UI 方式，或 CLI 命令方式，进行配置。

Web UI 方式

openclaw dashboard

CLI 命令方式 将下面命令中的${HY_API_KEY}替换为获取到的 API key后执行。

openclaw config set 'models.providers.hunyuan' --json '{
  "baseUrl": "https://api.hunyuan.cloud.tencent.com/v1",
  "apiKey": "${HY_API_KEY}",
  "api": "openai-completions",
  "models": [
    { "id": "hunyuan-turbos-latest", "name": "hunyuan Turbos" },
    { "id": "hunyuan-t1-latest", "name": "hunyuan T1" },
  ]
}'
openclaw config set models.mode merge
openclaw models set hunyuan/hunyuan-turbos-latest

4）配置生效 + 验证模型状态

在终端运行以下指令，保证配置能够生效：

# 方式一：停止服务后，再启动服务
openclaw gateway stop
# 等待 2-3 秒后启动服务
openclaw gateway start
# 方式二：直接使用重启命令
openclaw gateway restart

还可以通过以下指令看刚刚设置的模型是否被 OpenClaw 识别：

openclaw models list

还可以通过以下指令进行一次真实连通探测（会发真实请求，可能产生费用~）

openclaw models status --probe

💬 简单对话场景验证模型调用

如果想在连通 discord、telegram 等聊天软件工具之前，先简单验证模型的调用返回，可以直接唤起 WebUI 界面开始聊天👇🏻

openclaw dashboard

或通过以下指令在 CLI 跑一轮 agent 👇🏻

openclaw agent --agent main --message "介绍下腾讯云混元"

验证skills调用👇🏻

🌐 接入腾讯云deepseek大模型

以腾讯云 deepseek为例，腾讯云提供的DeepSeek模型服务，依托腾讯云基础设施，提供稳定可靠的API访问。

获取APIkey：获取腾讯云deepseek API Key 将下面命令中的${DS_API_KEY}替换为获取到的 API key后执行。

openclaw config set 'models.providers.qcloudlkeap' --json '{
  "baseUrl": "https://api.lkeap.cloud.tencent.com/v1",
  "apiKey": "${DS_API_KEY}",
  "api": "openai-completions",
  "models": [
    { "id": "deepseek-v3.2", "name": "DeepSeek V3.2" },
    { "id": "deepseek-v3.1-terminus", "name": "DeepSeek V3.1 Terminus" },
    { "id": "deepseek-v3-0324", "name": "DeepSeek V3 0324" },
    { "id": "deepseek-r1-0528", "name": "DeepSeek R1 0528" },
  ]
}'
openclaw config set models.mode merge

设置默认模型（以deepseek-v3.2为例），并重启网关

openclaw models set qcloudlkeap/deepseek-v3.2
openclaw gateway restart

即可愉快的使用deepseek模型👇🏻