OpenClaw（曾用名Clawdbot/Moltbot）是2026年主流开源AI智能体框架，支持本地与云端双模式部署，可通过自然语言完成文件管理、信息检索、内容处理、流程自动化等任务，并依托Skills扩展更多实用能力。本文基于2026年3月最新环境，完整提供阿里云轻量应用服务器极速部署、本地Windows11/macOS/Linux手动部署、阿里云百炼Coding Plan免费大模型API配置、常用技能集成方法，以及全流程高频问题排查方案，所有命令均可直接复制执行，零基础用户也可快速完成搭建与稳定运行。

一、部署前环境与资源准备

1.1 系统与依赖要求

支持系统：Windows11、macOS 12及以上、Linux（Ubuntu/Debian/CentOS）、阿里云Alibaba Cloud Linux 3
运行环境：Node.js 22.x及以上LTS版本
硬件要求：服务器/本地设备内存≥2GB，系统盘≥40GB
网络条件：可正常访问外部网络，用于依赖下载与模型调用
阿里云上OpenClaw极速一键部署最简单，步骤详情访问阿里云OpenClaw一键部署专题页面 了解。

1.2 环境检查命令

node -v
npm -v

输出版本号表示环境可用；提示命令未找到则需先安装Node.js。

1.3 阿里云部署前置条件

完成阿里云账号注册与个人实名认证
开通轻量应用服务器，推荐2核2GB及以上配置
开通阿里云百炼Coding Plan免费套餐，获取API Key
安全组放行18789端口（Web控制台默认端口）

二、阿里云轻量应用服务器9分钟极速部署

2.1 实例创建与镜像选择

登录阿里云控制台，进入轻量应用服务器，点击创建实例
镜像选择：应用镜像 → OpenClaw（Moltbot）官方预装镜像
地域推荐：中国香港、新加坡、美国弗吉尼亚（内地地域联网搜索功能受限）
实例规格：2核2GB内存起步，系统盘40GB，选择购买时长并完成支付
等待实例初始化，状态变为运行中后记录公网IP

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

第一步：打开访问阿里云OpenClaw一键部署专题页面，找到并点击【一键购买并部署】。

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

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

轻量应用服务器OpenClaw镜像.png

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

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

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

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

2.2 端口放行与基础配置

进入实例详情 → 应用详情，找到端口放行模块，点击执行命令一键放行18789端口
远程连接服务器（Web终端或SSH工具），执行系统更新：
```
sudo yum update -y
sudo yum install -y curl git
```

2.3 Node.js 22环境安装

curl -fsSL https://nodejs.org/dist/v22.0.0/node-v22.0.0-linux-x64.tar.xz | sudo tar -xJ -C /usr/local
sudo ln -s /usr/local/node-v22.0.0-linux-x64/bin/node /usr/bin/node
sudo ln -s /usr/local/node-v22.0.0-linux-x64/bin/npm /usr/bin/npm

2.4 npm镜像加速配置

npm config set registry https://registry.npmmirror.com

2.5 OpenClaw安装与初始化

npm install -g openclaw
openclaw onboard

按提示完成初始化：同意协议、选择快速启动、暂时跳过模型配置、启用全部通道

2.6 公网访问与服务配置

openclaw config set gateway.host 0.0.0.0
openclaw config set gateway.port 18789
openclaw gateway start

2.7 开机自启设置

echo "/usr/bin/openclaw gateway start" | sudo tee -a /etc/rc.local
sudo chmod +x /etc/rc.local

2.8 访问Web控制台

浏览器输入地址：

http://你的服务器公网IP:18789

使用生成的Token登录即可进入管理界面。

三、本地三平台OpenClaw完整部署流程

3.1 macOS部署流程

安装Homebrew（已安装可跳过）

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

安装Node.js与基础依赖
```
brew install node
```

配置npm国内镜像

npm config set registry https://registry.npmmirror.com

安装与初始化OpenClaw

npm install -g openclaw
openclaw onboard
openclaw gateway start

访问地址：http://127.0.0.1:18789

3.2 Linux（Ubuntu/Debian）部署流程

系统更新与依赖安装

sudo apt update
sudo apt install -y curl git nodejs npm

升级Node.js至稳定版
```
sudo npm install -g n
sudo n stable
```

镜像配置与OpenClaw安装

npm config set registry https://registry.npmmirror.com
npm install -g openclaw
openclaw onboard
openclaw gateway start

3.3 Windows11部署流程

以管理员身份打开PowerShell，执行脚本权限配置
```
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
```

安装Node.js 22

