阿里云部署 Hermes Agent/OpenClaw 配置百炼 API-Key 完整教程-阿里云开发者社区

OpenClaw（前身为Clawdbot、Moltbot）作为一款开源AI个人助手，支持本地部署于MacOS、Windows及Linux系统，能通过自然语言指令控制设备、处理自动化任务（如邮件整理、日程管理、市场调研），且兼容Qwen、Claude、GPT等主流大语言模型。阿里云百炼作为企业级大模型服务平台，其API支持OpenAI-compatible接口，可无缝接入OpenClaw，助力调用通义千问3系列等模型能力。本文结合官方技术文档与实操经验，详细拆解从OpenClaw安装、百炼API Key获取到配置验证的全流程，确保操作贴合技术逻辑，适配不同操作系统用户的需求。
阿里云部署 OpenClaw/Hermes Agent全网最简单，只需两步，详情👉访问阿里云OpenClaw/Hermes一键部署专题页面 了解。

👉访问订阅阿里云百炼Token Plan AI大模型服务 。支持多模型切换，用于多模态模型灵活调用，实现多模型、多工具、多场景下的额度共享与统一管理，兼顾灵活性、稳定性与安全性，大幅降低企业使用大模型的门槛与成本。

一、核心认知与前置准备

在启动配置前，需明确OpenClaw与阿里云百炼的适配逻辑，完成基础环境检查，避免因依赖缺失或权限不足导致操作中断。

1.1 核心工具与适配逻辑

OpenClaw（原Clawdbot）：开源AI助理的核心价值在于“自动化任务执行”，而非单纯对话——例如指令“整理今日工作邮件”，它会直接完成分类、提取要点并生成提醒，而非罗列操作步骤。其模型调用依赖第三方平台，阿里云百炼是主流选择之一，通过API对接可实现通义千问系列模型的调用。
阿里云百炼：提供一站式大模型服务，支持通义千问3-Max（复杂推理）、通义千问-Plus（均衡性价比）等模型，API兼容OpenAI接口，无需修改OpenClaw核心代码即可对接。需注意，2026年部分用户仍沿用“Clawdbot”旧称，与“OpenClaw”指代同一工具，仅因品牌整合产生名称差异，配置流程完全一致。
阿里云三步快速部署 OpenClaw 教程
第一步：前往阿里云OpenClaw一键部署专题页面：https://www.aliyun.com/activity/ecs/clawdbot，找到并点击【一键购买并部署】

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

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

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

阿里云百炼密钥管理图.png

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

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

1.2 前置环境要求

Node.js版本验证：OpenClaw运行依赖Node.js ≥22，低于此版本会导致服务启动失败。
- 验证方式：打开终端（MacOS/Linux）或PowerShell（Windows），输入node -v，查看版本号；
- 升级方法：若版本不足，通过nvm（推荐）、fnm或brew升级。以nvm为例：
```
# 安装nvm（若未安装）
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
# 安装Node.js 22
nvm install 22
# 切换至22版本
nvm use 22
```
终端与权限准备：
- MacOS/Linux用户使用自带终端，Windows用户需以管理员身份打开PowerShell（避免脚本执行权限不足）；
- 确保本地设备网络稳定，可访问阿里云官网与OpenClaw官方资源，用于下载安装脚本与获取API Key。
阿里云账号准备：需注册并完成实名认证（个人用户通过身份证/支付宝授权，企业用户上传营业执照），未认证账号无法创建百炼API Key；同时确保账号有可用的百炼模型调用额度（新用户默认享有免费额度，可在百炼平台“用量管理”查看）。

二、OpenClaw（原Clawdbot）安装步骤

根据操作系统选择对应安装方式，推荐使用官方一键脚本，简化依赖配置与环境搭建，避免手动安装导致的版本冲突。

2.1 MacOS/Linux系统安装

一键安装脚本：打开终端，输入以下命令，脚本会自动下载OpenClaw主程序、依赖库并配置基础环境：
```
curl -fsSL https://clawd.bot/install.sh | bash
```
若脚本执行失败（如网络超时），可改用包管理器全局安装：
```
# npm方式
npm install -g clawdbot@latest
# pnpm方式（需先安装pnpm：npm install -g pnpm）
pnpm add -g clawdbot@latest
```
安装向导配置：脚本执行完成后，进入“Clawdbot onboarding”交互流程，按以下建议选择参数，避免后续配置冲突：

