OpenClaw从零到一部署手册：本地+阿里云环境搭建+大模型API完整配置教程-阿里云开发者社区

OpenClaw从零到一部署手册：本地+阿里云环境搭建+大模型API完整配置教程

2026-03-24 1377

版权

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

简介： OpenClaw是一款轻量化、可扩展、本地优先的AI智能体框架，能够通过自定义人格、记忆、工具与技能，打造完全属于个人的AI助手。本文提供最简洁、稳定、可复现的安装流程，覆盖Windows11、MacOS、Linux三大本地系统，并补充2026年阿里云服务器部署方案，同时包含阿里云千问大模型API与免费Coding Plan API的完整配置方法，搭配所有必备代码命令与常见问题解决方案，让任何人都能在5分钟内完成环境搭建，启动属于自己的AI助手。

OpenClaw是一款轻量化、可扩展、本地优先的AI智能体框架，能够通过自定义人格、记忆、工具与技能，打造完全属于个人的AI助手。本文提供最简洁、稳定、可复现的安装流程，覆盖Windows11、MacOS、Linux三大本地系统，并补充2026年阿里云服务器部署方案，同时包含阿里云千问大模型API与免费Coding Plan API的完整配置方法，搭配所有必备代码命令与常见问题解决方案，让任何人都能在5分钟内完成环境搭建，启动属于自己的AI助手。

一、前置环境要求

OpenClaw基于Node.js运行，环境要求清晰简单，无需复杂依赖，支持全平台统一使用：

Node.js v18及以上版本（推荐v20 LTS、v22.x）
npm 或 bun 包管理器
终端运行权限（管理员/root最佳）
浏览器（用于查看面板与部分技能渲染）
可选：微信公众号账号（用于内容发布技能）
目前阿里云部署 OpenClaw 只需两步，全网最简单，步骤流程访问阿里云OpenClaw一键部署专题页面 了解。

二、全平台Node.js安装教程

1. Windows11 安装方法

访问Node.js官网，下载LTS版本
运行安装包，全部默认下一步
安装完成后重启终端
验证版本
```
node -v
npm -v
```

2. MacOS 安装方法

使用Homebrew安装：

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

3. Linux（Ubuntu/Debian）安装方法

curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
sudo apt install -y nodejs

使用nvm安装（推荐）：

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
source ~/.bashrc
nvm install --lts

三、OpenClaw 全局安装

任意终端执行以下命令完成全局安装：

npm install -g openclaw

若出现权限错误：

Windows：使用管理员PowerShell
Mac/Linux：
```
sudo npm install -g openclaw
```

验证安装成功：

openclaw --version
openclaw --help

四、初始化工作区（必做）

创建独立文件夹用于存储人格、记忆、配置、技能：

# 创建工作区
mkdir -p ~/openclaw-workspace
cd ~/openclaw-workspace

初始化OpenClaw：

openclaw init

执行后自动生成以下核心文件：

SOUL.md：AI人格、语气、行为规则
USER.md：用户信息、偏好、使用习惯
MEMORY.md：长期记忆存储
TOOLS.md：工具开关与权限
memory/：每日对话日志
HEARTBEAT.md：主动任务配置

五、2026年阿里云服务器部署OpenClaw完整流程

阿里云适合7×24小时运行、远程调用、定时任务、消息推送。

1. 服务器配置

系统：Ubuntu 22.04 LTS
配置：2核2G/4G内存
安全组：放行22、18789端口

阿里云用户零基础部署 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对话页面。

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

2. 环境安装

sudo apt update && sudo apt upgrade -y
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo bash
sudo apt install -y nodejs git
npm config set registry https://registry.npmmirror.com

3. 安装与开机自启

npm install -g openclaw
mkdir -p ~/openclaw-workspace
cd ~/openclaw-workspace
openclaw init
openclaw gateway install --daemon
openclaw gateway start
systemctl enable openclaw-gateway

4. 阿里云千问大模型API配置

vim ~/openclaw-workspace/config.json

写入配置：

{
   
  "llm": {
   
    "provider": "aliyun-bailian",
    "api_key": "你的AccessKey ID",
    "api_secret": "你的AccessKey Secret",
    "base_url": "https://dashscope.aliyuncs.com/compatible-mode/v1",
    "model": "qwen3-max-2026-01-23",
    "temperature": 0.3
  }
}

重启生效：

openclaw gateway restart

六、本地全平台启动OpenClaw（MacOS/Linux/Windows11）

1. 启动网关服务

openclaw gateway start

2. 查看运行状态

openclaw gateway status

3. 进入AI交互模式

openclaw

4. 访问Web面板（可选）

浏览器打开：

http://localhost:18789

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

适合个人轻量使用，零成本、高稳定、无额度焦虑。

vim ~/openclaw-workspace/config.json

写入配置：

{
   
  "llm": {
   
    "provider": "openai-compatible",
    "api_key": "你的Coding Plan API Key",
    "base_url": "https://coding.dashscope.aliyuncs.com/v1",
    "model": "qwen3-coder-free",
    "temperature": 0.2
  }
}

重启网关：

openclaw gateway restart

测试模型是否连通：

openclaw llm test

八、技能仓库使用：安装、搜索、更新

OpenClaw通过技能扩展能力：

