在OpenClaw（Clawdbot）配置阿里云百炼API图文教程，看这一篇文章就够了

在OpenClaw（Clawdbot）配置阿里云百炼API图文教程，看这一篇文章就够了，在Moltbot种配置百炼API，API Key 到环境变量，依旧修改OpenClaw等配置操作：

🦞 Moltbot 是什么

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

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

使用场景举例：

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

🦞 阿里云百炼是什么？

百炼是阿里云企业级模型服务和应用开发平台，阿里云百炼API支持接入Moltbot（原Clawdbot），轻松实现调用数百款千问系列大模型。

阿里云百炼官方页面：https://www.aliyun.com/product/bailian  如下图：

💻 安装 Moltbot 与配置百炼 API

Clawdbot 于 2026.01.27 正式更名 Moltbot，现在又改名叫OpenClaw

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

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

完成 Moltbot (Clawdbot) 配置

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调用大模型。

3）配置 API Key 到环境变量

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

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

echo $SHELL

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

zsh

1. 执行以下命令来将环境变量设置追加到 ~/.zshrc 文件中。

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

2. 执行以下命令，使变更生效。

source ~/.zshrc

3. 重新打开一个终端窗口，运行以下命令检查环境变量是否生效。

echo $DASHSCOPE_API_KEY

bash

1. 执行以下命令来将环境变量设置追加到 ~/.bash_profile 文件中。

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

2. 执行以下命令，使变更生效。

source ~/.bash_profile

3. 重新打开一个终端窗口，运行以下命令检查环境变量是否生效。

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

如果你是用 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调用方式，适用于智能客服、文本创作、内容润色以及摘要总结等多种场景。