OpenClaw + 华为云CVM/轻量服务器 一站式部署与配置完全指南
一、开篇:为什么选择华为云部署OpenClaw
OpenClaw(曾用名Clawdbot)是一款可本地部署、支持任务执行、具备记忆能力与插件扩展机制的AI智能体框架。用户可通过自然语言下达指令,由系统完成文件管理、信息检索、内容处理、流程自动化等实际操作。与纯云端AI助手不同,OpenClaw的数据可优先存储在本地,具备较好的可控性与隐私性。
将OpenClaw部署在华为云服务器上,相比本地部署具有显著优势:提供稳定公网访问能力,服务可持续7×24小时运行;可用镜像标准化部署,出问题可快速重置;独立部署环境,可按需调整实例规格,性能与成本更可控。
本文基于真实配置过程整理,所有命令均在华为云CloudShell + OpenClaw 2026.3.2版本实测有效。无论你是AI开发新手还是运维老手,跟随本文的步骤,都能在30分钟内完成从零到生产级AI助手的完整搭建。
需要先登录华为云控制台,点击:华为云控制台,还没有账号,点击:注册并关联,已有账号点击:登录后关联
二、华为云服务器选型:CVM弹性云服务器 vs Flexus轻量应用服务器
华为云提供两种适合部署OpenClaw的服务器产品:弹性云服务器(ECS/CVM)和Flexus应用服务器L实例(轻量服务器)。理解两者的区别,有助于选择最适合自己需求的方案。
2.1 弹性云服务器(ECS)
弹性云服务器提供多种计费模式(包年/包月、按需计费、竞价计费)、规格类型、镜像类型、磁盘类型,针对不同的业务场景可自定义配置。ECS适用于对CPU、内存、硬盘空间和带宽有特殊要求,需要灵活扩展的业务场景。入门型配置(1vCPUs | 2GiB)即可满足OpenClaw的基本运行需求。
2.2 Flexus应用服务器L实例(轻量服务器)
Flexus应用服务器L实例是新一代开箱即用、面向中小企业和开发者打造的全新轻量级应用服务器。它提供丰富严选的应用镜像,实现应用一键部署,适用于网站搭建、开发测试环境、企业应用等中低负载场景。轻量服务器按已搭配的套餐售卖,使用门槛低,适合云计算入门用户或需要在服务器中部署简单应用的个人开发者。
2.3 选型建议
对于OpenClaw部署,笔者推荐以下选型策略:
- 入门尝鲜:选择Flexus轻量服务器2核2G配置(华为云新用户常有限时优惠,如68元/年),性价比极高。
- 生产环境:选择ECS弹性云服务器2核4G及以上配置,提供更稳定的性能和灵活的资源扩展能力。
- 高并发场景:选择ECS 4核8G配置,配合Swap交换分区,确保OpenClaw在多任务并行时内存充足。
三、部署前的环境准备
3.1 服务器基础配置
在华为云控制台购买服务器时,建议遵循以下配置:
- 操作系统:Ubuntu 22.04 LTS或Debian 12(推荐)
- 实例规格:1核2GB内存及以上,系统盘40GB以上
- 安全组:放行18789端口(OpenClaw Web控制台默认端口)
- 登录方式:推荐使用华为云CloudShell(无需绑定弹性公网IP)
3.2 通过CloudShell登录服务器
华为云CloudShell是笔者强烈推荐的服务器管理方式,无需额外安装SSH工具,直接在浏览器中操作:
- 登录华为云管理控制台,选择“计算 > 弹性云服务器”
- 在服务器列表中找到目标实例,单击“操作”列下的“远程登录”
- 在弹出的窗口中,单击“使用CloudShell登录”
- 在CloudShell界面配置服务器信息后即可进入终端
3.3 安装Node.js 22+环境
OpenClaw的运行依赖Node.js 22.x及以上版本。推荐使用nvm(Node Version Manager)进行安装和管理:
# 安装nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
# 重新加载环境变量
source ~/.bashrc
# 安装Node.js 22 LTS
nvm install 22
nvm use 22
# 验证安装
node -v
npm -v
若输出版本号,说明环境可用;若提示未找到命令,需先检查网络或重新执行安装步骤。
3.4 创建专用用户(安全最佳实践)
OpenClaw能控制浏览器、执行shell命令、读写文件,用root账户运行等于把整个服务器交给了AI,存在严重安全风险。因此必须创建专用用户:
# 创建openclaw用户
sudo useradd -m -s /bin/bash openclaw
# 设置密码
sudo passwd openclaw
# 切换到openclaw用户
su - openclaw
切换后,需要在openclaw用户下重新安装nvm和Node.js(参考3.3节),确保所有OpenClaw相关文件都归属于该用户。
四、OpenClaw的三种安装方式
OpenClaw支持多种安装方式,读者可根据自身技术背景和需求选择最适合的一种。
4.1 方式一:npm全局安装(推荐新手)
这是最快捷的安装方式,一条命令即可完成:
# 全局安装OpenClaw
npm install -g openclaw
# 或使用国内镜像加速(推荐)
npm install -g openclaw-cn@latest
验证安装是否成功:
openclaw --version
应显示类似2026.2.22-2的版本号。
4.2 方式二:源码编译安装(适合深度定制)
OpenClaw推荐通过源码方式安装,便于后续二次开发和插件扩展:
# 克隆源码仓库
git clone https://github.com/openclaw/openclaw.git
# 进入项目目录
cd openclaw
# 安装pnpm包管理器(如未安装)
curl -fsSL https://get.pnpm.io/install.sh | sh
source ~/.bashrc
# 安装项目依赖
pnpm install
# 构建UI界面
pnpm ui:build
# 编译项目核心代码
pnpm build
编译完成后会生成dist目录。若后续提示`command not found: openclaw`,执行`pnpm link --global`将本地包链接到全局。
4.3 方式三:华为云一键部署(最快上手)
华为云解决方案实践提供了OpenClaw的一键部署模板:
- 登录华为云控制台,搜索“解决方案实践”
- 选择“快速部署OpenClaw”,单击“一键部署”
- 跳转至解决方案创建资源栈界面,按提示填写参数
- 单击“下一步”,确认配置后完成部署
这种方式适合完全零基础的用户,全程可视化操作,无需手动输入命令。
五、OpenClaw配置向导(onboard)详解
安装完成后,需要通过配置向导完成模型接入、渠道设置等核心配置。
5.1 启动配置向导
openclaw onboard --install-daemon
该命令会启动交互式配置流程,并自动安装守护进程(systemd),让OpenClaw后台常驻运行。整个过程大约需要2分钟。
5.2 配置步骤详解
按照以下固定选项填写即可一次性完成配置:
| 配置项 | 推荐选项 | 说明 |
|---|---|---|
| Install daemon? | yes | 安装systemd守护进程,实现开机自启 |
| Onboarding mode | QuickStart | 快速启动模式,适合初次部署 |
| Model/auth provider | Custom Provider | 自定义模型提供商,兼容OpenAI/Anthropic接口 |
| API Base URL | 根据模型服务填写 | 如Ollama本地:http://127.0.0.1:11434/v1 |
| API Key | 填写有效密钥 | Ollama可填任意字符串(如ollama),不可留空 |
| Endpoint compatibility | OpenAI-compatible | 选择OpenAI兼容模式 |
| Model ID | 模型名称 | 如qwen2.5:7b-32k或gpt-4 |
5.3 完成配置与Web UI访问
配置完成后,选择“Open the Web UI”,系统会自动打开OpenClaw Web管理界面。默认访问地址为:
http://服务器公网IP:18789
如果无法访问,请检查服务器安全组是否已放行18789端口。
六、大模型API接入配置
OpenClaw的核心能力依赖于大语言模型。本节介绍两种主流接入方式。
6.1 接入Ollama本地模型(免费、隐私优先)
Ollama是本地运行大模型的优秀工具,无需API费用,数据完全本地化。
6.1.1 安装Ollama
# 安装Ollama
curl -fsSL https://ollama.com/install.sh | sh
# 验证安装
ollama --version
6.1.2 下载并配置模型
OpenClaw默认要求模型上下文窗口至少16000 tokens,而基础模型可能只有4096,因此需要创建自定义模型。
# 拉取基础模型
ollama pull qwen2.5:7b
# 创建Modelfile(增加上下文窗口)
cat > Modelfile << 'EOF'
FROM qwen2.5:7b
PARAMETER num_ctx 32768
EOF
# 创建新模型
ollama create qwen2.5:7b-32k -f Modelfile
# 验证模型已创建
ollama list
在OpenClaw的onboard配置中,将API Base URL设为`http://127.0.0.1:11434/v1`,API Key填任意字符串,Model ID填`qwen2.5:7b-32k`。
6.2 接入云端大模型API
对于需要更强推理能力的场景,可接入云端大模型API。以OpenAI兼容接口为例,在`~/.openclaw/config.json`或通过onboard配置:
{
"model": {
"provider": "custom",
"baseUrl": "https://api.your-provider.com/v1",
"apiKey": "your-api-key-here",
"modelId": "gpt-4"
}
}
七、Systemd守护进程配置
为了让OpenClaw在服务器重启后自动启动,需要配置systemd服务。
7.1 创建服务文件
sudo nano /etc/systemd/system/openclaw.service
写入以下内容:
[Unit]
Description=OpenClaw AI Agent Service
After=network.target
[Service]
Type=simple
User=openclaw
WorkingDirectory=/home/openclaw
Environment="NODE_OPTIONS=--max-old-space-size=1280"
ExecStart=/home/openclaw/.local/bin/openclaw gateway --port 18789
Restart=always
RestartSec=10
[Install]
WantedBy=multi-user.target
注意:如果使用nvm安装的Node.js,ExecStart路径可能需要调整为nvm的bin目录。
7.2 启用并启动服务
# 重新加载systemd配置
sudo systemctl daemon-reload
# 启用开机自启
sudo systemctl enable openclaw
# 启动服务
sudo systemctl start openclaw
# 查看服务状态
sudo systemctl status openclaw
如果出现`status=127(command not found)`错误,说明ExecStart中的路径不正确,请使用`which openclaw`确认实际路径。
八、安全组配置与网络访问
安全组是华为云的网络访问控制机制,正确配置安全组规则是OpenClaw可访问的关键。
8.1 放行OpenClaw端口
- 登录华为云控制台,选择“计算 > 弹性云服务器”
- 在服务器列表中找到目标实例,单击服务器名称
- 选择“安全组”页签
- 单击“配置规则”,添加一条入方向规则
- 协议端口:TCP 18789
- 源地址:建议设置为特定IP段(如您的办公网络IP),而非0.0.0.0/0,以降低安全风险
8.2 常用端口参考
| 端口 | 用途 | 建议 |
|---|---|---|
| 22 | SSH远程连接 | 仅限管理IP访问 |
| 18789 | OpenClaw Web控制台 | 根据需求开放 |
| 80/443 | HTTP/HTTPS(如需绑定域名) | 按需开放 |
九、性能优化与故障排查
9.1 内存优化:配置Swap交换分区
2GB内存的轻量服务器运行OpenClaw + 大模型时,启动峰值可能轻松突破1.5GB,容易触发`JavaScript heap out of memory`错误。解决方法:
# 创建2GB Swap文件
sudo fallocate -l 2G /swapfile
sudo chmod 600 /swapfile
sudo mkswap /swapfile
sudo swapon /swapfile
# 设置swappiness(降低Swap使用倾向)
echo 10 | sudo tee /proc/sys/vm/swappiness
# 永久生效
echo '/swapfile none swap sw 0 0' | sudo tee -a /etc/fstab
echo 'vm.swappiness=10' | sudo tee -a /etc/sysctl.conf
9.2 常见错误与解决方案
错误1:openclaw: command not found
原因:npm全局安装的bin目录未加入PATH,或使用nvm安装Node.js后环境变量未生效。
解决:
# 确认安装位置
npm root -g
# 将npm全局bin加入PATH
export PATH="$(npm root -g)/bin:$PATH"
# 或重新加载nvm环境
source ~/.nvm/nvm.sh
nvm use 22
错误2:EACCES permission denied
原因:文件权限不正确,通常是因为使用root用户安装了OpenClaw,但用普通用户运行。
解决:
sudo chown -R openclaw:openclaw /home/openclaw/.openclaw
sudo chmod -R 755 /home/openclaw/.openclaw
错误3:端口被占用
原因:18789端口被其他进程占用。
解决:
# 查找占用端口的进程
lsof -i :18789
# 强制终止
kill -9 [PID]
错误4:Git残留导致升级失败
原因:~/.openclaw目录中残留了.git文件夹和缓存。
解决:
# 清理Git残留
cd ~/.openclaw
git clean -fdx
# 如无效,彻底重装
rm -rf ~/.openclaw
npm install -g openclaw
9.3 日志查看与调试
# 查看OpenClaw服务日志
sudo journalctl -u openclaw -f
# 查看最近100行日志
sudo journalctl -u openclaw -n 100
# 降低日志级别(减少输出)
# 在服务文件中添加环境变量
Environment="LOG_LEVEL=warn"
十、Skills技能扩展
OpenClaw支持通过Skills扩展功能,实现浏览器自动化、文件操作、网络搜索等任务。华为云码道AI IDE支持自建Skill。
10.1 安装官方Skills
# 安装浏览器自动化Skill
openclaw skill install browser-automation
# 安装网络搜索Skill
openclaw skill install web-search
# 查看已安装Skills
openclaw skill list
10.2 创建自定义Skill
在`~/.openclaw/skills/`目录下创建自定义Skill文件夹,包含`manifest.json`和实现代码即可。华为云码道AI IDE提供了可视化的Skill创建界面,降低了开发门槛。
十一、总结与最佳实践
本文完整梳理了在华为云CVM弹性云服务器与Flexus轻量服务器上部署OpenClaw的全流程。总结以下最佳实践供读者参考:
- 安全第一:始终使用专用非root用户运行OpenClaw,避免权限过度开放
- 内存管理:2GB内存实例务必配置Swap交换分区,并通过`NODE_OPTIONS="--max-old-space-size=1280"`限制Node.js堆内存
- 端口管控:安全组规则遵循最小权限原则,仅开放必要的端口和IP
- 定期更新:关注OpenClaw官方发布,及时升级以获取新功能和安全修复
- 数据备份:定期备份`~/.openclaw`目录,防止配置丢失
部署完成后,你就拥有了一个7×24小时运行的云端AI私人管家——它可以自动打开后台、写文章、发稿子、管理网站,你只需要说一句话。你的自动化之旅,从现在开始。
常见问题问答
问1:OpenClaw部署在华为云轻量服务器上最低需要什么配置?
答:最低配置为1核2GB内存、40GB系统盘。推荐2核2GB配置(华为云新用户常有限时优惠),并务必配置2GB Swap交换分区以应对内存峰值。
问2:OpenClaw的Web控制台默认端口是多少?如何修改?
答:默认端口为18789。修改方式:在启动命令中指定`--port`参数,如`openclaw gateway --port 19037`;或在systemd服务文件中修改ExecStart中的端口号。
问3:为什么我的OpenClaw启动后报"JavaScript heap out of memory"?
答:这是因为Node.js默认堆内存限制(约1.4GB)小于OpenClaw运行所需内存。解决方法:在启动命令前添加`NODE_OPTIONS="--max-old-space-size=1280"`限制堆内存上限,或升级服务器内存配置。
问4:OpenClaw支持哪些大模型?
答:OpenClaw支持所有OpenAI兼容接口的模型,包括Ollama本地模型(Qwen2.5、Llama等)、OpenAI GPT系列、Anthropic Claude系列、以及国内各大模型平台的API。
问5:如何让OpenClaw在服务器重启后自动启动?
答:配置systemd守护进程即可。创建`/etc/systemd/system/openclaw.service`服务文件,执行`sudo systemctl enable openclaw`启用开机自启,`sudo systemctl start openclaw`立即启动。
问6:OpenClaw的配置文件和日志存放在哪里?
答:配置文件默认存放在`~/.openclaw/config.json`或`~/.openclaw/openclaw.json`。日志可通过`journalctl -u openclaw -f`查看(systemd方式),或查看`~/.openclaw/logs/`目录下的日志文件。



