搞定 OpenClaw 调用阿里云百炼 API：从密钥获取到配置验证全流程

搞定 OpenClaw 调用阿里云百炼 API：从密钥获取到配置验证全流程，*本教程适用于希望在 OpenClaw/Moltbot/Clawdbot 调用阿里云百炼提供的模型 API 的用户，阿里云百炼 Coding Plan 套餐已支持 OpenClaw/Moltbot/Clawdbot 接入。支持抵扣通义千问万亿参数思考大模型 Qwen3-Max-Thinking（模型名qwen3-max-2026-01-23），新客首月每天仅需0.3元。👉🏻订阅地址：https://www.aliyun.com/product/bailian

🦞 Moltbot 是什么

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

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

使用场景举例：

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

💻 安装 OpenClaw 与配置百炼 API

2026.01.29 又更名为 OpenClaw。

Clawdbot 于 2026.01.27 正式更名 Moltbot。

在此时间后安装的用户，如使用出现报错如 zsh: command not found，可能需要将本教程中原 clawdbot/moltbot 的指令部分替换成 openclaw 使用。
如项目有其他更名或变更，请按照官方项目文档操作，后续本文档不再对应更新

1）安装与配置 OpenClaw

安装前置条件

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

node -v

一键安装

根据 Moltbot 的安装指引，可以选择不同的安装方式。对于 MacOS/Linux 用户，这里比较推荐官方一键安装的脚本：

curl -fsSL https://openclaw.ai/install.sh | bash

Windows (PowerShell):

iwr -useb https://openclaw.ai/install.ps1 | iex

或者你也可以通过全局安装的方式：

npm install -g openclaw@latest

pnpm add -g openclaw@latest

脚本跑完，你会看到如下的 openclaw的 onboarding 指引，说明你安装成功了👇🏻

完成 OpenClaw (Moltbot/Clawdbot) 配置

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

OpenClaw 支持使用 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 和模型调用地址：

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

如何获取 Coding Plan API Key？

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）修改 OpenClaw 配置文件

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

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

Web UI 方式

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

手动编辑

或者手动编辑配置信息到~/.openclaw/openclaw.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: 32768
          }
        ]
      }
    }
  }
}

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