Moltbot（原Clawdbot）是一款开源AI个人助手，支持本地部署，兼容MacOS、Windows、Linux等多种系统，可接入钉钉、飞书、WhatsApp等常用聊天工具，通过自然语言控制设备与服务。它作为功能强大的自动化工具，支持Qwen、Claude、GPT等主流大语言模型，能处理邮件、日程安排、市场调研等自动化任务，也可作为个人知识库随时响应查询，适用于24小时在线AI助手部署、自定义自动化流程搭建等场景。阿里云百炼Coding Plan套餐已支持Moltbot接入，可抵扣通义千问系列大模型，本文将详细拆解Moltbot安装、百炼API配置及套餐适配流程，确保不改变原意且无营销表述。
需注意：Moltbot于2026年1月27日正式更名，部分命令可能尚未完成迁移。若通过https://molt.bot/install.sh安装后出现“zsh: command not found moltbot”等报错，可尝试使用原Clawdbot相关指令。
PS：阿里云上线了轻量应用服务器一键部署 Moltbot 教程，目前最省事部署 Moltbot的方式👇，怕麻烦大的同学可以参考：https://www.aliyun.com/activity/ecs/clawdbot
一、安装与初始化Moltbot
1.1 前置条件：验证Node.js版本
Moltbot要求Node.js版本≥22，需先验证并升级：
- 打开终端（MacOS/Linux）或PowerShell（Windows），输入命令
node -v查看版本； - 若版本低于22，可通过nvm、fnm或brew工具升级，确保版本达标。
1.2 一键安装Moltbot
根据操作系统选择对应安装方式，推荐使用官方一键安装脚本：
- MacOS/Linux系统：终端输入
curl -fsSL https://molt.bot/install.sh | bash； - Windows系统（PowerShell）：输入
iwr -useb https://molt.bot/install.ps1 | iex； - 备选安装方式（全局安装）：若一键脚本失败，可通过npm或pnpm安装，命令分别为
npm install -g moltbot@latest、pnpm add -g moltbot@latest。
1.3 初始化配置（Onboarding）
安装成功后会启动初始化向导，按以下建议配置：
- 安全说明确认：提示“Clawdbot agents can run commands, read/write files...”，输入“Yes”继续；
- Onboarding mode：选择“QuickStart”（快速启动模式）；
- Model/auth provider：选择“Skip for now”（后续手动配置百炼API），若选择“Qwen (OAuth)”，可跳转Qwen Chat登录注册，获取Qwen Coder和Qwen Vision模型免费层级使用权限（每天2000次请求，受速率限制）；
- Filter models by provider：选择“All providers”；
- Default model：保持默认配置；
- Select channel：选择“Skip for now”（后续可配置聊天工具通道）；
- Configure skills now?：选择“No”（后续可按需配置技能）。
二、获取阿里云百炼API关键信息
Moltbot支持通过models.providers（或models.json）添加自定义模型提供商，阿里云百炼API支持OpenAI-compatible接口，需准备API Key、模型调用地址（base_url）、模型名称（model code），具体获取方式如下：
2.1 普通套餐API信息获取
- 登录阿里云百炼大模型服务平台，进入“密钥管理”页面；
- 点击“创建API-KEY”，复制生成的API Key；
- 记录核心参数：base_url为
https://dashscope.aliyuncs.com/compatible-mode/v1，常用model code包括qwen-plus、qwen3-max等。
2.2 Coding Plan套餐API信息获取
若使用阿里云百炼Coding Plan套餐，需获取专属API信息：
- 登录阿里云百炼平台，进入“订阅套餐”页面，找到已购买的Coding Plan套餐（基础套餐40元/月，Pro高级套餐200元/月）；
- 复制套餐专属API Key；
- 记录核心参数：base_url为
https://coding.dashscope.aliyuncs.com/compatible-mode/v1，支持的model code包括qwen3-max-2026-01-23等。
三、配置API Key到环境变量
为降低API Key泄露风险，建议将其配置到系统环境变量，而非直接写入代码：
- 确认默认Shell类型：终端输入
echo $SHELL，判断为zsh或bash； - zsh用户配置：
- 输入命令（替换“YOUR_DASHSCOPE_API_KEY”为实际API Key）：
echo "export DASHSCOPE_API_KEY='YOUR_DASHSCOPE_API_KEY'" >> ~/.zshrc； - 执行
source ~/.zshrc使配置生效； - 重新打开终端，输入
echo $DASHSCOPE_API_KEY，输出API Key即配置成功；
- 输入命令（替换“YOUR_DASHSCOPE_API_KEY”为实际API Key）：
- bash用户配置：
- 输入命令（替换实际API Key）：
echo "export DASHSCOPE_API_KEY='YOUR_DASHSCOPE_API_KEY'" >> ~/.bash_profile； - 执行
source ~/.bash_profile生效； - 重新打开终端，输入
echo $DASHSCOPE_API_KEY验证。
- 输入命令（替换实际API Key）：
四、修改Moltbot配置文件
Moltbot配置文件字段严格校验，写错或多写可能导致Gateway无法启动，若报错可执行 moltbot doctor（或clawdbot doctor）查看错误信息。配置方式分为Web UI和手动编辑两种，可任选其一：
4.1 Web UI配置方式
根据安装时间选择对应命令打开配置界面：
- 2026年1月27日之前安装（原Clawdbot）：输入
clawdbot dashboard； - 2026年1月27日之后安装（Moltbot）：输入
moltbot dashboard； - 进入配置界面后，找到“Models”模块，按提示填写百炼API Key、base_url、模型名称等参数，保存即可。
4.2 手动编辑配置文件
（1）普通套餐配置（以qwen3-max-2026-01-23模型为例）
- 打开配置文件：根据安装时间选择命令，2026年1月27日前安装输入
nano ~/.clawdbot/clawdbot.json，之后安装输入nano ~/.moltbot/moltbot.json； - 粘贴以下配置内容：
{ "agents": { "defaults": { "model": { "primary": "bailian/qwen3-max-2026-01-23" }, "models": { "bailian/qwen3-max-2026-01-23": { "alias": "通义千问 Max Thinking 版" } } } }, "models": { "mode": "merge", "providers": { "bailian": { "baseUrl": "https://dashscope.aliyuncs.com/compatible-mode/v1", "apiKey": "${DASHSCOPE_API_KEY}", "api": "openai-completions", "models": [ { "id": "qwen3-max-2026-01-23", "name": "通义千问 Max Thinking 版", "reasoning": false, "input": ["text"], "cost": { "input": 0.0025, "output": 0.01, "cacheRead": 0, "cacheWrite": 0 }, "contextWindow": 262144, "maxTokens": 65536 } ] } } } } - 保存退出：按
Ctrl + X，输入Y确认，再按Enter关闭编辑器。
（2）Coding Plan套餐配置
需替换baseUrl和apiKey为套餐专属内容，配置文件核心部分如下：
"providers": {
"bailian": {
"baseUrl": "https://coding.dashscope.aliyuncs.com/compatible-mode/v1",
"apiKey": "sk-sp-xxxxxxxxxxx", // 替换为Coding Plan专属API Key
"api": "openai-completions",
"models": [
{
"id": "qwen3-max-2026-01-23",
"name": "通义千问 Max Thinking 版",
"reasoning": false,
"input": ["text"],
"cost": { "input": 0.0025, "output": 0.01, "cacheRead": 0, "cacheWrite": 0 },
"contextWindow": 262144,
"maxTokens": 65536
}
]
}
}
（3）简化场景配置（qwen-plus模型）
若无需复杂工具调用，可选择通义千问Plus模型，配置内容如下：
{
"agents": {
"defaults": {
"model": { "primary": "bailian/qwen-plus" },
"models": {
"bailian/qwen-plus": { "alias": "通义千问 Plus" }
}
}
},
"models": {
"mode": "merge",
"providers": {
"bailian": {
"baseUrl": "https://dashscope.aliyuncs.com/compatible-mode/v1", // Coding Plan替换为专属baseUrl
"apiKey": "${DASHSCOPE_API_KEY}",
"api": "openai-completions",
"models": [
{
"id": "qwen-plus",
"name": "通义千问 Plus",
"reasoning": false,
"input": ["text"],
"cost": { "input": 0.008, "output": 0.008, "cacheRead": 0, "cacheWrite": 0 },
"contextWindow": 1029000,
"maxTokens": 32000
}
]
}
}
}
}
五、配置生效与模型状态验证
5.1 重启Moltbot使配置生效
执行以下命令重启服务，确保配置生效：
- 方式一：先停止再启动，命令为
clawdbot gateway stop（等待2-3秒后）、clawdbot gateway start； - 方式二：直接重启，命令为
clawdbot gateway restart（若已更名适配完成，可替换为moltbot gateway restart）。
5.2 验证模型识别状态
输入命令 clawdbot models list（或moltbot models list），若输出包含“bailian/qwen3-max-2026-01-23”或“bailian/qwen-plus”及对应别名，说明模型已被成功识别。
5.3 模型连通探测（真实请求验证）
输入命令 clawdbot models status --probe（或moltbot models status --probe），执行真实请求验证模型调用是否正常（可能产生费用）。若输出中“Status”显示“ok”，代表配置生效，模型可正常使用。
六、模型调用验证
6.1 WebUI界面验证
通过命令打开WebUI界面直接聊天验证：
- 2026年1月27日前安装：
clawdbot dashboard； - 2026年1月27日后安装：
moltbot dashboard；
打开界面后，在聊天框输入指令（如“介绍下阿里云百炼”），即可测试模型响应效果。
6.2 CLI命令验证
在终端输入命令 clawdbot agent --agent main --message "介绍下阿里云百炼"（或moltbot agent --agent main --message "介绍下阿里云百炼"），Moltbot会调用配置的百炼模型生成回复，验证调用功能是否正常。
七、阿里云百炼模型推荐与套餐说明
7.1 推荐模型详情
阿里云百炼提供北京、新加坡、弗吉尼亚等地域的模型服务，各地域API Key独立，选择邻近地域可降低网络延迟，新用户开通百炼90天内可享受各模型100万Token免费额度，推荐两款核心模型：
- qwen3-max-2026-01-23（通义千问3-Max-Thinking）：最新旗舰推理模型，参数规模大，经大量强化学习训练，在事实知识、复杂推理、指令遵循、人类偏好对齐及智能体能力等维度显著提升，19项权威基准测试中性能媲美顶尖模型，支持调用内置工具，适合复杂、多步骤任务；
- qwen-plus（通义千问3-Plus）：实现思考模式与非思考模式有效融合，可在对话中切换，推理能力与通用能力达到同规模业界SOTA水平，在效果、速度和成本上表现均衡，是多数场景的推荐选择。
7.2 Coding Plan套餐适配说明
- 基础套餐（40元/月）：适合基础开发任务，支持Claude Code等主流编程工具，适配最新代码生成模型qwen3-coder-plus，提供Claude Code 3倍用量；
- Pro高级套餐（200元/月）：适合大型开发任务，用量为基础套餐的5倍，支持相同编程工具与模型，满足复杂项目需求；
- 套餐优势：新客首月日均成本低，可直接抵扣Moltbot调用百炼模型的费用，按实际使用量计费，避免资源浪费。