配置项	选择建议	说明
I understand this is powerful and inherently risky. Continue?	Yes	确认知晓Agent可执行系统命令、读写文件的权限风险
Onboarding mode	QuickStart	快速启动模式，简化初始配置，默认Gateway端口18789
Model/auth provider	Skip for now	暂不配置默认模型，后续手动对接阿里云百炼
Filter models by provider	All providers	不限制模型提供商，便于后续切换模型
Default model	默认配置	保持默认，通过配置文件修改更灵活
Select channel (QuickStart)	Skip for now	暂不配置IM渠道（如钉钉、QQ），后续按需添加
Configure skills now? (recommended)	No	暂不配置技能，避免初始环境复杂

安装验证：终端显示“Installation complete”及版本信息（如“Clawdbot 2026.1.24-3 (885167d)”），说明安装成功。

2.2 Windows系统安装

管理员身份启动PowerShell：右键点击开始菜单，选择“Windows PowerShell(管理员)”，避免脚本执行权限不足。
执行安装命令：输入以下命令，自动完成安装与基础配置：
```
iwr -useb https://clawd.bot/install.ps1 | iex
```
备选安装方式（包管理器）：
```
# npm方式
npm install -g clawdbot@latest
```
安装向导配置：与MacOS/Linux一致，按表格选择参数，完成后终端提示安装成功，即可进入下一步。

三、获取阿里云百炼API关键信息

OpenClaw调用百炼模型需三项核心凭证：API Key（身份授权）、base_url（模型调用地址）、model code（模型名称），需严格按步骤获取并妥善保管，避免泄露导致额度被盗用。

3.1 登录阿里云百炼平台

访问阿里云百炼大模型服务平台，使用已实名认证的阿里云账号登录。若未开通百炼服务，按系统提示完成开通（无额外费用，仅模型调用产生费用）。

3.2 创建并获取API Key

进入密钥管理页面：在平台左侧导航栏找到“密钥管理”，默认地域为华北2（北京），可根据后续OpenClaw部署地域调整（如新加坡、美国弗吉尼亚），不同地域API Key独立，邻近地域可降低调用延迟。
生成API Key：点击“创建API-Key”，系统自动生成一组“Access Key ID”与“Access Key Secret”。点击每个字段后的“复制”按钮，粘贴至本地加密文档（如记事本），切勿截图或分享——API Key仅创建时可完整查看，后续无法再次获取，泄露可能导致第三方冒用产生额外费用。
密钥安全操作：若怀疑密钥泄露，需立即返回“密钥管理”页面点击“禁用”，并重新创建新密钥；建议每3个月轮换一次密钥，提升安全性。

3.3 记录模型核心参数

需同步保存百炼模型的base_url与model code，确保后续配置格式正确：

base_url：OpenAI兼容接口地址，通用地址为https://dashscope.aliyuncs.com/compatible-mode/v1；若使用阿里云百炼Coding Plan套餐，专属base_url为https://coding.dashscope.aliyuncs.com/compatible-mode/v1（需在套餐页面确认）。
model code：推荐两种常用模型，适配不同场景：

模型名称	model code	核心特点	适用场景
通义千问3-Max-Thinking版	qwen3-max-2026-01-23	旗舰推理模型，支持工具调用，复杂任务处理能力强	多步骤任务、数据分析、智能体开发
通义千问3-Plus版	qwen-plus	效果与速度均衡，成本可控	日常对话、文档生成、轻量代码辅助

更多模型code可在百炼“模型广场”查询，需确保模型支持OpenAI-compatible接口。

四、配置API Key到环境变量（安全推荐）

为避免API Key直接写入配置文件导致泄露，建议将其配置到系统环境变量，通过变量引用实现授权，操作步骤因Shell类型不同略有差异。

4.1 确认Shell类型

打开终端（或PowerShell），输入以下命令，查看默认Shell：

echo $SHELL

