在 Moltbot (Clawdbot) 里配置调用阿里云百炼 API 完整教程

Moltbot（原Clawdbot）是一款开源AI个人助手，支持通过自然语言控制设备、处理自动化任务，兼容Qwen、Claude、GPT等主流大语言模型。若需在Moltbot中调用阿里云百炼提供的模型能力（如通义千问3系列），需完成API配置、环境变量设置、配置文件编辑等步骤。本文将严格遵循原教程逻辑，用通俗易懂的语言拆解完整流程，涵盖前置条件、安装部署、API获取、配置验证等核心环节，确保不改变原意且无营销表述。

一、核心概念与适用场景

在开始配置前，先明确关键概念与适用范围，帮助理解操作意义：

• Moltbot（Clawdbot）：开源AI助手，可本地部署，支持处理邮件、日程安排、市场调研等自动化任务，能连接各类API与服务，也可作为个人知识库使用；
• 阿里云百炼：一站式大模型开发与应用构建平台，提供通义千问全系列及第三方模型，支持低代码构建、模型微调、企业级部署，其API支持OpenAI-compatible接口，可与Moltbot无缝对接；
• 适用场景：需在Moltbot中调用阿里云百炼模型的用户，包括24小时在线AI助手部署、日常任务自动化、自定义自动化流程搭建、个人知识库构建等。

PS：怕麻烦的同学参考阿里云专属部署入口（开箱即用）

阿里云不提供独立的“Clawdbot/Moltbot官网”，其服务整合在轻量应用服务器、无影云电脑与计算巢等产品中，核心入口如下：

1. 轻量应用服务器部署入口：https://www.aliyun.com/product/swas（搜索“Moltbot”镜像，新人可享限时优惠，预装环境一键启动）
2. 无影云电脑专属入口：https://www.aliyun.com/product/ecs/gws（购买Moltbot专属镜像套餐，含2000核时，支持钉钉/QQ通道快速配置）
3. 计算巢部署入口：https://computenest.console.aliyun.com（搜索“Clawdbot社区版”，按指引填写参数完成部署，适合企业级批量管理）
4. 阿里云百炼集成入口：https://bailian.console.aliyun.com（创建API-Key，用于Moltbot调用大模型，新用户享免费tokens额度）

二、前置条件与环境准备

配置前需完成基础环境检查与准备，确保后续步骤顺利推进：

2.1 检查Node.js版本

Moltbot要求Node.js版本≥22，需先验证本地版本：

1. 打开终端（MacOS/Linux）或PowerShell（Windows），输入命令 node -v；
2. 若版本低于22，需通过nvm、fnm或brew升级（以nvm为例，输入 nvm install 22 安装最新22.x版本，再用 nvm use 22 切换）。

2.2 安装Moltbot（Clawdbot）

根据操作系统选择对应安装方式，推荐使用官方一键安装脚本，步骤如下：

（1）MacOS/Linux系统

1. 打开终端，输入一键安装命令：curl -fsSL https://clawd.bot/install.sh | bash；
2. 脚本执行完成后，会进入Clawdbot onboarding指引流程，提示阅读安全说明（告知Agent可执行命令、读写文件，建议新用户从沙箱模式开始）；
3. 输入“Yes”确认后，进入QuickStart模式，Gateway端口默认18789，模型提供方选择“Skip for now”（后续手动配置阿里云百炼）。

（2）Windows系统

1. 打开PowerShell，输入命令：iwr -useb https://clawd.bot/install.ps1 | iex；
2. 后续流程与MacOS/Linux一致，完成安全说明确认与QuickStart配置。

（3）备选安装方式（全局安装）

若一键脚本安装失败，可通过包管理器全局安装：

• npm方式：npm install -g clawdbot@latest；
• pnpm方式：pnpm add -g clawdbot@latest。

安装成功后，终端会显示版本信息（如“Clawdbot 2026.1.24-3 (885167d)”），并提示安装完成。

三、获取阿里云百炼API关键信息

Moltbot调用百炼模型需准备三项核心信息：API Key、模型调用地址（base_url）、模型名称（model code），获取步骤如下：

3.1 登录阿里云百炼平台

访问阿里云百炼大模型服务平台，使用阿里云账号登录（无账号需先注册并完成实名认证）。

3.2 创建并获取API Key

