阿里云 OpenClaw / Hermes Agent 一键部署+如何配置百炼API流程指南-阿里云开发者社区

阿里云 OpenClaw / Hermes Agent 一键部署+如何配置百炼API流程指南

2026-04-28 41

版权

本文内容由阿里云实名注册用户自发贡献，版权归原作者所有，阿里云开发者社区不拥有其著作权，亦不承担相应法律责任。具体规则请查看《阿里云开发者社区用户服务协议》和《阿里云开发者社区知识产权保护指引》。如果您发现本社区中有涉嫌抄袭的内容，填写侵权投诉表单进行举报，一经查实，本社区将立刻删除涉嫌侵权内容。

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

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）调用，具备模型管理、密钥管控等能力。阿里云部署 OpenClaw/Hermes Agent全网最简单，只需两步，详情👉访问阿里云OpenClaw/Hermes一键部署专题页面 了解。

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，找到并点击【一键购买并部署】
阿里云轻量应用服务器部署OpenClaw1.png
阿里云轻量应用服务器部署OpenClaw2.png

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

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

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

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

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

端口放通：需要放通对应端口的防火墙，单击一键放通即可。
配置百炼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 安装向导配置

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

配置项	选择建议	说明
I understand this is powerful and inherently risky. Continue?	Yes	确认知晓权限风险并继续
Onboarding mode	QuickStart	快速启动模式，简化初始配置
Model/auth provider	Skip for now	暂不配置模型，后续手动对接百炼API
Filter models by provider	All providers	不限制模型提供商，便于后续选择
Default model	默认配置	保持默认，后续通过配置文件修改
Select channel (QuickStart)	Skip for now	暂不配置通信渠道（如钉钉、飞书）
Configure skills now? (recommended)	No	暂不配置技能，后续按需添加

三、阿里云百炼API Key获取

3.1 登录百炼平台

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

3.2 创建API Key

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

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）

执行命令，将环境变量追加至~/.zshrc文件：
```
echo "export DASHSCOPE_API_KEY='YOUR_DASHSCOPE_API_KEY'" >> ~/.zshrc
```
（将YOUR_DASHSCOPE_API_KEY替换为实际获取的百炼API Key）；
使配置生效：
```
source ~/.zshrc
```
验证配置：重新打开终端，执行echo $DASHSCOPE_API_KEY，若输出API Key则配置成功。

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

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

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

使配置生效：
```
source ~/.bash_profile
```
验证配置：执行echo $DASHSCOPE_API_KEY，确认输出正确。

4.2 修改OpenClaw配置文件

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

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

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

4.2.2 手动编辑配置文件

终端执行命令，打开配置文件：
- Clawdbot：nano ~/.clawdbot/clawdbot.json；
- Moltbot：nano ~/.moltbot/moltbot.json；

复制以下配置片段（以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
          }
        ]
      }
    }
  }
}

保存配置：在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。

七、百炼模型选型建议

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

模型名称	核心特点	适用场景
qwen3-max-2026-01-23	旗舰推理模型，支持工具调用，复杂推理能力强	多步骤任务（如数据分析、报告生成）、智能体开发
qwen-plus	平衡效果与速度，支持思考/非思考模式切换	客服机器人、内容生成、轻量级代码辅助
qwen-turbo	响应速度快，成本低	简单问答、指令解析、高频次低复杂度任务

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

阿里云 OpenClaw / Hermes Agent 一键部署+如何配置百炼API流程指南

一、基础概念与前置条件

1.1 核心工具说明

1.2 前置环境要求

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

二、OpenClaw（Moltbot）安装步骤

2.1 一键安装（推荐）

2.1.1 MacOS/Linux系统

2.1.2 Windows系统（PowerShell）

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

2.3 安装向导配置

三、阿里云百炼API Key获取

3.1 登录百炼平台

3.2 创建API Key

3.3 核心参数记录

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

4.1 配置环境变量（推荐）

4.1.1 查看Shell类型

4.1.2 zsh配置（常见于MacOS）

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

4.2 修改OpenClaw配置文件

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

4.2.2 手动编辑配置文件

五、配置生效与模型验证

5.1 重启OpenClaw服务

5.2 模型识别验证

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

5.4 对话场景验证

5.4.1 Web UI验证

5.4.2 终端验证

六、常见问题与解决方案

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

6.2 Gateway启动失败

6.3 模型调用无响应

七、百炼模型选型建议

热门文章

最新文章

相关电子书

探索云世界

热门

云计算

大数据

云原生

人工智能

数据库

开发与运维

活动广场

任务中心

训练营

直播

乘风者计划

下载

镜像站

技术资料

阿里云 OpenClaw / Hermes Agent 一键部署+如何配置百炼API流程指南

一、基础概念与前置条件

1.1 核心工具说明

1.2 前置环境要求

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

二、OpenClaw（Moltbot）安装步骤

2.1 一键安装（推荐）

2.1.1 MacOS/Linux系统

2.1.2 Windows系统（PowerShell）

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

2.3 安装向导配置

三、阿里云百炼API Key获取

3.1 登录百炼平台

3.2 创建API Key

3.3 核心参数记录

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

4.1 配置环境变量（推荐）

4.1.1 查看Shell类型

4.1.2 zsh配置（常见于MacOS）

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

4.2 修改OpenClaw配置文件

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

4.2.2 手动编辑配置文件

五、配置生效与模型验证

5.1 重启OpenClaw服务

5.2 模型识别验证

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

5.4 对话场景验证

5.4.1 Web UI验证

5.4.2 终端验证

六、常见问题与解决方案

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

6.2 Gateway启动失败

6.3 模型调用无响应

七、百炼模型选型建议

热门文章

最新文章

相关电子书