OpenClaw（原Clawdbot/Moltbot）部署配置阿里云百炼API完整教程

OpenClaw（曾用名Clawdbot、Moltbot）是一款开源AI个人助手，支持本地部署于MacOS、Windows及Linux系统，可通过自然语言控制各类设备与服务，兼容Qwen、Claude、GPT等主流大语言模型，能自动化处理邮件、日程安排、市场调研等多样化任务。阿里云百炼作为企业级模型服务与应用开发平台，提供数百款通义千问系列大模型，其API可无缝接入OpenClaw，为后者提供强大的智能交互能力。本文将详细拆解从环境准备、API Key获取到配置生效的全流程，涵盖qwen3-max、qwen-plus等Qwen3系列模型的适配，确保用户顺利完成对接。

一、核心概念说明

（一）OpenClaw核心特性

OpenClaw的核心价值在于自动化任务执行与多工具集成，典型使用场景包括：

• 24小时在线响应的AI助手服务；
• 邮件分类、日程管理、定时提醒等日常任务自动化；
• 连接各类API与服务，构建自定义自动化流程；
• 作为个人知识库，实时解答各类疑问。
• 详情 访问阿里云OpenClaw一键部署专题页面 了解。
  详情 访问阿里云OpenClaw一键部署专题页面 了解。
  

（二）阿里云百炼适配优势

阿里云百炼提供统一的API接口，支持OpenAI-compatible调用方式，接入后OpenClaw可直接使用通义千问全系列模型，无需额外适配不同模型的调用协议。其模型服务覆盖北京、新加坡、弗吉尼亚等多个地域，用户可选择邻近地域降低网络延迟。

二、前置准备与环境检查

（一）基础环境要求

OpenClaw运行依赖Node.js环境，版本需≥22，需提前验证或升级：

1. 打开终端（Windows为PowerShell），执行命令node -v；
2. 若版本低于22，可通过nvm、fnm或brew工具升级，确保环境达标。

（二）OpenClaw安装与初始化

1. 选择对应系统的安装方式：
   • 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。

阿里云用户零基础部署OpenClaw步骤喂饭级步骤流程

第一步：访问阿里云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对话页面。

1. 安装完成后启动初始化向导，按以下推荐配置完成基础设置：

三、阿里云百炼API Key获取

1. 登录阿里云百炼大模型服务平台，进入左侧菜单“密钥管理”页面（支持北京、新加坡等地域）；
2. 点击“创建API-KEY”，系统将自动生成API Key，生成后立即复制保存（格式为sk-xxxxxxxxxxxxx），该密钥为模型调用的核心凭证，需妥善保管；
3. 记录关键配置信息：
   • 模型调用地址base_url：https://dashscope.aliyuncs.com/compatible-mode/v1；
   • 模型名称model code：如qwen-plus、qwen3-max-2026-01-23等。

四、API Key环境变量配置

为避免在配置文件中显式存储API Key，降低泄露风险，建议将其配置到系统环境变量中：

1. 首先查看默认Shell类型，执行命令echo $SHELL；
2. 根据Shell类型进行配置：
   • 若为zsh：执行echo "export DASHSCOPE_API_KEY='你的阿里云百炼API Key'" >> ~/.zshrc，然后执行source ~/.zshrc使配置生效；
   • 若为bash：执行echo "export DASHSCOPE_API_KEY='你的阿里云百炼API Key'" >> ~/.bash_profile，然后执行source ~/.bash_profile使配置生效；
3. 验证配置：重新打开终端，执行echo $DASHSCOPE_API_KEY，若能正常输出API Key，说明环境变量配置成功。

五、OpenClaw配置文件修改

OpenClaw的模型配置需按特定格式写入配置文件，支持Web UI或手动编辑两种方式，配置错误可能导致网关无法启动，建议严格遵循以下步骤：

（一）配置方式选择

1. Web UI方式（推荐新手）：

   • 2026.01.27之前安装的版本（原Clawdbot）：执行clawdbot dashboard；
   • 2026.01.27之后安装的版本（Moltbot/OpenClaw）：执行moltbot dashboard；
   • 在打开的控制台中，找到“Models”配置项，点击“+ Add Entry”，填写provider名称“bailian”、baseUrl、apiKey（引用环境变量${DASHSCOPE_API_KEY}）及模型信息。

2. 手动编辑文件方式：

   • 打开配置文件：2026.01.27之前的版本编辑~/.clawdbot/clawdbot.json，之后的版本编辑~/.moltbot/moltbot.json；
   • 若使用nano编辑器，可执行对应命令：nano ~/.clawdbot/clawdbot.json（旧版）或nano ~/.moltbot/moltbot.json（新版）；
   • 粘贴以下配置内容（根据需求选择模型）：

配置方案一：复杂任务场景（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
          }
        ]
      }
    }
  }
}

配置方案二：通用场景（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
          }
        ]
      }
    }
  }
}

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

六、配置生效与模型验证

（一）重启服务使配置生效

执行以下命令重启OpenClaw网关服务：

• 方式一：分步操作clawdbot gateway stop（停止服务），等待2-3秒后执行clawdbot gateway start（启动服务）；
• 方式二：直接重启clawdbot gateway restart；
• 注意：2026.01.27之后安装的版本，将命令中的clawdbot替换为moltbot。

（二）模型识别验证

执行命令clawdbot models list（旧版）或moltbot models list（新版），若输出中包含“bailian/qwen3-max-2026-01-23”或“bailian/qwen-plus”，且标注“default, configured”，说明模型已被成功识别。

（三）连通性探测

执行命令clawdbot models status --probe（旧版）或moltbot models status --probe（新版），该命令会发送真实请求验证模型连通性（可能产生费用）。若输出“ok”状态，说明配置完全生效。

七、模型调用测试

（一）WebUI测试

执行clawdbot dashboard（旧版）或moltbot dashboard（新版），在打开的聊天界面中发送指令（如“介绍阿里云百炼的核心功能”），若能收到模型的有效响应，说明调用正常。

（二）CLI测试

在终端执行clawdbot agent --agent main --message "介绍下通义千问 Plus模型的应用场景"（旧版）或moltbot agent --agent main --message "介绍下通义千问 Plus模型的应用场景"（新版），查看终端输出的响应结果，验证模型调用能力。

八、关键注意事项与模型选型建议

（一）配置校验与故障排查

• OpenClaw配置文件校验严格，字段错误可能导致网关无法启动，若出现故障，可执行moltbot doctor（新版）或clawdbot doctor（旧版）查看具体报错；
• 确保API Key未泄露，若怀疑泄露，需立即在阿里云百炼平台注销旧密钥并重新创建；
• 不同地域的API Key独立，需确保服务器地域与API Key所属地域一致，降低调用延迟。

（二）模型选型指南

（三）额度说明

新用户开通阿里云百炼后90天内，可享受各模型100万Token的免费额度，超出后按对应计费标准收取费用。

通过以上步骤，即可完成OpenClaw与阿里云百炼API的全流程配置，让OpenClaw获得通义千问系列模型的强大支撑，适配更多复杂自动化场景。配置过程中需重点关注环境变量设置、配置文件格式正确性及模型连通性验证，确保每一步操作符合要求。