1. 登录后，在平台导航栏找到“密钥管理”（支持北京、新加坡等地域，不同地域API Key独立，建议选择邻近地域降低延迟）；
2. 点击“创建API-KEY”，系统会生成API Key与Secret Key，点击“复制”保存API Key（Secret Key无需用于本次配置，仅用于密钥重置，需妥善保管）；
3. 注意：API Key为模型调用的核心凭证，避免泄露给他人，若怀疑泄露需立即在平台禁用或删除旧密钥，重新创建。

3.3 确认模型信息

需记录百炼模型的base_url与model code：

• 通用base_url：https://dashscope.aliyuncs.com/compatible-mode/v1（OpenAI兼容接口地址）；
• 推荐模型及model code：
  • 通义千问3-Max-Thinking版：qwen3-max-2026-01-23（旗舰推理模型，支持复杂任务与工具调用）；
  • 通义千问3-Plus版：qwen-plus（效果、速度、成本均衡，适配多数场景）。

四、配置环境变量（避免API Key泄露）

为降低API Key泄露风险，建议将其配置到系统环境变量中，而非直接写入代码，步骤如下：

4.1 确认默认Shell类型

1. 终端（或PowerShell）输入命令 echo $SHELL；
2. 根据输出结果判断Shell类型（常见为zsh或bash）。

4.2 配置环境变量（zsh用户）

1. 输入命令（将“YOUR_DASHSCOPE_API_KEY”替换为实际获取的百炼API Key）：
   echo "export DASHSCOPE_API_KEY='YOUR_DASHSCOPE_API_KEY'" >> ~/.zshrc；
2. 执行命令使配置生效：source ~/.zshrc；
3. 重新打开终端，输入 echo $DASHSCOPE_API_KEY，若输出API Key则配置成功。

4.3 配置环境变量（bash用户）

1. 输入命令（替换实际API Key）：
   echo "export DASHSCOPE_API_KEY='YOUR_DASHSCOPE_API_KEY'" >> ~/.bash_profile；
2. 执行生效命令：source ~/.bash_profile；
3. 重新打开终端，输入 echo $DASHSCOPE_API_KEY 验证，输出API Key即为成功。

五、编辑Moltbot配置文件

Moltbot的模型配置需按指定格式写入配置文件（~/.clawdbot/clawdbot.json），字段严格校验，写错或多写可能导致Gateway无法启动。以下提供两种模型的配置模板，可根据需求选择：

5.1 配置通义千问3-Max-Thinking版（qwen3-max-2026-01-23）

该模型为百炼旗舰推理模型，适用于复杂、多步骤任务，支持工具调用，配置步骤如下：

1. 终端输入命令打开配置文件：nano ~/.clawdbot/clawdbot.json；
2. 将以下配置内容粘贴到文件中（确保格式正确，无多余空格或标点）：

   {
        
   "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
          }
        ]
      }
    }
   }
   }
   

3. 保存并退出：按 Ctrl + X，输入 Y 确认保存，再按 Enter 关闭nano编辑器。

5.2 配置通义千问3-Plus版（qwen-plus）

该模型平衡效果、速度与成本，支持思考模式与非思考模式切换，适用于多数简单场景，配置步骤如下：

1. 终端输入 nano ~/.clawdbot/clawdbot.json 打开文件；
2. 粘贴以下配置内容：

   {
        
   "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",
        "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
          }
        ]
      }
    }
   }
   }
   

3. 按 Ctrl + X → Y → Enter 保存退出。

5.3 配置文件注意事项

• 字段严格区分大小写，不可多写或漏写逗号、引号，否则Gateway可能启动失败；
• 若配置后报错，可先执行 clawdbot doctor 命令查看具体错误信息，针对性修正；
• apiKey 字段使用 ${DASHSCOPE_API_KEY} 引用环境变量，无需手动替换为实际API Key。

六、配置生效与模型状态验证

完成配置文件编辑后，需重启Gateway使配置生效，并验证模型是否被Moltbot识别：

6.1 重启Moltbot Gateway

终端输入命令：clawdbot gateway restart，执行后终端会显示“Restarted LaunchAgent”提示，说明Gateway重启成功。

6.2 查看模型列表（验证识别状态）

输入命令 clawdbot models list，若配置正确，终端会输出已识别的模型信息，示例如下：

Clawdbot 2026.1.24-3 (885167d) - No $999 stand required.
Model                          Input  Ctx    Local Auth  Tags
bailian/qwen3-max-2026-01-23   text   256k   no          default, configured, alias:通义千问 Max Thinking 版