winget install OpenJS.NodeJS --version 22.0.0

镜像配置与OpenClaw安装

npm config set registry https://registry.npmmirror.com
npm install -g openclaw
openclaw onboard
openclaw gateway start

本地访问地址：http://127.0.0.1:18789

四、Skills技能扩展与管理

4.1 技能管理工具安装

npm install -g clawhub

4.2 高频实用技能一键安装

# 联网搜索能力
clawhub install tavily-search

# 浏览器自动化操作
clawhub install agent-browser

# 文本内容摘要生成
clawhub install summarize

# 技能安全审计校验
clawhub install skill-vetter

# 主动提醒与消息推送
clawhub install proactive-agent

# 知识库同步与管理
clawhub install notion

4.3 技能通用操作命令

# 查看已安装技能列表
openclaw skill list

# 启动指定技能
openclaw skill start <技能名称>

# 重启指定技能
openclaw skill restart <技能名称>

# 查看技能运行状态
openclaw skill status <技能名称>

# 技能生效必须重启网关
openclaw gateway restart

五、阿里云百炼Coding Plan免费大模型API配置

5.1 API Key获取流程

访问登录阿里云百炼大模型服务平台，进入Coding Plan专区
开通免费套餐，进入密钥管理页面
创建API Key与Access Key Secret，妥善保存凭证

阿里云百炼Coding Plan API-Key 获取、配置保姆级教程：

创建API-Key，推荐访问订阅阿里云百炼Coding Plan，阿里云百炼Coding Plan每天两场抢购活动，从按tokens计费升级为按次收费，可以进一步节省费用！

购买后，在控制台生成API Key。注：这里复制并保存好你的API Key，后面要用。
回到轻量应用服务器-控制台，单击服务器卡片中的实例 ID，进入服务器概览页。
在服务器概览页面单击应用详情页签，进入服务器详情页面。
端口放通在OpenClaw使用步骤区域中，单击端口放通下的执行命令，可开放获取OpenClaw 服务运行端口的防火墙。
这里系统会列出我们第一步中创建的阿里云百炼 Coding Plan的API Key，直接选择就可以。
获取访问地址单击访问 Web UI 面板下的执行命令，获取 OpenClaw WebUI 的地址。

5.2 配置文件修改

配置文件路径：

macOS/Linux：~/.openclaw/config.json
Windows：C:\Users\用户名.openclaw\config.json

写入模型配置：

"model": {
  "type": "aliyun-bailian",
  "api_key": "你的APIKey",
  "secret": "你的AccessKeySecret",
  "model_name": "qwen-7b-chat",
  "max_tokens": 2048,
  "temperature": 0.7,
  "timeout": 30,
  "reasoning": false
}

5.3 服务重启与生效

openclaw gateway restart

5.4 通用免费大模型兼容配置

"model": {
  "type": "openai",
  "api_key": "免费API Key",
  "base_url": "免费接口地址",
  "model_name": "gpt-3.5-turbo",
  "max_tokens": 2048,
  "temperature": 0.7
}

修改完成后重启网关即可生效。

六、全流程高频问题与解决方案

6.1 部署与启动类问题

提示openclaw: command not found

重新执行全局安装：npm install -g openclaw
关闭终端重新打开，刷新环境变量
检查Node.js是否正确安装并配置环境变量

服务启动后自动关闭

内存不足：服务器/本地设备建议内存≥2GB
查看错误日志：openclaw logs
关闭占用资源过多的程序，重新启动服务

无法访问Web控制台

检查服务状态：openclaw gateway status
服务器放行18789端口，本地检查防火墙拦截
重启服务：openclaw gateway restart
本地访问地址：http://127.0.0.1:18789

端口被占用解决方法
```
Linux/macOS
lsof -i:18789
kill -9 进程ID

Windows

netstat -ano | findstr "18789"
taskkill /F /PID 进程ID


### 6.2 技能安装与使用问题
1. `clawhub`命令不可用
- 执行安装：`npm install -g clawhub`

2. 技能安装失败
- 切换npm镜像：`npm config set registry https://registry.npmmirror.com`
- 重新执行技能安装命令

3. 技能安装后不生效
- 重启网关服务：`openclaw gateway restart`
- 查看技能加载状态：`openclaw skill list`

### 6.3 模型API对接问题
1. 模型调用失败、权限不足
- 检查API Key与Secret是否正确
- 确认账号完成实名认证，调用额度充足
- 核对模型名称填写正确

2. AI回复为空
- 配置中添加`"reasoning": false`
- 重启服务生效

