OpenClaw（Clawdbot）镜像一键部署+如何配置阿里云百炼API全流程指南

OpenClaw（曾用名Clawdbot、Moltbot）是一款开源AI个人助手，支持本地部署于MacOS、Windows及Linux系统，可通过自然语言控制设备与服务，实现邮件处理、日程安排、市场调研等自动化任务，且兼容Qwen、Claude、GPT等主流大语言模型。阿里云百炼作为企业级模型服务与应用开发平台，其API可接入OpenClaw，助力调用通义千问系列大模型。本文详细拆解OpenClaw安装、百炼API Key获取、配置及模型验证全流程，全程无营销词汇，确保操作贴合技术逻辑与实际需求。

一、基础概念与前置条件

1.1 核心工具说明

• OpenClaw：开源AI助理，前身为Clawdbot，2026年1月27日后部分安装脚本更名Moltbot，核心功能为自动化任务执行与多模型兼容，支持通过配置对接第三方模型服务；
• 阿里云百炼：提供企业级大模型服务，支持OpenAI-compatible接口，可接入OpenClaw实现通义千问系列模型（如qwen3-max、qwen-plus）调用，具备模型管理、密钥管控等能力。

1.2 前置环境要求

• Node.js版本：OpenClaw（含旧版Clawdbot）要求Node.js ≥22，需提前通过nvm、fnm或brew等工具完成版本升级，执行node -v可验证版本；
• 终端工具：MacOS/Linux使用自带终端，Windows使用PowerShell，确保终端可正常执行Shell命令；
• 网络环境：需稳定访问互联网，用于下载安装脚本、获取API Key及后续模型调用。

阿里云三步快速部署 OpenClaw 教程

第一步：前往阿里云OpenClaw一键部署专题页面：https://www.aliyun.com/activity/ecs/clawdbot，找到并点击【一键购买并部署】

第二步：购买阿里云轻量应用服务器，配置参考如下：

• 镜像：OpenClaw(Moltbot)镜像（已经购买服务器的用户可以重置系统重新选择镜像）
• 实例：内存必须2GiB及以上。
• 地域：默认美国（弗吉尼亚），目前中国内地域（除香港）的轻量应用服务器，联网搜索功能受限。
• 时长：根据自己的需求及预算选择。
  

第三步：访问阿里云百炼大模型控制台，找到密钥管理，单击创建API-Key。

前往轻量应用服务器控制台，找到安装好OpenClaw的实例，进入「应用详情」放行18789端口、配置百炼API-Key、执行命令，生成访问OpenClaw的Token。

• 端口放通：需要放通对应端口的防火墙，单击一键放通即可。
• 配置百炼API-Key，单击一键配置，输入百炼的API-Key。单击执行命令，写入API-Key。
• 配置OpenClaw：单击执行命令，生成访问OpenClaw的Token。
• 访问控制页面：单击打开网站页面可进入OpenClaw对话页面。

二、OpenClaw（Moltbot）安装步骤

2.1 一键安装（推荐）

2.1.1 MacOS/Linux系统

打开终端，执行官方一键安装脚本：

curl -fsSL https://molt.bot/install.sh | bash

脚本执行过程中，会自动下载依赖、配置环境变量，并完成OpenClaw主程序安装。

2.1.2 Windows系统（PowerShell）

以管理员身份打开PowerShell，执行以下命令：

iwr -useb https://molt.bot/install.ps1 | iex

若出现脚本执行权限提示，需先执行Set-ExecutionPolicy RemoteSigned（按提示输入Y确认），再重新运行安装命令。

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

若一键安装失败，可通过包管理工具全局安装：

# npm方式
npm install -g moltbot@latest

# pnpm方式（需先安装pnpm）
pnpm add -g moltbot@latest

安装完成后，终端会显示clawdbot onboarding指引，表明安装成功。

2.3 安装向导配置

安装脚本执行完毕后，进入交互配置环节，按以下建议选择参数：

三、阿里云百炼API Key获取

3.1 登录百炼平台

访问阿里云百炼大模型服务平台，使用阿里云账号登录（需完成个人或企业实名认证，未认证账号无法创建API Key）。

3.2 创建API Key

1. 进入平台后，在左侧导航栏找到“密钥管理”（默认地域为华北2（北京）或新加坡，无需额外修改）；
2. 点击“创建API-Key”，系统自动生成一组API Key（含Access Key ID与Access Key Secret）；
3. 点击“复制”按钮，将两组密钥保存至本地文档（如记事本），切勿泄露，避免第三方冒用导致模型调用费用异常。

3.3 核心参数记录

除API Key外，需同步记录以下百炼模型调用关键参数：

• base_url：https://dashscope.aliyuncs.com/compatible-mode/v1（OpenAI兼容接口地址）；
• 模型code：如qwen3-max-2026-01-23（通义千问3 Max Thinking版）、qwen-plus（通义千问Plus版），可在百炼“模型广场”查询具体模型code。

四、API Key配置（环境变量与配置文件）

4.1 配置环境变量（推荐）

将API Key配置到环境变量，避免在配置文件中显式写入，降低泄露风险，操作步骤如下：

4.1.1 查看Shell类型

执行以下命令，确认当前终端默认Shell：

echo $SHELL

根据输出结果（如/bin/zsh或/bin/bash），选择对应配置方式。

4.1.2 zsh配置（常见于MacOS）

