OpenClaw本地部署指南：用阿里云百炼搭建你的AI代理

2026-11-12 13:00 0 阅读

为什么你需要一个能“干活”的AI助理

如果你还在把大模型当作高级搜索引擎或聊天伴侣，那可能还没摸到2026年AI应用的门槛。现在的趋势很明确：AI正在从“对话式交互”转向“任务执行式交互”。

OpenClaw就是这一趋势下的典型代表。它不是一个简单的聊天机器人，而是一个能连接本地环境、第三方工具和网络服务的“数字员工”。

举个直观的例子：你想整理某技术论坛的热门内容。传统做法是问AI“怎么整理”，它会给你一堆建议；而OpenClaw可以直接调用浏览器技能，自动打开网页、抓取数据、清洗格式并生成表格。全程无需你手动复制粘贴。

对于个人开发者或极客来说，本地部署OpenClaw有三个实在的好处：

数据隐私：交互逻辑和文件处理都在本地或你自己的服务器上完成，敏感数据不必上传至第三方平台。
能力扩展：通过ClawHub社区，你可以像装手机App一样安装各种技能（Skills），比如管理文件、发送邮件或调用企业API。
低门槛试错：它对硬件要求极低，旧笔记本或低配云服务器都能跑。配合阿里云百炼等平台的免费额度，几乎零成本就能上手。

本文将带你从零开始，理清核心概念，完成本地部署，并让它真正动起来。

先搞懂这四个核心概念

很多新手部署失败，是因为没搞清楚OpenClaw各个组件的关系。花两分钟理解以下四点，能避开80%的坑。

OpenClaw：大脑与调度中心

OpenClaw（前身是Clawdbot/Moltbot）是整个系统的核心。它负责接收你的自然语言指令，解析意图，然后调度相应的技能去执行。

注意，OpenClaw本身没有大模型推理能力。它像个空架子，必须对接外部大模型API（如阿里云百炼、OpenAI）才能“思考”。这就是为什么配置API-Key是必选项。

Gateway：后台管家

Gateway是OpenClaw的后台进程，也是你需要长期运行的服务。它负责维持Web控制台连接、监控技能状态、处理API请求。如果Gateway挂了，你的AI助理就“离线”了。

Skills：手脚

Skills是模块化的功能插件，是OpenClaw干活的根本。常见的有：

agent-browser：无头浏览器，用于访问网页、抓取数据。
file-manager：管理本地文件。
email-sender：自动发送邮件。

没有Skills，OpenClaw只能陪你聊天，干不了实事。

ClawHub：技能市场

ClawHub是官方维护的技能仓库，拥有数千个社区贡献的Skills。你可以把它理解为应用商店，通过简单命令即可安装所需功能，无需自己写代码。

准备工作：环境与凭证

硬件与系统

OpenClaw非常轻量。官方推荐配置如下：

CPU：1核及以上（低配仅影响执行速度）。
内存：建议2GB以上，低于1GB可能导致Gateway启动失败。
磁盘：预留20GB空间，用于存储Node.js、技能文件和日志。
系统：Linux (Ubuntu 20.04+)、macOS (12+) 或 Windows 11 (WSL2)。

重要提示：Windows原生系统对Node.js子进程和文件路径的支持存在兼容性问题，极易导致端口占用或技能调用失败。强烈建议Windows用户安装WSL2（Windows Subsystem for Linux 2）。这是目前Windows环境下运行OpenClaw最稳定的方式。

获取API-Key

你需要一个大模型的API-Key。国内用户首选阿里云百炼，原因有二：一是网络稳定，无需科学上网；二是新用户通常有免费额度。

注册阿里云账号并完成实名认证。
进入“百炼大模型控制台”，在“密钥管理”中创建API-Key。
复制并妥善保存Key（只显示一次）。

如果你习惯使用OpenAI，也可以配置其API-Key，但需注意网络环境和付费问题。OpenClaw兼容OpenAI接口格式，配置时只需修改Base URL即可。

环境预检