3. 响应超时
- 增大超时时间：30→60
- 降低max_tokens：2048→1024
- 检查网络连通性

### 6.4 系统与权限问题
1. Linux/macOS权限不足

sudo npm install -g openclaw


2. Windows脚本禁止运行

Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
```

无法写入配置文件

检查目录读写权限
重新初始化：openclaw onboard --reset

七、基础使用流程与维护建议

7.1 日常使用步骤

启动服务：openclaw gateway start
浏览器打开Web控制台
输入自然语言指令执行任务
通过Skills扩展功能场景
实时查看运行日志：openclaw logs --follow

7.2 长期运行维护建议

定期更新OpenClaw与技能组件
清理过期日志与缓存文件
重要配置文件定期备份
服务器部署建议开启自动快照
避免安装来源不明的技能插件

八、总结

2026年OpenClaw已形成成熟的云端+本地双部署体系，阿里云轻量应用服务器可实现9分钟极速搭建与7×24小时稳定运行，本地Windows11/macOS/Linux部署满足隐私优先场景需求。配合阿里云百炼Coding Plan免费大模型API，用户可零成本启用核心智能能力，通过Skills扩展实现搜索、浏览器操作、内容处理、自动化提醒等多元化功能。

本文覆盖从环境准备、部署安装、技能扩展、模型对接至问题排查的全流程操作，所有命令均经过实测验证，可直接复制使用，帮助用户快速搭建稳定、实用、可扩展的AI智能体系统，无论是个人效率提升、内容创作、信息管理还是小型自动化任务，均可满足日常使用需求。

OpenClaw(Clawdbot)从零到一实操手册：云端本地双部署+技能扩展+问题一站式解决

一、部署前环境与资源准备

1.1 系统与依赖要求

1.2 环境检查命令

1.3 阿里云部署前置条件

二、阿里云轻量应用服务器9分钟极速部署

2.1 实例创建与镜像选择

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

2.2 端口放行与基础配置

2.3 Node.js 22环境安装

2.4 npm镜像加速配置

2.5 OpenClaw安装与初始化

2.6 公网访问与服务配置

2.7 开机自启设置

2.8 访问Web控制台

三、本地三平台OpenClaw完整部署流程

3.1 macOS部署流程

3.2 Linux（Ubuntu/Debian）部署流程

3.3 Windows11部署流程

四、Skills技能扩展与管理

4.1 技能管理工具安装

4.2 高频实用技能一键安装

4.3 技能通用操作命令

五、阿里云百炼Coding Plan免费大模型API配置

5.1 API Key获取流程

阿里云百炼Coding Plan API-Key 获取、配置保姆级教程：

5.2 配置文件修改

5.3 服务重启与生效

5.4 通用免费大模型兼容配置

六、全流程高频问题与解决方案

6.1 部署与启动类问题

Linux/macOS

Windows

七、基础使用流程与维护建议

7.1 日常使用步骤

7.2 长期运行维护建议

八、总结

热门文章

最新文章

相关电子书

探索云世界

热门

云计算

大数据

云原生

人工智能

数据库

开发与运维

活动广场

任务中心

训练营

直播

乘风者计划

下载

镜像站

技术资料

OpenClaw(Clawdbot)从零到一实操手册：云端本地双部署+技能扩展+问题一站式解决

一、部署前环境与资源准备

1.1 系统与依赖要求

1.2 环境检查命令

1.3 阿里云部署前置条件

二、阿里云轻量应用服务器9分钟极速部署

2.1 实例创建与镜像选择

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

2.2 端口放行与基础配置

2.3 Node.js 22环境安装

2.4 npm镜像加速配置

2.5 OpenClaw安装与初始化

2.6 公网访问与服务配置

2.7 开机自启设置

2.8 访问Web控制台

三、本地三平台OpenClaw完整部署流程

3.1 macOS部署流程

3.2 Linux（Ubuntu/Debian）部署流程

3.3 Windows11部署流程

四、Skills技能扩展与管理

4.1 技能管理工具安装

4.2 高频实用技能一键安装

4.3 技能通用操作命令

五、阿里云百炼Coding Plan免费大模型API配置

5.1 API Key获取流程

阿里云百炼Coding Plan API-Key 获取、配置保姆级教程：

5.2 配置文件修改

5.3 服务重启与生效

5.4 通用免费大模型兼容配置

六、全流程高频问题与解决方案

6.1 部署与启动类问题

Linux/macOS

Windows

七、基础使用流程与维护建议

7.1 日常使用步骤

7.2 长期运行维护建议

八、总结

热门文章

最新文章

相关电子书