输出结果中包含模型ID、输入类型、上下文窗口大小、标签等信息，说明模型已被成功识别。

6.3 模型连通探测（真实请求验证）

若需确认模型能否正常调用（会产生真实费用），输入命令：clawdbot models status --probe，执行后终端会显示探测结果，示例如下：

Clawdbot 2026.1.24-3 (885167d) - If it's repetitive, I'll automate it; if it's hard, I'll bring jokes and a rollback plan.
Agent dir Default Config Fallbacks (0): - :bailian/qwen3-max-2026-01-23 : ~/.clawdbot/clawdbot.json : ~/.clawdbot/agents/main/agent
Image model :
Image fallbacks (0): - 
Aliases (1):通义千问 Max Thinking版 ->bailian/qwen3-max-2026-01-23
Configured models(1):bailian/qwen3-max-2026-01-23
Auth overview Auth store Shell env : ~/.clawdbot/agents/main/agent/auth-profiles.json :off
Providers w/ OAuth/tokens (0): bailian effective=models.json:sk-6eda6...b6blcbd6 | models.json=sk-6eda6...b6b1cbd6 | source=models.json: ~/.clawdbot/agents/main/agent/models.json
OAuth/token status: none
Auth probes
| Model                          | Profile               | Status       |
| ---                            | ---                   | ---          |
| bailian/qwen3-max-2026-01-23   | models.json (api_key) | ok·9.4s      |
Probed 1 target in 9.4s

若“Status”显示“ok”，说明模型调用正常；若失败，需检查API Key有效性、环境变量配置或网络连接。

七、简单对话场景验证

若需快速验证模型响应效果，可通过终端发送测试消息，步骤如下：

1. 终端输入命令（替换消息内容为自定义测试文本）：clawdbot agent --agent main --message "介绍下阿里云百炼"；
2. 执行后，Moltbot会调用配置的百炼模型生成回复，示例回复如下（无网络搜索功能时基于已有知识输出）：
   ```
   Clawdbot 2026.1.24-3 (885167d) - Because Siri wasn't answering at 3AM.
   Gateway agent failed; falling back to embedded: Error: gateway closed (108 abnormal closure (no close frame)): no close reason
   Gateway target: ws://127.0.0.1:18789
   Source: local loopback
   Config: /Users/maddok/.clawdbot/clawdbot.json
   Bind: loopback

我目前无法通过网络搜索获取最新信息(缺少Brave API 密钥),但我可以基于已有知识为你介绍阿里云百炼(Bailian)。

什么是阿里云百炼(Bailian)？

阿里云百炼是阿里云推出的一站式大模型开发及应用构建平台，旨在让开发者和企业能够快速、低成本地创建和部署基于大模型的AI应用，无需从零开始训练模型。

"百炼"取自"千锤百炼"，寓意通过平台对大模型进行高效调优与应用打磨。

核心功能与特点：

1. 开箱即用的大模型服务

• 集成 通义千问(Qwen) 全系列模型 (Qwen-Max、Qwen-Plus、Qwen-Turbo、Qwen-Audio、Qwen-VL等)；
• 支持第三方模型(如Llama、ChatGLM等，部分需自行部署)；
• 提供统一API接口，轻松切换模型。

2. 低代码/无代码应用构建

• 可视化Prompt工程：调试、优化、版本管理；
• 工作流编排：拖拽式组合"模型+工具+数据"(类似LangChain但更图形化)；
• 内置RAG(检索增强生成)、Agent框架、多轮对话管理。

3. 模型微调(Finetuning)

• 支持 全参数微调 和高效微调(如LoRA、QLoRA)；
• 自动化数据处理、训练、评测流程。

4. 企业级安全与部署

• 一键部署为 API服务 或 Serverless函数；
• 提供数据加密、权限管理等企业级安全能力。

5. 深度集成阿里云生态

• 无缝对接OSS(对象存储)、MaxCompute(大数据)、PAI(机器学习平台)；
• 可与钉钉、淘宝、高德等业务场景结合。

典型应用场景：

• 智能客服机器人；
• 企业知识库问答(RAG)；
• 行业Agent(如医疗、法律、金融助手)；
• 文本创作、内容润色、摘要总结。

与Clawdbot的关系？

你当前使用的模型 'bailian/qwen3-max-2026-01-23' 正是通过阿里云百炼平台提供的。也就是说——Clawdbot的"大脑"就运行在百炼平台上。
你可以把 百炼 看作"模型工厂"，而Clawdbot是"智能工人"——它调用百炼提供的模型能力，在你的本地执行具体任务。

想试试用百炼的能力做点什么吗？比如：

"用Qwen3-Max分析我上周的会议录音(如果有)"
"构建一个自动总结GitHub Issues的Agent"
随时告诉我！
```
回复内容会因模型版本、消息内容不同有所差异，只要能正常输出完整回复，即说明模型调用验证通过。

