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

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

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

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

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

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

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一键部署专题页面：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. 安装完成后启动初始化向导，按以下推荐配置完成基础设置：

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，降低泄露风险，建议将其配置到系统环境变量中：

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的模型配置需按特定格式写入配置文件，支持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": , "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": , "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”状态，说明配置完全生效。

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

在终端执行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获得通义千问系列模型的强大支撑，适配更多复杂自动化场景。配置过程中需重点关注环境变量设置、配置文件格式正确性及模型连通性验证，确保每一步操作符合要求。