OpenClaw 阿里云、本地macOS/Linux/Windows11部署保姆级教程+大模型配置、技能集成与问题排查指南

一、概述

OpenClaw（曾用名Clawdbot）是一款开源、可本地部署、支持技能扩展的自主AI智能体程序，能够通过自然语言指令完成信息检索、文件处理、定时任务、内容生成与自动化工作流。程序基于Node.js运行，支持在云端服务器长期稳定运行，也可在本地Windows、macOS、Linux设备上部署使用，数据优先存储于本地，具备良好的可控性与隐私性。本文以标准化、可复现、无冗余操作为目标，完整说明2026年阿里云轻量服务器部署、本地macOS/Linux/Windows11部署流程、技能安装与加载方法、阿里云百炼API及免费大模型Coding Plan对接方式，并对部署与使用过程中高频出现的问题提供统一解答，所有命令可直接复制执行。

二、部署前环境要求

• 操作系统：阿里云轻量服务器（Alibaba Cloud Linux 3）、Windows11、macOS 12及以上、Ubuntu/Debian等Linux发行版
• 运行环境：Node.js 22.x 及以上版本
• 网络条件：可正常访问外部资源，用于安装依赖与拉取程序包
• 最低配置：内存≥1GB，磁盘剩余空间≥10GB

环境检查命令：

node -v
npm -v

若输出版本信息，说明环境可用；若提示命令未找到，需先完成Node.js安装。

三、2026年阿里云轻量服务器部署OpenClaw流程

本节提供可直接在阿里云Web终端或SSH终端中执行的完整流程。

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

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

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

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

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

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

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

阿里云百炼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 的地址。
  
  

1. 系统更新与基础依赖安装

sudo yum update -y
sudo yum install -y curl git

2. 安装Node.js 22.x环境

curl -fsSL https://nodejs.org/dist/v22.0.0/node-v22.0.0-linux-x64.tar.xz -o node.tar.xz
sudo tar -xf node.tar.xz -C /usr/local/
sudo ln -sf /usr/local/node-v22.0.0-linux-x64/bin/node /usr/bin/node
sudo ln -sf /usr/local/node-v22.0.0-linux-x64/bin/npm /usr/bin/npm
sudo ln -sf /usr/local/node-v22.0.0-linux-x64/bin/npx /usr/bin/npx

3. 配置npm国内镜像

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

4. 全局安装OpenClaw

npm install -g openclaw

5. 初始化配置

openclaw onboard

按提示完成：同意协议 → 快速启动 → 暂不配置模型 → 启用全部通道。

6. 配置公网访问

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

7. 启动服务并设置开机自启

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

8. 安全组端口放行

在阿里云控制台安全组中放行TCP协议18789端口，用于Web控制台访问。

控制台访问地址：

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

四、本地环境全平台部署流程

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

2. Linux（Ubuntu/Debian）部署流程

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

sudo npm install -g n
sudo n stable

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

openclaw onboard
openclaw gateway start

3. Windows11 部署流程

以管理员身份运行PowerShell：

Set-ExecutionPolicy RemoteSigned -Scope CurrentUser

# 安装Node.js
winget install OpenJS.NodeJS --version 22.0.0

# 配置镜像
npm config set registry https://registry.npmmirror.com

# 安装OpenClaw
npm install -g openclaw

# 初始化
openclaw onboard

# 启动服务
openclaw gateway start

控制台访问：http://127.0.0.1:18789

五、Skills技能安装与管理方法

Skills是OpenClaw的功能扩展模块，用于实现搜索、浏览器操作、文本摘要、定时任务、文件处理等能力。

1. 安装技能管理工具

npm install -g clawhub

2. 常用基础技能安装

# 联网搜索
clawhub install tavily-search

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

# 文本摘要
clawhub install summarize

# 安全审计
clawhub install skill-vetter

# 定时任务
clawhub install proactive-agent

3. 技能管理命令

# 查看已安装技能
openclaw skill list

# 启动技能
openclaw skill start 技能名称

# 重启技能
openclaw skill restart 技能名称

# 查看技能状态
openclaw skill status 技能名称

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

六、大模型API配置（阿里云百炼 + 免费Coding Plan）

OpenClaw必须对接大模型API才能完成语义理解、内容生成与任务规划。

方案1：阿里云百炼Coding Plan API配置

1. 访问登录阿里云百炼大模型服务平台，创建API Key与Access Key Secret
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": 60,
  "reasoning": false
}

1. 重启服务：

   openclaw gateway restart
   

方案2：通用免费大模型Coding Plan配置

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

配置完成后执行重启命令：

openclaw gateway restart

七、高频常见问题解答

1. 命令未找到：openclaw: command not found

• 重新执行：npm install -g openclaw
• 关闭终端重新打开
• 确认Node.js环境正常

2. 服务启动后自动退出

• 内存不足，建议内存≥2GB
• 执行：openclaw logs 查看错误日志
• 重启服务：openclaw gateway restart

3. 无法访问Web控制台

• 检查服务状态：openclaw gateway status
• 阿里云需在安全组放行18789端口
• 本地访问地址：http://127.0.0.1:18789

4. 端口被占用

# Linux/macOS
lsof -i:18789
kill -9 进程ID

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

5. 技能安装失败

• 切换镜像：npm config set registry https://registry.npmmirror.com
• 重新执行安装命令
• 重启网关

6. 模型调用失败/回复为空

• 检查API Key与密钥是否正确
• 确认账号已完成实名认证
• 确认调用额度充足
• 在配置中添加："reasoning": false
• 重启服务

7. 响应超时

• 将timeout从30修改为60
• 降低max_tokens至1024
• 检查网络连通性

8. Windows权限不足/脚本无法运行

Set-ExecutionPolicy RemoteSigned -Scope CurrentUser

9. Linux/macOS权限不足

sudo npm install -g openclaw

10. 定时任务不执行

• 检查时区设置是否正确
• 检查Cron表达式格式
• 查看任务日志
• 确保服务持续运行

八、基础使用流程

1. 启动服务：openclaw gateway start
2. 浏览器打开Web控制台
3. 输入自然语言指令执行任务
4. 安装所需技能扩展能力
5. 查看运行日志：openclaw logs --follow

九、总结

本文完整覆盖2026年阿里云轻量服务器与本地Windows11、macOS、Linux三大平台部署OpenClaw的标准化流程，包含环境配置、服务启动、技能安装、模型对接、问题排查等全环节内容。所有操作面向零基础用户设计，无需前置技术背景即可完成稳定部署与日常使用。程序可广泛应用于个人信息管理、办公自动化、定时任务、数据检索、内容处理等轻量化场景，通过免费大模型即可实现稳定可用的AI智能体能力。