零基础一站式搭建OpenClaw:阿里云+本地三系统+百炼API配置全程可复制教程

简介: 本文提供2026年最新、最简洁、最稳定的OpenClaw全平台部署方案,覆盖阿里云云端环境与MacOS、Linux、Windows11本地环境,包含从系统初始化到服务启动、端口放行、开机自启、模型对接、技能安装、命令使用、问题排查的全流程内容。所有步骤均为零基础设计,所有命令均可直接复制执行,无需额外知识即可完成稳定部署。

本文基于2026年最新稳定环境,提供一套无门槛、可直接复制、无多余步骤的OpenClaw(Clawdbot)完整部署方案,覆盖阿里云轻量服务器、本地MacOS、Linux、Windows11四大环境,包含系统初始化、环境安装、服务启动、端口配置、开机自启、阿里云百炼Coding Plan API对接、免费大模型配置、技能加载、常用命令与高频问题一站式解答。所有操作均面向零基础用户,无需前置技术背景,全程不使用营销表述,只保留可落地执行内容。
OpenClawo.png


一、OpenClaw运行基础说明

OpenClaw是一款可本地部署、支持技能扩展、能够执行自动化任务的AI智能体程序,依靠Node.js运行,可对接大模型完成理解、规划、检索、内容生成等任务。支持7×24小时云端运行,也可在本地电脑离线使用,数据优先保存在本地,具备较好的隐私性与稳定性。阿里云上OpenClaw极速一键部署最简单,步骤详情 访问阿里云OpenClaw一键部署专题页面 了解。
OpenClaw1.png

基础运行要求

  • 系统:Linux / macOS 12+ / Windows11
  • 运行环境:Node.js 22.x及以上
  • 内存:最低2GB
  • 端口:18789(Web控制台默认端口)

二、2026阿里云轻量服务器OpenClaw部署(完整版)

1. 服务器基础配置

  • 镜像:Alibaba Cloud Linux 3
  • 规格:2核2GB(最低)
  • 安全组放行:TCP 18789
  • 登录方式:Web终端 / SSH

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

第一步:打开访问阿里云OpenClaw一键部署专题页面,找到并点击【一键购买并部署】。
OpenClaw1.png
OpenClaw2.png
OpenClaw02.png
OpenClaw03.png
OpenClaw04.png

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

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

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

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

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

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

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

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

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

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

2. 系统更新与依赖安装

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

3. 安装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

4. 验证环境

node -v
npm -v

5. 设置npm国内镜像

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

6. 安装OpenClaw

npm install -g openclaw

7. 初始化配置

openclaw onboard

按提示选择:
同意协议 → 快速启动 → 暂不配置模型 → 启用全部通道

8. 配置公网访问

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

9. 启动服务

openclaw gateway start

10. 设置开机自启

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

11. 访问控制台

http://你的公网IP:18789

三、本地MacOS部署OpenClaw

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

# 安装Node.js
brew install node

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

# 安装OpenClaw
npm install -g openclaw

# 初始化
openclaw onboard

# 启动
openclaw gateway start

访问地址:

http://127.0.0.1:18789

四、本地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

五、本地Windows11部署(管理员PowerShell)

Set-ExecutionPolicy RemoteSigned -Scope CurrentUser

winget install OpenJS.NodeJS --version 22.0.0

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

npm install -g openclaw

openclaw onboard

openclaw gateway start

访问地址:

http://127.0.0.1:18789

六、阿里云百炼Coding Plan API配置(免费模型)

1. 获取密钥

  1. 访问登录阿里云百炼大模型服务平台
  2. 进入控制台 → 密钥管理
  3. 创建API Key、Access Key Secret
  4. 访问订阅阿里云百炼Coding Plan,领取免费调用额度

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

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

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

    2. 修改配置文件

    配置文件路径:
  • Mac/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
}

3. 重启服务

openclaw gateway restart

七、通用免费大模型Coding Plan API配置

"model": {
   
  "type": "openai",
  "api_key": "免费API密钥",
  "base_url": "https://api.example.com/v1",
  "model_name": "gpt-3.5-turbo",
  "max_tokens": 2048,
  "temperature": 0.6
}

配置后重启:

openclaw gateway restart

八、OpenClaw必备技能安装

npm install -g clawhub