1. 执行命令，将环境变量追加至~/.zshrc文件：

   echo "export DASHSCOPE_API_KEY='YOUR_DASHSCOPE_API_KEY'" >> ~/.zshrc
   

   （将YOUR_DASHSCOPE_API_KEY替换为实际获取的百炼API Key）；
2. 使配置生效：

   source ~/.zshrc
   

3. 验证配置：重新打开终端，执行echo $DASHSCOPE_API_KEY，若输出API Key则配置成功。

4.1.3 bash配置（常见于Linux/Windows WSL）

1. 执行命令，将环境变量追加至~/.bash_profile文件：

   echo "export DASHSCOPE_API_KEY='YOUR_DASHSCOPE_API_KEY'" >> ~/.bash_profile
   

2. 使配置生效：

   source ~/.bash_profile
   

3. 验证配置：执行echo $DASHSCOPE_API_KEY，确认输出正确。

4.2 修改OpenClaw配置文件

OpenClaw配置文件需按固定格式写入百炼模型信息，支持Web UI或手动编辑两种方式，配置前需注意：字段需严格匹配格式，写错或多写可能导致Gateway服务启动失败，若出现报错可先执行moltbot doctor（或clawdbot doctor）查看具体错误信息。

4.2.1 Web UI方式（可视化配置）

1. 终端执行命令，打开OpenClaw配置面板：
   • 2026年1月27日前安装（Clawdbot）：clawdbot dashboard；
   • 2026年1月27日后安装（Moltbot）：moltbot dashboard；
2. 在配置面板左侧导航栏找到“Models”，点击“Add Entry”，选择“Bailian”作为模型提供商；
3. 填写参数：
   • baseUrl：输入https://dashscope.aliyuncs.com/compatible-mode/v1；
   • apiKey：选择“环境变量”，输入${DASHSCOPE_API_KEY}；
   • models：添加目标模型（如qwen3-max-2026-01-23），填写模型名称、contextWindow（上下文窗口）等信息；
4. 点击“Save”保存配置。

4.2.2 手动编辑配置文件

1. 终端执行命令，打开配置文件：
   • Clawdbot：nano ~/.clawdbot/clawdbot.json；
   • Moltbot：nano ~/.moltbot/moltbot.json；
2. 复制以下配置片段（以qwen3-max-2026-01-23为例），粘贴至配置文件中（替换原有agents与models字段）：

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

   若使用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
             }
           ]
         }
       }
     }
   }
   

3. 保存配置：在nano编辑器中，按Ctrl + X，输入Y确认，再按Enter关闭文件。

五、配置生效与模型验证

5.1 重启OpenClaw服务

执行以下命令，重启Gateway服务使配置生效：

# Clawdbot
clawdbot gateway restart

# Moltbot
moltbot gateway restart

服务重启耗时约2-3秒，终端显示“Gateway online”即表示启动成功。

5.2 模型识别验证

执行命令查看OpenClaw是否成功识别百炼模型：

# Clawdbot
clawdbot models list

# Moltbot
moltbot models list

若输出中包含bailian/qwen3-max-2026-01-23（或bailian/qwen-plus）及对应别名、上下文窗口等信息，说明模型已被识别。

5.3 连通性探测（真实请求）

执行以下命令，发送真实请求验证模型调用是否正常（会产生少量模型调用费用）：

# Clawdbot
clawdbot models status --probe

# Moltbot
moltbot models status --probe

若输出“Status: ok”及响应耗时（如“9.4s”），表明API配置正确且模型可正常调用；若提示错误，需检查API Key有效性、base_url是否正确，或百炼账号是否有可用调用额度。

5.4 对话场景验证

5.4.1 Web UI验证

执行命令打开OpenClaw对话面板：

# Clawdbot
clawdbot dashboard

# Moltbot
moltbot dashboard

在对话框中输入指令（如“介绍qwen-plus模型的应用场景”），若模型返回结构化回答，说明配置完全生效。

5.4.2 终端验证

通过终端执行Agent命令，验证模型响应：

# Clawdbot
clawdbot agent --agent main --message "介绍阿里云百炼"

# Moltbot
moltbot agent --agent main --message "介绍阿里云百炼"

若终端输出阿里云百炼的功能介绍（如模型集成、应用构建等），则模型调用流程正常。

六、常见问题与解决方案

6.1 安装失败（zsh: command not found）

• 原因：2026年1月27日后安装脚本更名，旧版clawdbot命令失效；
• 解决方案：将命令中的clawdbot替换为moltbot（如moltbot dashboard），或重新执行最新安装脚本。

6.2 Gateway启动失败

• 原因：配置文件字段错误、Node.js版本过低；
• 解决方案：
  1. 执行moltbot doctor查看错误日志，修正配置文件格式；
  2. 执行node -v验证版本，若低于22，通过nvm升级：

     nvm install 22
     nvm use 22
     

6.3 模型调用无响应

• 原因：API Key泄露或过期、百炼账号无额度、base_url错误；
• 解决方案：
  1. 重新创建百炼API Key，更新环境变量；
  2. 登录百炼平台查看“模型用量”，确认有可用额度；
  3. 核对base_url是否为https://dashscope.aliyuncs.com/compatible-mode/v1。

七、百炼模型选型建议

阿里云百炼提供多版本通义千问模型，适配不同场景需求，选型参考如下：

选型时需结合任务复杂度与成本预算，新用户可享受90天内各模型100万Token免费额度，可先通过免费额度测试不同模型效果。