🦞 如何在 Moltbot (原 Clawdbot）轻松配置阿里云百炼 API 享Coding Plan 特惠套餐

💥阿里云百炼 Coding Plan 套餐已支持 Moltbot/Clawdbot 接入。支持抵扣通义千问万亿参数思考大模型 Qwen3-Max-Thinking（模型名qwen3-max-2026-01-23），新客首月每天仅需0.3元。👉🏻订阅地址

🦞 Clawdbot 是什么

Moltbot（原 Clawdbot） 是一款开源的 AI 个人助手，支持本地部署，兼容 MacOS、Windows 及 Linux 等多种系统，支持接入常用聊天工具，让用户能够通过自然语言来控制各种设备和服务。

它是一个功能强大的自动化工具，支持 Qwen、Claude、GPT等主流大语言模型，能够帮助用户处理邮件、日程安排、市场调研等多种自动化任务。

使用场景举例：

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

💻安装与配置阿里云百炼 API

‼️ Clawdbot 于 2026.01.27 正式更名 Moltbot，但部分命令可能尚未完成迁移。

在此时间后使用 https://molt.bot/install.sh 安装的用户，如使用出现报错如 zsh: command not found moltbot，可能需要使用本教程中原 clawdbot 的指令。

1）安装与配置 Moltbot

安装前置条件

确认 Node.js 版本，clawdbot 要求 Node >=22。如果不是 22+，需要先升级 Node （你用 nvm / fnm / brew 都行）

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 指引，说明你安装成功了👇🏻

2）开通获取阿里云百炼 API Key

Moltbot 支持使用 models.providers（或 models.json）来添加自定义模型提供商或与 OpenAI/Anthropic 兼容的代理服务。

阿里云百炼的模型 API 调用支持 OpenAI-compatible 接口，你只需要登录 阿里云百炼大模型服务平台 ：

• 阿里云百炼 API key：获取百炼 API Key
• 模型调用地址 base_url：https://dashscope.aliyuncs.com/compatible-mode/v1
• 模型名称 model code：如 qwen-plus, qwen3-max 等

如何获取 API key？

登录 阿里云百炼大模型服务平台，点击密钥管理页面，单击创建 API-KEY，复制即可通过API KEY调用大模型。

如果你使用的是百炼 Coding Plan：

• 阿里云百炼 API key：获取百炼 Coding Plan 专属 API Key
• 模型调用地址 base_url：https://coding.dashscope.aliyuncs.com/v1
• 模型名称 model code：如 qwen3-max-2026-01-23 等

3）配置 API Key 到环境变量

建议把 API Key 配置到环境变量，避免在代码里显式地配置API Key，降低泄露风险。

1. 在终端中执行以下命令，查看默认Shell类型。

echo $SHELL

2. 根据默认Shell类型，选择 zsh 或者 bash 其一进行操作。

# 用您的阿里云百炼API Key代替YOUR_DASHSCOPE_API_KEY
echo "export DASHSCOPE_API_KEY='YOUR_DASHSCOPE_API_KEY'" >> ~/.zshrc

# 用您的阿里云百炼API Key代替YOUR_DASHSCOPE_API_KEY
echo "export DASHSCOPE_API_KEY='YOUR_DASHSCOPE_API_KEY'" >> ~/.bash_profile

source ~/.zshrc

source ~/.bash_profile

echo $DASHSCOPE_API_KEY

echo $DASHSCOPE_API_KEY

4）修改 Moltbot 配置文件

注：Moltbot 配置是严格校验的，字段写错/多写，Gateway 可能直接跑不起来；如果出问题报错，可以先跑 moltbot doctor （clawdbot doctor） 看报错。

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

Web UI 方式

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

手动编辑

或者手动编辑配置信息到~/.moltbot/moltbot.json （~/.clawdbot/clawdbot.json）里。这里以阿里云百炼于 2026.01.26 刚发布的 qwen3-max-2026-01-23 模型举例，你可以直接复制粘贴这段配置说明👇🏻

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

如果你使用的是百炼 Coding Plan，你需要将 baseUrl 和 apiKey 替换成 Coding Plan 专属内容：

• baseUrl：https://coding.dashscope.aliyuncs.com/compatible-mode/v1
• apiKey：sk-sp-xxxxxxxxxxx

如果你是用 nano 来编辑，可以执行以下命令打开配置文件，然后将内容粘贴进去。

# 2026.01.27 之前，安装的是 clawdbot，使用以下命令
nano ~/.clawdbot/clawdbot.json
# 2026.01.27 之后，安装的是 moltbot，使用以下命令
nano ~/.moltbot/moltbot.json

粘贴完配置内容后，在 nano 编辑器中，按 Ctrl + X，接着按Y，再按 Enter 以保存并关闭文件。

当然，如果你使用的场景较为简单，不涉及到复杂的 agent 工具调用，也可以使用阿里云百炼提供的 qwen-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",
    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）配置生效 + 验证模型状态

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

# 方式一：停止服务后，再启动服务
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 "介绍下阿里云百炼"

🌱 阿里云百炼模型推荐

阿里云百炼提供北京、新加坡和弗吉尼亚地域的模型服务，各地域的API Key不同，选择邻近地域调用可降低网络延迟，详情请参见选择地域和部署模式。新用户开通百炼 90 天内，即可享受模型各 100万 Token 模型。

通义千问 Max、通义千问 Plus 和通义千问 Flash 均已升级至Qwen3系列，并兼容OpenAI调用方式，适用于智能客服、文本创作、内容润色以及摘要总结等多种场景。