OpenClaw(原Clawdbot)作为2026年开源AI自动化代理领域的核心工具,凭借系统级权限调用、多模型适配、多渠道交互的核心特性,成为打造私人AI助手的优选方案。它不仅能实现自然语言指令的解析与执行,还支持跨平台的持久记忆、主动推送、技能扩展等功能,可通过Anthropic Claude、OpenAI GPT、Ollama本地模型等十余种大模型提供推理能力,同时对接飞书、Telegram、Discord等主流通讯渠道,真正实现一站式的AI自动化办公与协作。
本文将以保姆级视角,详细拆解2026年阿里云服务器部署与本地多系统(Windows/macOS/Linux)部署OpenClaw的完整流程,涵盖环境准备、一键安装、多模型配置、多渠道对接、常用命令与安全配置等核心内容,所有操作均附带可直接复制的代码命令,确保不同基础的用户都能顺利搭建属于自己的私人AI助手。阿里云上OpenClaw一键极速部署最简单,步骤详情 访问阿里云OpenClaw一键部署专题页面 了解。

一、核心系统要求
OpenClaw对运行环境有明确的基础要求,满足以下条件可确保部署过程无兼容性问题,阿里云与本地部署的系统要求一致,具体参数如下:
| 项目 | 最低要求 | 推荐配置 |
|---|---|---|
| 操作系统 | macOS 12+ / Ubuntu 20.04+ / Debian 11+ / CentOS 8+ / Windows 10+(WSL2) | Ubuntu 22.04+ / macOS 14+ / Windows 11(WSL2) |
| Node.js版本 | v22.0.0或更高 | v22.10.0最新稳定版 |
| 内存 | 2GB | 4GB+ |
| 磁盘空间 | 1GB | 10GB+(用于存储模型、日志与插件) |
| 网络 | 通畅的网络连接 | 千兆网络(便于快速下载依赖与模型) |
关键说明:Windows原生系统需通过WSL2模拟Linux环境部署,建议直接安装Ubuntu 22.04 WSL2子系统,可避免大部分兼容性问题;阿里云服务器优先选择Ubuntu 22.04系统,适配性最佳。
二、2026年阿里云服务器部署OpenClaw步骤流程
阿里云服务器部署适用于需要7×24小时稳定运行、多设备远程访问的场景,依托云服务器的公网IP与稳定性,可实现飞书、Telegram等渠道的全天候交互,推荐选择2核4G及以上配置的轻量应用服务器,以下为完整部署步骤。
阿里云用户零基础部署OpenClaw步骤喂饭级步骤流程
第一步:访问阿里云OpenClaw一键部署专题页面,找到并点击【一键购买并部署】。
阿里云OpenClaw一键部署专题页面:https://www.aliyun.com/activity/ecs/clawdbot


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