八、阿里云百炼模型推荐与补充说明

8.1 推荐模型详情

阿里云百炼提供北京、新加坡、弗吉尼亚等地域的模型服务，各地域API Key独立，选择邻近地域可降低网络延迟。新用户开通百炼90天内，可享受各模型100万Token免费额度，推荐两款兼容Moltbot的核心模型：

（1）qwen3-max-2026-01-23（通义千问3-Max-Thinking版）

• 模型特点：旗舰推理模型，参数规模大，经大量强化学习训练，在事实知识、复杂推理、指令遵循、人类偏好对齐、智能体能力等维度表现突出，19项权威基准测试中媲美顶尖模型，支持内置工具调用；
• 选型建议：适合处理复杂、多步骤任务，需高精度结果的场景；
• 价格信息（每百万Token）：
  • 0<Token≤32K：输入2.5元，输出10元；
  • 32K<Token≤128K：输入4元，输出16元；
  • 128K<Token≤252K：输入7元，输出28元；
  • 备注：Batch调用半价，上下文缓存享有折扣。

（2）qwen-plus（通义千问3-Plus版）

• 模型特点：平衡效果、速度与成本，实现思考模式与非思考模式融合，推理能力超Qwen2.5-Plus，达到同规模业界SOTA水平；
• 选型建议：多数常规场景的首选，适用于文本创作、内容润色、摘要总结等；
• 价格信息（每百万Token）：
  • 0<Token≤128K：非思考模式输入0.8元/输出2元，思考模式输入0.8元/输出8元；
  • 128K<Token≤256K：非思考模式输入2.4元/输出20元，思考模式输入2.4元/输出24元；
  • 256K<Token<1M：非思考模式输入4.8元/输出48元，思考模式输入4.8元/输出64元。

8.2 关键补充说明

• 模型调用需确保百炼账号有可用额度，免费额度耗尽后需充值才能继续使用；
• 若需切换模型，只需修改配置文件中的“model.primary”与“models”字段，重启Gateway即可；
• 若遇到配置文件格式错误，可使用在线JSON校验工具（如JSONLint）检查语法；
• 网络不稳定时，可尝试切换百炼地域节点，或检查防火墙是否放行1878端口（Gateway默认端口）。

九、常见问题排查

9.1 Gateway启动失败

• 原因：配置文件字段错误（如缺少逗号、引号不匹配）；
• 解决方案：执行 clawdbot doctor 查看报错信息，修正配置文件格式，确保JSON语法正确。

9.2 模型未被识别（clawdbot models list无结果）

• 原因：配置文件路径错误，或模型配置字段缺失；
• 解决方案：确认配置文件路径为 ~/.clawdbot/clawdbot.json，重新检查并粘贴配置内容，重启Gateway。

9.3 模型探测失败（Status显示error）

• 原因1：API Key无效或泄露，被禁用；
• 解决方案：登录百炼平台“密钥管理”，确认API Key状态为“正常”，若异常则重新创建；
• 原因2：环境变量未生效；
• 解决方案：重新执行 source ~/.zshrc（zsh用户）或 source ~/.bash_profile（bash用户），验证 echo $DASHSCOPE_API_KEY 能否输出API Key；
• 原因3：网络问题，地域节点不可用；
• 解决方案：切换百炼地域节点，重新创建对应地域的API Key并更新配置。

9.4 对话验证无响应

• 原因：Gateway未正常启动，或模型额度耗尽；
• 解决方案：执行 clawdbot gateway restart 重启Gateway，登录百炼平台“费用中心”查看剩余额度。

总结

Moltbot配置阿里云百炼API的核心逻辑是“环境准备→Moltbot安装→API获取→环境变量配置→配置文件编辑→验证生效”，关键在于确保Node.js版本达标、配置文件格式正确、API Key有效。通过本文步骤，可成功在Moltbot中调用通义千问3系列等百炼模型，实现自动化任务处理、个人知识库搭建等需求。若需进一步扩展功能（如对接Discord、Telegram等聊天工具），可参考Moltbot官方文档或阿里云百炼API参考手册。