输出/bin/zsh：为zsh用户（常见于MacOS Ventura及以上版本）；
输出/bin/bash：为bash用户（常见于Linux或旧版MacOS）。

4.2 zsh用户配置

写入环境变量：执行以下命令，将API Key追加至~/.zshrc文件（替换“YOUR_DASHSCOPE_API_KEY”为实际密钥）：
```
echo "export DASHSCOPE_API_KEY='YOUR_DASHSCOPE_API_KEY'" >> ~/.zshrc
```
使配置生效：执行命令刷新环境变量：
```
source ~/.zshrc
```
验证配置：重新打开终端，输入echo $DASHSCOPE_API_KEY，若输出完整API Key，说明配置成功。

4.3 bash用户配置

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

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

生效配置：
```
source ~/.bash_profile
```
验证：重新打开终端，输入echo $DASHSCOPE_API_KEY，确认输出正确。

五、修改OpenClaw配置文件（核心步骤）

OpenClaw配置文件字段严格校验，格式错误会导致Gateway服务启动失败，建议按模板填写，支持Web UI与手动编辑两种方式，可任选其一。

5.1 手动编辑配置文件（通用方式）

打开配置文件：根据安装时间选择命令：

# Clawdbot用户
nano ~/.clawdbot/clawdbot.json
# OpenClaw用户
nano ~/.moltbot/moltbot.json

粘贴模型配置模板：根据选择的模型，复制对应配置片段，替换文件中原有agents与models字段（确保JSON格式正确，无多余逗号或空格）。

模板1：通义千问3-Max-Thinking版（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
          }
        ]
      }
    }
  }
}

模板2：通义千问3-Plus版（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
          }
        ]
      }
    }
  }
}

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

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

打开配置面板：
```
# Clawdbot用户
clawdbot dashboard
# Moltbot用户
moltbot dashboard
```
终端会输出访问链接（如http://localhost:18789/dashboard），复制到浏览器打开。
添加百炼模型：在左侧导航栏找到“Models”，点击“Add Entry”，选择“Bailian”作为提供商，填写参数：
- baseUrl：输入对应模型的base_url；
- apiKey：选择“Environment Variable”，输入${DASHSCOPE_API_KEY}；
- models：添加目标模型（如qwen3-max-2026-01-23），填写名称、contextWindow等信息；
保存配置：点击“Save”，系统自动校验格式，无报错则配置完成。

六、配置生效与模型验证

完成配置后需重启服务，通过命令验证模型是否被识别、调用是否正常，确保整个流程无问题。

6.1 重启OpenClaw服务

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

# Clawdbot用户
clawdbot gateway restart
# Moltbot用户
moltbot gateway restart

服务重启耗时约2-3秒，终端显示“Gateway online”即启动成功；若提示失败，执行clawdbot doctor（或moltbot doctor）查看报错日志，常见原因为配置文件格式错误或API Key无效。

6.2 模型识别验证

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

# Clawdbot用户
clawdbot models list
# Moltbot用户
moltbot models list

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

6.3 连通性探测（真实调用）

执行以下命令，发送真实请求验证模型调用是否正常（会产生少量模型调用费用，新用户免费额度足够测试）：

# Clawdbot用户
clawdbot models status --probe
# Moltbot用户
moltbot models status --probe

终端输出“Status: ok”及响应耗时（如“9.4s”），表明API配置正确且模型可正常调用；若提示“权限不足”或“额度耗尽”，需检查百炼账号额度或API Key有效性。

6.4 对话场景验证

通过终端指令测试模型响应，确认功能正常：

# Clawdbot用户
clawdbot agent --agent main --message "介绍阿里云百炼的核心功能"
# Moltbot用户
moltbot agent --agent main --message "介绍阿里云百炼的核心功能"

若模型返回结构化回答（如阿里云百炼的模型服务、低代码构建等核心功能），说明整个配置流程完成，OpenClaw已可通过百炼模型实现智能交互与任务执行。

七、常见问题排查与优化建议

配置过程中可能遇到服务启动失败、模型调用无响应等问题，以下为高频问题的解决方案，及长期使用的优化建议。

7.1 常见问题解决

