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

🦞 Moltbot 是什么

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

使用场景举例：

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

💻 安装 Moltbot 与配置混元 API

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

1）安装与配置 Moltbot

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

node -v

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

curl -fsSL https://molt.bot/install.sh | bash

Windows (PowerShell):

iwr -useb https://molt.bot/install.ps1 | iex

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

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

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

完成 Moltbot (Clawdbot) 配置

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

Moltbot 支持使用 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-2.0-thinking-20251109、hunyuan-2.0-instruct-20251111

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

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

3）修改 Moltbot 配置文件

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

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

Web UI 方式

# 2026.01.27 之前安装的是 clawdbot
clawdbot dashboard
# 2026.01.27 之后安装的是 moltbot
moltbot dashboard

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

clawdbot 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" },
  ]
}'
clawdbot config set models.mode merge
clawdbot models set hunyuan/hunyuan-turbos-latest

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

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

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

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

clawdbot models list

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

clawdbot models status --probe

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

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

# 2026.01.27 之前，安装的是 clawdbot，使用以下命令
clawdbot dashboard
# 2026.01.27 之后，安装的是 moltbot，使用以下命令
moltbot dashboard

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

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

验证skills调用👇🏻

🌐 接入腾讯云deepseek大模型

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

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

clawdbot 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" },
  ]
}'
clawdbot config set models.mode merge

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

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

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

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