clawhub install tavily-search
clawhub install agent-browser
clawhub install summarize
clawhub install skill-vetter
clawhub install proactive-agent

加载技能生效:

openclaw gateway restart

九、OpenClaw常用命令(必备)

# 启动服务
openclaw gateway start

# 停止服务
openclaw gateway stop

# 重启服务
openclaw gateway restart

# 查看状态
openclaw gateway status

# 查看日志
openclaw logs

# 查看技能列表
openclaw skill list

# 安装技能
openclaw skill install 技能名

# 重启技能
openclaw skill restart 技能名

# 系统检查
openclaw doctor

十、高频常见问题一站式解答

1. 命令不存在:openclaw: command not found

npm install -g openclaw

关闭终端重新打开。

2. 服务启动后自动退出

  • 内存不足,建议≥2GB
  • 查看错误日志:
    openclaw logs
    

3. 无法访问Web控制台

  • 阿里云安全组放行18789端口
  • 本地访问:http://127.0.0.1:18789
  • 重启服务:
    openclaw gateway restart
    

4. 端口被占用

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

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

5. 模型调用失败、无回复

  • 检查API Key是否正确
  • 确认已完成实名认证
  • 确认有免费调用额度
  • 模型名称填写:qwen-7b-chat
  • 重启服务

6. AI回复为空

在model配置中添加:

"reasoning": false

7. 响应超时

  • 将timeout修改为60
  • 降低max_tokens至1024
  • 检查网络状态

8. 技能安装失败

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

9. 技能不生效

openclaw gateway restart

10. Windows权限不足、无法运行脚本

Set-ExecutionPolicy RemoteSigned -Scope CurrentUser

11. Linux/Mac权限不足

sudo npm install -g openclaw

12. 定时任务不执行

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

十一、稳定运行优化配置(阿里云推荐)

1. 关闭不必要端口

仅保留18789,减少暴露面。

2. 定期更新

npm update -g openclaw

3. 日志清理

openclaw logs --clear

4. 内存优化

避免同时运行过多技能,降低系统负载。


十二、基础使用流程

  1. 启动服务:openclaw gateway start
  2. 浏览器打开控制台
  3. 输入自然语言指令执行任务
  4. 安装技能扩展功能
  5. 查看日志排查问题
  6. 配置模型实现AI能力

十三、总结

本文提供2026年最新、最简洁、最稳定的OpenClaw全平台部署方案,覆盖阿里云云端环境与MacOS、Linux、Windows11本地环境,包含从系统初始化到服务启动、端口放行、开机自启、模型对接、技能安装、命令使用、问题排查的全流程内容。所有步骤均为零基础设计,所有命令均可直接复制执行,无需额外知识即可完成稳定部署。

OpenClaw可用于个人信息管理、办公自动化、定时任务、数据检索、内容处理、实时监控等轻量化场景,搭配阿里云百炼免费模型即可实现完整可用的AI智能体能力,适合长期稳定运行。

目录
相关文章
|
11天前
|
人工智能 安全 Linux
【OpenClaw保姆级图文教程】阿里云/本地部署集成模型Ollama/Qwen3.5/百炼 API 步骤流程及避坑指南
2026年,AI代理工具的部署逻辑已从“单一云端依赖”转向“云端+本地双轨模式”。OpenClaw(曾用名Clawdbot)作为开源AI代理框架,既支持对接阿里云百炼等云端免费API,也能通过Ollama部署本地大模型,完美解决两类核心需求:一是担心云端API泄露核心数据的隐私安全诉求;二是频繁调用导致token消耗过高的成本控制需求。
5594 13
|
19天前
|
人工智能 JavaScript Ubuntu
5分钟上手龙虾AI!OpenClaw部署(阿里云+本地)+ 免费多模型配置保姆级教程(MiniMax、Claude、阿里云百炼)
OpenClaw(昵称“龙虾AI”)作为2026年热门的开源个人AI助手,由PSPDFKit创始人Peter Steinberger开发,核心优势在于“真正执行任务”——不仅能聊天互动,还能自动处理邮件、管理日程、订机票、写代码等,且所有数据本地处理,隐私完全可控。它支持接入MiniMax、Claude、GPT等多类大模型,兼容微信、Telegram、飞书等主流聊天工具,搭配100+可扩展技能,成为兼顾实用性与隐私性的AI工具首选。
22184 118