服务启动失败（Gateway报错）：
- 原因：配置文件格式错误（如逗号缺失、引号不匹配）、Node.js版本低于22、依赖库缺失；
- 解决：执行clawdbot doctor查看具体报错，修正配置文件；通过node -v确认版本，不足则升级；执行npm install补全依赖。
模型调用无响应：
- 原因：API Key错误、百炼额度耗尽、base_url配置错误、地域不匹配；
- 解决：重新创建API Key并更新环境变量；登录百炼平台补充额度；核对base_url是否与套餐匹配；确保OpenClaw部署地域与百炼API Key地域一致。
环境变量配置无效：
- 原因：未重新打开终端、Shell类型判断错误；
- 解决：配置后关闭终端重新打开，或执行source命令刷新；重新执行echo $SHELL确认Shell类型，选择对应配置方式。

7.2 优化建议

安全优化：定期轮换API Key与OpenClaw管理员密码；限制配置文件权限（执行chmod 600 ~/.clawdbot/clawdbot.json），避免非授权修改；
性能优化：复杂任务场景升级Node.js内存限制（如export NODE_OPTIONS=--max_old_space_size=4096）；启用模型缓存，减少重复请求（在配置文件中添加"cache": true）；
功能拓展：配置IM渠道（如钉钉、QQ），实现通过聊天工具调用OpenClaw；接入个人知识库，借助百炼模型的RAG能力实现精准问答；
成本控制：测试阶段使用qwen-plus等低成本模型；定期查看百炼用量报告，避免超额调用；闲置时停止OpenClaw服务（clawdbot gateway stop），降低资源消耗。

通过以上步骤，无论技术基础如何，均可完成OpenClaw与阿里云百炼API的配置，让OpenClaw具备强大的智能交互与任务自动化能力，适配24小时在线助手、日常办公自动化等多元场景。后续可根据需求拓展功能，充分发挥开源AI助理的价值，减少重复劳动，提升效率。

阿里云部署 Hermes Agent/OpenClaw 配置百炼 API-Key 完整教程

一、核心认知与前置准备

1.1 核心工具与适配逻辑

1.2 前置环境要求

二、OpenClaw（原Clawdbot）安装步骤

2.1 MacOS/Linux系统安装

2.2 Windows系统安装

三、获取阿里云百炼API关键信息

3.1 登录阿里云百炼平台

3.2 创建并获取API Key

3.3 记录模型核心参数

四、配置API Key到环境变量（安全推荐）

4.1 确认Shell类型

4.2 zsh用户配置

4.3 bash用户配置

五、修改OpenClaw配置文件（核心步骤）

5.1 手动编辑配置文件（通用方式）

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

六、配置生效与模型验证

6.1 重启OpenClaw服务

6.2 模型识别验证

6.3 连通性探测（真实调用）

6.4 对话场景验证

七、常见问题排查与优化建议

7.1 常见问题解决

7.2 优化建议

热门文章

最新文章

相关电子书

探索云世界

热门

云计算

大数据

云原生

人工智能

数据库

开发与运维

活动广场

任务中心

训练营

直播

乘风者计划

下载

镜像站

技术资料

阿里云部署 Hermes Agent/OpenClaw 配置百炼 API-Key 完整教程

一、核心认知与前置准备

1.1 核心工具与适配逻辑

1.2 前置环境要求

二、OpenClaw（原Clawdbot）安装步骤

2.1 MacOS/Linux系统安装

2.2 Windows系统安装

三、获取阿里云百炼API关键信息

3.1 登录阿里云百炼平台

3.2 创建并获取API Key

3.3 记录模型核心参数

四、配置API Key到环境变量（安全推荐）

4.1 确认Shell类型

4.2 zsh用户配置

4.3 bash用户配置

五、修改OpenClaw配置文件（核心步骤）

5.1 手动编辑配置文件（通用方式）

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

六、配置生效与模型验证

6.1 重启OpenClaw服务

6.2 模型识别验证

6.3 连通性探测（真实调用）

6.4 对话场景验证

七、常见问题排查与优化建议

7.1 常见问题解决

7.2 优化建议

热门文章

最新文章

相关电子书