🦞 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) 配置

Moltbot 配置项 参考配置
I understand this is powerful and inherently risky. Continue? 选择 "Yes"
Onboarding mode 选择 "QuickStart"
Model/auth provider 选择 "Skip for now",后续可以配置
Filter models by provider 选择 "All providers"
Default model 使用默认配置
Select channel (QuickStart) 选择 "Skip for now",后续可以配置
Configure skills now? (recommended) 选择 "No",后续可以配置

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×腾讯云大模型接入交流群:

请在此添加图片描述

文章来源于腾讯云开发者社区,点击查看原文