在开始之前，打开终端（Windows Terminal/WSL2/macOS终端），检查两件事：

网络连通性：
```
ping dashscope.aliyuncs.com -c 4
```
确保能通，否则后续API调用会失败。
端口占用： OpenClaw默认使用18789端口。检查是否被占用：
```
# macOS/Linux/WSL2
lsof -i:18789
```
如果输出为空，说明端口空闲，可以 proceed。

五步完成本地部署

OpenClaw提供了一键安装脚本，这是新手最友好的方式。

1. 执行安装命令

在终端中运行：

curl -fsSL https://openclaw.ai/install.sh | bash

脚本会自动检测系统、安装Node.js（需≥22.0.0版本）、配置环境变量并启动Gateway。全程约2-3分钟。

当提示 How do you want to hatch your bot? 时，输入 1 选择打开Web UI。安装成功后，终端会显示Gateway进程ID和Web UI地址（通常是 http://localhost:18789）。

2. 配置API-Key

安装完成后，OpenClaw还是“空脑”。你需要通过Web UI或命令行配置模型。

方法一：Web UI配置（推荐）

浏览器访问 http://localhost:18789。
进入 Settings -> Model Providers -> Add Provider。
填写阿里云百炼配置：
- Name: bailian
- API Type: openai-completions
- API Key: 你的阿里云百炼API-Key
- Base URL: https://dashscope.aliyuncs.com/compatible-mode/v1
保存后，在 Models 页面添加模型：
- ID: qwen-turbo
- Provider: bailian
设为默认模型。

方法二：命令行配置

适合无图形界面的服务器环境：

openclaw config set models.providers.bailian.apiKey "你的API-Key"
openclaw config set models.providers.bailian.baseUrl "https://dashscope.aliyuncs.com/compatible-mode/v1"
openclaw config set models.providers.bailian.type "openai-completions"
openclaw config set models.default "bailian/qwen-turbo"
openclaw restart

3. 验证安装

运行以下命令检查状态：

openclaw version
openclaw status
openclaw doctor

如果 openclaw doctor 所有项都显示绿色对勾，说明部署成功。

实战：让AI助理抓取网页数据

现在，我们让OpenClaw干点实事。假设你需要每日跟踪开源中国（oschina.net）的热门项目。

1. 确认技能可用

在Web UI聊天框输入：

展示当前可用的Skills

确认列表中包含 agent-browser。如果没有，运行 openclaw skills install agent-browser 安装。

2. 下达指令

输入具体指令：

用agent-browser技能访问开源中国首页（oschina.net），抓取“热门项目”板块的项目名称、简介和今日Star数，整理成Markdown表格返回。

3. 观察执行

OpenClaw会显示执行进度：解析指令 -> 匹配技能 -> 启动浏览器 -> 访问网页 -> 抓取数据 -> 整理结果。整个过程约10-15秒。

4. 查看结果

AI会返回类似这样的表格：

项目名称	项目简介	今日Star
AI-Native-IDE	面向AI编程的原生IDE...	256
RustDesk	开源远程桌面软件...	189

注意：实际结果取决于网页结构和网络状况。如果失败，可以通过 openclaw logs gateway 查看日志排查。

常见坑与解决方案

1. command not found

原因：环境变量未生效或Node.js未安装。解决：

运行 source ~/.bashrc（或 ~/.zshrc）重载环境变量。
检查Node.js版本：node -v。如果未安装，重新运行安装脚本或手动安装Node.js 22+。

2. Invalid API Key

原因：Key复制错误、包含空格、或未实名认证。解决：

重新复制Key，确保无多余字符。
在阿里云控制台检查Key状态。
核对Base URL是否为 https://dashscope.aliyuncs.com/compatible-mode/v1。

用curl测试Key有效性：

curl https://dashscope.aliyuncs.com/compatible-mode/v1/chat/completions \
-H "Content-Type: application/json" \
-H "Authorization: Bearer 你的API-Key" \
-d '{"model": "qwen-turbo", "messages": [{"role": "user", "content": "你好"}]}'