# 搜索可用技能
clawhub search

# 安装技能
clawhub install baoyu-translate
clawhub install baoyu-post-to-wechat
clawhub install weather

# 更新全部技能
clawhub update

# 同步技能列表
clawhub sync

九、微信公众号发布技能配置（可选）

# 创建技能配置目录
mkdir -p ~/openclaw-workspace/.baoyu-skills

# 写入公众号信息
cat > ~/openclaw-workspace/.baoyu-skills/.env << EOF
WECHAT_APP_ID=你的AppID
WECHAT_APP_SECRET=你的AppSecret
EOF

重启网关生效：

openclaw gateway restart

十、OpenClaw 完整目录结构说明

openclaw-workspace/
├── SOUL.md            # AI人格设定
├── USER.md            # 用户偏好设定
├── MEMORY.md          # 长期记忆
├── TOOLS.md           # 工具权限
├── HEARTBEAT.md       # 主动任务
├── config.json         # 模型与网关配置
├── memory/            # 每日对话日志
└── .baoyu-skills/     # 第三方技能密钥

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

1. 安装提示权限不足

Windows使用管理员终端，Mac/Linux加sudo。

2. openclaw命令不存在

检查Node.js是否正确安装，重新执行：

npm install -g openclaw

3. 网关启动失败

端口18789被占用，执行：

openclaw fix --port-conflict

4. 模型调用失败

检查API Key、Secret、Base URL、模型名称是否正确。

5. 技能无法触发

执行：

clawhub sync
openclaw gateway restart

6. 如何更新OpenClaw

npm install -g openclaw@latest
openclaw gateway restart

7. Web面板无法访问

检查网关是否启动、防火墙是否放行、端口是否正确。

8. 阿里云远程无法访问面板

安全组放行18789端口，重启服务。

十二、基础使用指令

# 启动服务
openclaw gateway start

# 停止服务
openclaw gateway stop

# 重启服务
openclaw gateway restart

# 进入对话
openclaw

# 安装技能
clawhub install 技能名

# 查看状态
openclaw gateway status

# 系统诊断
openclaw doctor

十三、总结

OpenClaw是一款极易上手、高度可扩展的AI智能体框架，只需安装Node.js、执行一条安装命令、初始化工作区，即可在5分钟内完成搭建。无论是Windows、MacOS、Linux本地运行，还是阿里云云端7×24小时部署，都能稳定运行。搭配阿里云千问大模型API可获得高精度理解能力，使用免费Coding Plan API可实现零成本使用，技能市场可扩展翻译、写作、搜索、公众号发布等数十种能力。

本文覆盖从零到一的全部流程，所有命令均可直接复制使用，无需编程基础，适合所有想要拥有专属、可控、私密AI助手的用户快速落地。

OpenClaw从零到一部署手册：本地+阿里云环境搭建+大模型API完整配置教程

一、前置环境要求

二、全平台Node.js安装教程

1. Windows11 安装方法

2. MacOS 安装方法

3. Linux（Ubuntu/Debian）安装方法

三、OpenClaw 全局安装

四、初始化工作区（必做）

五、2026年阿里云服务器部署OpenClaw完整流程

1. 服务器配置

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

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

2. 环境安装

3. 安装与开机自启

4. 阿里云千问大模型API配置

六、本地全平台启动OpenClaw（MacOS/Linux/Windows11）

1. 启动网关服务

2. 查看运行状态

3. 进入AI交互模式

4. 访问Web面板（可选）

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

八、技能仓库使用：安装、搜索、更新

九、微信公众号发布技能配置（可选）

十、OpenClaw 完整目录结构说明

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

1. 安装提示权限不足

2. openclaw命令不存在

3. 网关启动失败

4. 模型调用失败

5. 技能无法触发

6. 如何更新OpenClaw

7. Web面板无法访问

8. 阿里云远程无法访问面板

十二、基础使用指令

十三、总结

热门文章

最新文章

相关电子书

探索云世界

热门

云计算

大数据

云原生

人工智能

数据库

开发与运维

活动广场

任务中心

训练营

直播

乘风者计划

下载

镜像站

技术资料

OpenClaw从零到一部署手册：本地+阿里云环境搭建+大模型API完整配置教程

一、前置环境要求

二、全平台Node.js安装教程

1. Windows11 安装方法

2. MacOS 安装方法

3. Linux（Ubuntu/Debian）安装方法

三、OpenClaw 全局安装

四、初始化工作区（必做）

五、2026年阿里云服务器部署OpenClaw完整流程

1. 服务器配置

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

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

2. 环境安装

3. 安装与开机自启

4. 阿里云千问大模型API配置

六、本地全平台启动OpenClaw（MacOS/Linux/Windows11）

1. 启动网关服务

2. 查看运行状态

3. 进入AI交互模式

4. 访问Web面板（可选）

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

八、技能仓库使用：安装、搜索、更新

九、微信公众号发布技能配置（可选）

十、OpenClaw 完整目录结构说明

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

1. 安装提示权限不足

2. openclaw命令不存在

3. 网关启动失败

4. 模型调用失败

5. 技能无法触发

6. 如何更新OpenClaw

7. Web面板无法访问

8. 阿里云远程无法访问面板

十二、基础使用指令

十三、总结

热门文章

最新文章

相关电子书