第三步:访问阿里云百炼大模型控制台,找到密钥管理,单击创建API-Key。
前往轻量应用服务器控制台,找到安装好OpenClaw的实例,进入「应用详情」放行18789端口、配置百炼API-Key、执行命令,生成访问OpenClaw的Token。
- 端口放通:需要放通对应端口的防火墙,单击一键放通即可。
- 配置百炼API-Key,单击一键配置,输入百炼的API-Key。单击执行命令,写入API-Key。
- 配置OpenClaw:单击执行命令,生成访问OpenClaw的Token。
- 访问控制页面:单击打开网站页面可进入OpenClaw对话页面。
(一)步骤1:阿里云服务器初始化与环境准备
- 登录阿里云控制台,访问阿里云轻量应用服务器控制台,选择Ubuntu 22.04 64位系统,配置2核4G及以上,地域优先选择免备案地域(如中国香港、新加坡),避免ICP备案流程;
- 通过SSH工具(如Xshell、FinalShell)远程登录服务器,执行以下命令更新系统依赖并安装基础工具:
```bash一键更新系统所有依赖
sudo apt update -y && sudo apt upgrade -y
安装Git、curl等基础工具
sudo apt install -y git curl wget
3. 验证Node.js版本,若服务器未安装或版本低于v22,执行以下命令安装最新版Node.js:
```bash
# 配置Node.js v22官方源
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
# 安装Node.js
sudo apt-get install -y nodejs
# 验证Node.js与npm版本(返回v22+即为成功)
node -v
npm -v
(二)步骤2:OpenClaw一键安装(推荐)
OpenClaw提供官方一键安装脚本,可自动检测环境、安装依赖、配置服务,无需手动操作,执行以下命令即可完成安装:
# 执行官方一键安装脚本
curl -fsSL https://raw.githubusercontent.com/miaoxworld/OpenClawInstaller/main/install.sh | bash
脚本自动执行操作:
- 检测系统环境,自动安装缺失的依赖组件;
- 全局安装OpenClaw核心程序;
- 引导完成基础配置(AI模型选择、身份信息设置);
- 自动测试API连接状态;
- 后台启动OpenClaw Gateway服务;
- 提供配置菜单入口,支持后续的渠道与高级配置。
若一键安装脚本执行失败,可采用手动安装方式,步骤如下:
# 1. 克隆官方安装仓库
git clone https://github.com/miaoxworld/OpenClawInstaller.git
cd OpenClawInstaller
# 2. 为脚本添加执行权限
chmod +x install.sh config-menu.sh
# 3. 运行安装脚本
./install.sh
# 若出现权限问题,先手动全局安装OpenClaw再执行脚本
npm install -g openclaw
./install.sh
(三)步骤3:安装完成后基础配置与服务管理
安装脚本执行完成后,会自动询问是否启动OpenClaw服务,推荐选择Y,后续可通过以下命令进行服务管理,这也是阿里云部署的核心操作:
# 手动启动服务(前台运行,用于调试)
source ~/.openclaw/env && openclaw gateway
# 后台启动服务(推荐,守护进程模式)
openclaw gateway start
# 查看服务运行状态
openclaw gateway status
# 重启服务(配置修改后生效)
openclaw gateway restart
# 停止服务
openclaw gateway stop
核心配置入口:运行以下命令打开交互式配置菜单,可完成AI模型、消息渠道、安全设置等所有配置操作,这是后续配置的核心入口:
# 运行本地配置菜单
bash ~/.openclaw/config-menu.sh
# 或从GitHub下载最新配置菜单运行
curl -fsSL https://raw.githubusercontent.com/miaoxworld/OpenClawInstaller/main/config-menu.sh | bash
配置菜单包含9大核心功能,可通过数字选择操作,涵盖系统状态、AI模型配置、消息渠道配置、身份个性配置、安全设置、服务管理、快速测试、高级设置、查看当前配置,基本满足所有使用需求。
(四)步骤4:阿里云服务器端口放行
OpenClaw默认使用18789端口作为网关端口,需在阿里云控制台放行该端口,确保外部连接与渠道交互正常:
- 登录阿里云轻量应用服务器控制台,找到对应实例,进入「防火墙/安全组」配置页面;
- 新增入方向规则,端口范围填写
18789,来源设置为0.0.0.0/0(测试阶段),稳定运行后可改为指定IP提升安全性; - 保存规则,等待1-2分钟生效,执行以下命令验证端口是否开放:
# 检测18789端口状态 netstat -tulpn | grep 18789
三、2026年本地部署OpenClaw步骤流程
本地部署适用于个人轻量使用、敏感数据处理的场景,零成本且数据隐私可控,支持macOS、Linux、Windows(WSL2)三大系统,核心流程与阿里云部署一致,仅环境准备环节略有差异,以下分系统详细讲解。
(一)macOS本地部署
- 环境准备:确保安装Homebrew包管理器,执行以下命令安装Git、Node.js v22:
```bash安装Homebrew(未安装的情况下)
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
安装Git、Node.js v22
brew install git node@22
配置Node.js环境变量,使其全局生效
brew link --overwrite node@22
验证版本
node -v
2. **一键安装OpenClaw**:执行与阿里云部署相同的一键安装脚本,步骤完全一致:
```bash
curl -fsSL https://raw.githubusercontent.com/miaoxworld/OpenClawInstaller/main/install.sh | bash
- 服务管理与配置:与阿里云部署的命令完全一致,可通过
openclaw gateway start后台启动服务,通过配置菜单完成后续设置。
(二)Linux本地部署(Ubuntu/Debian/CentOS)
以Ubuntu 22.04为例,CentOS系统仅需将apt命令替换为yum,步骤如下:
- 环境准备:
```bashUbuntu/Debian
sudo apt update -y && sudo apt install -y git curl
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt-get install -y nodejs
CentOS
sudo yum update -y && sudo yum install -y git curl
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo yum install -y nodejs
验证版本
node -v
2. **一键安装与配置**:与阿里云部署完全一致,执行一键安装脚本后通过配置菜单完成设置。
### (三)Windows本地部署(WSL2 Ubuntu 22.04)
Windows原生系统需通过WSL2模拟Linux环境,这是最稳定的部署方式,步骤如下:
1. **安装WSL2 Ubuntu 22.04**:
- 打开微软应用商店,搜索「Ubuntu 22.04」,点击安装;
- 安装完成后打开,设置用户名与密码,完成初始化;
2. **环境准备**:在WSL2终端中执行与阿里云部署相同的环境准备命令,安装Git、Node.js v22;
3. **一键安装OpenClaw**:执行官方一键安装脚本,后续的服务管理、配置与阿里云部署完全一致;
4. **本地访问**:在Windows浏览器中输入`http://localhost:18789`,即可访问OpenClaw本地控制台。
### (四)桌面版OpenClaw Manager(图形界面,推荐新手)
若不习惯命令行操作,可使用OpenClaw Manager桌面应用,基于Tauri 2.0构建,提供现代化可视化界面,支持实时监控、一键配置AI模型与消息渠道,跨平台兼容macOS、Windows、Linux,下载与使用步骤如下:
1. 访问官方下载地址:`github.com/miaoxworld/openclaw-manager`,下载对应系统的安装包;
2. 安装完成后打开,按照界面引导完成基础配置,自动检测本地环境并安装依赖;
3. 通过可视化仪表盘查看服务状态、内存占用、运行时间,一键启动/停止服务,配置AI模型与消息渠道,无需手动输入命令。
## 四、核心配置:多模型适配与多渠道对接
OpenClaw的核心优势在于多模型支持与多渠道接入,配置均通过交互式配置菜单完成,选择`[2] AI模型配置`与`[3]消息渠道配置`即可进入对应配置页面,以下为核心配置实操。
### (一)多模型配置:十余种模型自由选择
OpenClaw支持Anthropic Claude、OpenAI GPT、Ollama本地模型等9大类AI提供商,涵盖云端大模型、多模型网关、本地模型,可根据需求自由选择,核心配置步骤如下:
1. 运行配置菜单,选择`[2] AI模型配置`,输入对应数字选择AI提供商;
2. 按提示输入自定义API地址(留空使用官方地址)与API Key,选择具体模型,完成配置;
3. 配置完成后可通过`[7]快速测试`中的`[1] 测试AI API连接`验证是否配置成功。
#### 1. 主流云端模型配置要点
- **Anthropic Claude**:推荐模型`claude-sonnet-4-5`,API Key从Anthropic Console(https://console.anthropic.com/)获取,支持OneAPI/NewAPI代理,只需填入代理地址与Key;
- **OpenAI GPT**:推荐模型`gpt-4o-mini`,API Key从OpenAI Platform获取,自定义API地址需支持`v1/responses`路径,而非传统的`v1/chat/completions`;
- **Google Gemini**:推荐模型`gemini-2.0-flash`,API Key从Google AI Studio获取,无需配置自定义地址,直接输入Key即可。
#### 2. 本地模型配置(Ollama,无需API Key)
适合注重数据隐私的用户,无需联网即可使用,配置步骤如下:
```bash
# 1. 先安装Ollama
curl -fsSL https://ollama.com/install.sh | sh
# 2. 拉取本地模型(推荐llama3,轻量且性能均衡)
ollama pull llama3
# 3. 在OpenClaw配置菜单中选择[4] Ollama本地模型,直接完成配置,无需输入Key
3. 多模型网关配置(OpenRouter)
一个Key即可使用所有主流模型,包括Claude、GPT、Gemini,只需在配置菜单中选择[5] OpenRouter,输入API Key即可,无需额外配置地址。
(二)多渠道对接:主流通讯工具全覆盖
OpenClaw支持飞书、Telegram、Discord、WhatsApp、Slack等主流渠道,其中飞书为国内用户首选,采用WebSocket长连接模式,无需公网服务器与Webhook地址,配置最简单,以下为核心渠道配置实操。
1. 飞书机器人配置(重点,国内首选)
核心优势:无需公网IP、无需Webhook地址、个人账号即可创建,步骤如下:
- 访问飞书开放平台(open.feishu.cn),登录个人飞书账号,创建企业自建应用(无需企业认证);
- 进入应用详情,点击「添加应用能力」,选择「机器人」,开启机器人开关;
- 进入「权限管理」,添加以下核心权限:
im:message(收发消息)im:message:send_as_bot(以机器人身份发送消息)im:chat:readonly(读取会话信息)
- 进入「版本管理与发布」,创建版本并发布上线(必须发布,否则无法接收消息);
- 复制应用的
App ID与App Secret,在OpenClaw配置菜单中选择[3]消息渠道配置→飞书,输入上述信息; - 启动OpenClaw服务,返回飞书开放平台,进入「事件与回调」,选择「使用长连接接收事件」,添加事件
im.message.receive_v1,无需填写Webhook地址,直接保存; - 将飞书机器人添加至个人单聊或群组,发送消息即可触发机器人回复。
2. Telegram机器人配置
- 在Telegram中搜索
@BotFather,发送/newbot创建新机器人,设置名称与用户名,复制生成的Bot Token; - 搜索
@userinfobot,发送任意消息获取你的User ID; - 在OpenClaw配置菜单中选择
[3]消息渠道配置→Telegram,输入Bot Token与User ID,完成配置; - 测试:在Telegram中向机器人发送消息,验证是否回复。
3. WhatsApp配置(无需商业API)
- 在OpenClaw配置菜单中选择
[3]消息渠道配置→WhatsApp; - 终端会生成二维码,使用手机WhatsApp扫描二维码完成登录;
- 登录成功后执行
openclaw gateway restart重启服务,用WhatsApp给自己发送消息即可触发回复;
注意:WhatsApp账号仅能在一个设备上登录Web版,配置后原有的WhatsApp Web会被踢下线。
五、OpenClaw常用命令与配置说明
(一)核心常用命令
OpenClaw的所有操作均可通过命令行完成,涵盖服务管理、配置管理、数据管理三大类,阿里云与本地部署命令完全一致,可直接复制执行:
1. 服务管理命令
# 后台启动服务
openclaw gateway start
# 停止服务
openclaw gateway stop
# 重启服务
openclaw gateway restart
# 查看服务状态
openclaw gateway status
# 前台运行服务(调试用,可查看实时日志)
openclaw gateway
# 查看日志
openclaw logs
# 实时查看日志
openclaw logs --follow
2. 配置管理命令
# 打开配置文件(手动编辑)
openclaw config
# 运行配置向导(首次安装引导)
openclaw onboard
# 诊断配置问题(核心排错命令)
openclaw doctor
# 网关健康检查
openclaw health
3. 数据管理命令
# 导出对话历史,支持json格式
openclaw export --format json
# 清理OpenClaw持久记忆
openclaw memory clear
# 备份配置与数据
openclaw backup
# 手动备份配置文件(推荐)
cp -r ~/.openclaw ~/openclaw_backup_$(date +%Y%m%d)
(二)配置文件说明
OpenClaw的配置文件均存储在~/.openclaw/目录下,无需手动编辑,配置菜单会自动管理,核心文件如下:
~/.openclaw/
├── openclaw.json # 核心配置文件,存储AI模型、渠道等所有配置
├── env # 环境变量文件,存储API Key、Base URL等敏感信息
├── backups/ # 自动备份目录,存储配置备份文件
└── logs/ # 日志目录,存储服务运行日志
环境变量配置示例(~/.openclaw/env):
# Anthropic Claude配置
export ANTHROPIC_API_KEY=sk-ant-xxxxxxxxxxxxxxxx
export ANTHROPIC_BASE_URL=https://your-api-proxy.com # 可选代理地址
# OpenAI GPT配置
export OPENAI_API_KEY=sk-xxxxxxxxxxxxxxxx
export OPENAI_BASE_URL=https://your-api-proxy.com/v1 # 可选代理地址
六、安全配置与风险防范
OpenClaw需要系统级的操作权限,存在一定的安全风险,尤其是阿里云公网部署时,需做好安全配置,避免未授权访问与数据泄露,以下为核心安全建议与配置方法。
(一)核心部署安全建议
- 避免在主工作电脑上部署,推荐使用专用服务器、虚拟机或WSL2子系统,实现环境隔离;
- 阿里云部署时,不要将安全组来源设置为
0.0.0.0/0,稳定运行后改为指定IP,仅允许自己的设备访问; - 禁用不必要的危险功能,默认已禁用,可手动在配置文件中确认:
{ "security": { "enable_shell_commands": false, "enable_file_access": false } } - 启用沙箱模式,限制OpenClaw的操作范围:
{ "security": { "sandbox_mode": true } }
(二)权限与用户控制
- 限制渠道允许的用户,仅让自己的账号能触发机器人,以Telegram为例:
{ "channels": { "telegram": { "allowed_users": ["你的User ID"] } } } - 定期轮换API Key与各类渠道的Token,避免泄露后被恶意使用;
- 不要在公共代码仓库中提交
~/.openclaw/目录下的任何配置文件,防止敏感信息泄露。
(三)API Key安全管理
- 所有API Key均通过环境变量存储,不要手动写在配置文件中;
- 阿里云部署时,可通过阿里云密钥管理服务托管API Key,提升安全性;
- 若发现API Key泄露,立即在对应平台作废并生成新的Key,同时更新OpenClaw配置。
七、常见问题排查与解决方案
结合2026年OpenClaw最新版本特性与大量用户实操反馈,整理了部署与使用过程中最常见的问题,提供详细的排查步骤与解决方案,覆盖阿里云与本地部署场景。
(一)安装类问题
- 安装时提示Node.js版本过低:
```bashmacOS
brew install node@22
brew link --overwrite node@22
Ubuntu/Debian
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt-get install -y nodejs
CentOS
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo yum install -y nodejs
2. **一键安装脚本执行失败**:检查网络是否通畅,确保能访问GitHub,或直接采用手动安装方式。
### (二)配置类问题
1. **AI API连接测试失败**:检查API Key是否正确、自定义API地址是否支持对应路径(如OpenAI需支持`v1/responses`)、网络是否能访问对应模型平台;
2. **飞书机器人无响应**:确认飞书应用已发布上线、已添加核心权限、OpenClaw服务已启动、事件订阅选择了长连接模式;
3. **Telegram机器人无响应**:确认Bot Token与User ID正确、网络能访问Telegram(需代理)、User ID已添加至允许列表。
### (三)服务类问题
1. **OpenClaw服务无法启动**:执行`openclaw doctor`诊断配置问题,执行`openclaw logs`查看日志,定位具体错误;
2. **端口被占用**:更换网关端口,执行`openclaw gateway --port 18790`启动服务,同时更新防火墙/安全组规则;
3. **阿里云部署后无法远程访问**:检查安全组是否放行对应端口、服务器公网IP是否正确、OpenClaw服务是否正常运行。
### (四)更新与卸载
1. **更新OpenClaw至最新版本**:
```bash
# npm全局更新
npm update -g openclaw
# 或通过配置菜单更新
./config-menu.sh # 选择[7]高级设置→[7] 更新OpenClaw
- 完全卸载OpenClaw:
```bash停止服务
openclaw gateway stop
全局卸载程序
npm uninstall -g openclaw
删除配置与数据目录(可选)
rm -rf ~/.openclaw
```
八、总结
2026年的OpenClaw已实现高度的自动化与易用性,通过阿里云部署可实现7×24小时稳定运行的远程私人AI助手,通过本地部署可实现零成本的隐私化AI自动化,二者的核心部署流程一致,仅环境准备与端口配置略有差异。其多模型适配特性让用户可根据需求自由选择云端或本地模型,多渠道对接特性实现了在常用通讯工具中直接调用AI能力,真正做到了“随时随地,指令即执行”。
本文提供的所有步骤均经过实测验证,代码命令可直接复制执行,从环境准备、一键安装到多模型配置、多渠道对接,再到安全配置与问题排查,形成了完整的闭环教程。对于新手而言,推荐使用桌面版OpenClaw Manager图形界面,降低操作门槛;对于有一定技术基础的用户,命令行部署更灵活,可实现更多高级配置。
在使用过程中,建议遵循安全配置原则,做好环境隔离与权限控制,定期备份配置与数据,同时关注OpenClaw官方更新,及时升级版本以获得更多新功能与bug修复。随着OpenClaw社区的持续发展,其技能系统与模型适配能力将不断完善,未来将成为个人与小型团队提升工作效率的核心AI工具,真正实现“私人AI助手”的全场景落地。