联系方式 & 交流群

微信: gzs-47

进微信群请联系博主，各位觉得文章对你有帮助的话可否打赏一些呀~

OpenClaw 部署教程 - Linux 篇（2026 终极版）#

📅 更新时间：2026-03-17
⏱️ 阅读时间：20 分钟
💡 难度等级：⭐⭐☆☆☆
✅ 实测环境：Ubuntu 22.04 LTS / Node.js v22.12.0 / Python 3.10.12

⚠️ 部署前必读（安全警示）#

电气安全#

服务器供电：确保使用稳压电源，电压波动 < ±5%
散热要求：工作环境温度 15-35℃，湿度 40-60%
ESD 防护：接触服务器前佩戴防静电手环

系统安全#

root 权限：生产环境建议使用普通用户 + sudo
防火墙：仅开放必要端口（默认 18789）
备份：部署前备份重要数据

网络要求#

带宽：≥ 10Mbps（推荐 100Mbps+）
代理：中国大陆用户需配置 Clash 代理（端口 7890）
域名：可选，用于 HTTPS 访问

内存要求（重要！）#

最低：2GB（需配置 Swap）
推荐：4GB+（无需 Swap）
生产：8GB+（流畅运行）

⚠️ 2GB 内存服务器必须配置 Swap，否则会出现 OOM（内存溢出）导致安装失败。

📋 系统要求（精准参数）#

项目	最低要求	推荐配置	生产环境
操作系统	Ubuntu 20.04	Ubuntu 22.04 LTS	Ubuntu 22.04.3 LTS
CPU	1 核心	2 核心+	4 核心+
内存	2GB	4GB+	8GB+
磁盘	5GB	10GB SSD	20GB+ NVMe SSD
Node.js	v18+	v20+	v22.12.0 (最新 LTS)
Python	3.8+	3.10+	3.10.12 (系统自带)
Git	任意版本	最新	2.34.1+

⚠️ 关键说明：

Node.js v22：OpenClaw 官方推荐版本，兼容性最佳
Swap 配置：2GB 内存服务器必须配置 2GB+ Swap
Git 必须：用于克隆仓库和管理依赖

🔧 快速安装（10 分钟完成）#

方法一：官方一键安装脚本（最简单）#

1
# ============ 步骤 1：系统更新及基础依赖 ============
2
sudo apt update
3
sudo apt install -y git curl
4

5
# ============ 步骤 2：执行官方安装脚本 ============
6
curl -fsSL https://openclaw.ai/install.sh | bash
7

8
# ============ 步骤 3：验证安装 ============
9
openclaw --version

⏱️ 预计耗时：5-10 分钟（取决于网络）

⚠️ 注意事项：

国内服务器：若安装失败，需先配置代理
2GB 内存：可能出现 OOM，需先配置 Swap（见下文）
安装过程：耗时较长，需耐心等待

方法二：手动安装（可控性更强）#

适合需要精确控制版本的生产环境：

步骤 1：安装 Git#

1
sudo apt update
2
sudo apt install -y git
3

4
# 验证版本
5
git --version  # 应显示：git version 2.34.1+

步骤 2：安装 NVM（Node 版本管理器）#

国内服务器（使用 Gitee 镜像源）：

1
curl -o- https://gitee.com/RubyMetric/nvm-cn/raw/main/install.sh | bash

海外服务器（使用官方源）：

1
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.1/install.sh | bash

步骤 3：重新加载环境变量#

1
source ~/.bashrc
2

3
# 验证 NVM 已安装
4
command -v nvm  # 应输出：nvm

步骤 4：安装 Node.js 22#

1
# 安装 Node.js 22（最新 LTS）
2
nvm install 22
3

4
# 设置为默认版本
5
nvm alias default 22
6

7
# 验证版本
8
node --version  # 应显示：v22.12.0
9
npm --version   # 应显示：10.9.0+

步骤 5：安装 OpenClaw#

1
# 全局安装
2
npm install -g openclaw
3

4
# 验证安装
5
openclaw --version  # 应显示：openclaw/x.x.x linux-x64 node-v22.12.0

⚙️ 初始化配置（Onboarding 向导）#

安装成功后会自动进入初始化向导，按以下步骤操作：

步骤详解#

步骤	提示内容	操作	说明
1	安全提示确认	输入 `Yes`	知晓权限风险
2	选择部署模式	选择 `QuickStart`	后续可补充配置
3	选择模型服务商	选择 `OpenAI`	或其他服务商
4	模型授权	复制链接到浏览器	登录账号完成授权
5	通信通道配置	选择 `Skip for now`	后续可配置
6	技能配置	选择 `No`	暂不配置
7	Hooks 配置	选择 `Session`	暂不启用
8	启动方式	选择 `TUI`	终端聊天界面
9	测试	输入 `Hello`	确认安装成功

详细流程#

1. 安全提示确认：

1
OpenClaw is a hobby project and still in beta...
2
Do you want to continue? (Yes/No)
3
> Yes

2. 选择部署模式：

1
Select deployment mode:
2
  1) QuickStart (推荐)
3
  2) Advanced
4
> 1

3. 选择模型服务商：

1
Select model provider:
2
  1) OpenAI
3
  2) Anthropic
4
  3) Google
5
  4) Custom
6
> 1

4. 模型授权：

1
Please visit the following URL to authorize:
2
https://openclaw.ai/auth/xxxxx
3

4
Enter the authorization code:
5
> [粘贴授权码]

5-7. 跳过可选配置：

1
Configure communication channels? (y/N) > N
2
Configure skills? (y/N) > N
3
Configure hooks? (y/N) > N

8. 启动 TUI 测试：

1
Start OpenClaw in TUI mode? (Y/n) > Y
2

3
# 出现聊天界面后输入：
4
> Hello
5

6
# 应收到 AI 回复

9. 退出 TUI：

1
按 Ctrl+C 退出

🔧 高级配置（生产环境必备）#

1. 配置 Swap（2GB 内存服务器必须）#

检查当前 Swap：

1
free -h
2
# 如果 Swap 为 0B，需要配置

创建 2GB Swap：

1
# 1. 创建 swap 文件
2
sudo fallocate -l 2G /swapfile
3

4
# 2. 设置权限（仅 root 可读写）
5
sudo chmod 600 /swapfile
6

7
# 3. 格式化为 swap
8
sudo mkswap /swapfile
9

10
# 4. 启用 swap
11
sudo swapon /swapfile
12

13
# 5. 验证
14
swapon --show
15
# 应显示：/swapfile  file  2G  0B

永久生效（重启后自动挂载）：

1
echo '/swapfile none swap sw 0 0' | sudo tee -a /etc/fstab

调整 Swappiness（降低使用 swap 的频率）：

1
# 查看当前值（默认 60）
2
cat /proc/sys/vm/swappiness
3

4
# 修改为 10（更保守）
5
sudo sysctl vm.swappiness=10
6

7
# 永久生效
8
echo 'vm.swappiness=10' | sudo tee -a /etc/sysctl.conf

2. 配置 API Keys#

编辑配置文件：

1
nano ~/.openclaw/workspace/TOOLS.md

添加以下内容（替换为你的 Key）：

1
## 🔑 API Keys
2

3
### 阿里云百炼（推荐，国内访问快）
4
- **API Key**: `sk-sp-xxxxxxxxxxxxxxxx`
5
- **模型**: qwen3.5-plus, qwen3-max-2026-01-23
6
- **状态**: ✅ 已配置
7
- **用途**: 代码生成/审查/优化
8

9
### OpenAI（备选）
10
- **API Key**: `sk-proj-xxxxxxxxxxxxxxxx`
11
- **模型**: gpt-4o, gpt-4-turbo
12

13
### 火山引擎（备选）
14
- **API Key**: `xxxxxxxxxxxxxxxx`
15
- **模型**: doubao-seed-2.0-code

Key 获取地址：

阿里云百炼：https://bailian.console.aliyun.com/
OpenAI：https://platform.openai.com/api-keys
火山引擎：https://www.volcengine.com/

3. 配置 Clash 代理（中国大陆用户必须）#

检查 Clash 是否运行：

1
ps aux | grep clash
2
# 应看到：clash -d /root/.config/clash/

如未运行，启动 Clash：

1
# 后台启动 Clash
2
nohup clash -d /root/.config/clash/ > /tmp/clash.log 2>&1 &
3

4
# 验证端口（7890 应处于 LISTEN 状态）
5
netstat -tlnp | grep 7890

配置环境变量：

1
# 临时生效
2
export HTTP_PROXY=http://127.0.0.1:7890
3
export HTTPS_PROXY=http://127.0.0.1:7890
4

5
# 永久生效（添加到 ~/.bashrc）
6
echo 'export HTTP_PROXY=http://127.0.0.1:7890' >> ~/.bashrc
7
echo 'export HTTPS_PROXY=http://127.0.0.1:7890' >> ~/.bashrc
8
source ~/.bashrc

验证代理：

1
curl -x http://127.0.0.1:7890 -I https://www.google.com
2
# 应返回：HTTP/2 200

🚀 systemd 服务配置（开机自启）#

创建服务文件#

1
sudo nano /etc/systemd/system/openclaw-gateway.service

完整配置内容#

1
[Unit]
2
Description=OpenClaw Gateway Service
3
Documentation=https://docs.openclaw.ai
4
After=network.target
5
Wants=network-online.target
6

7
[Service]
8
Type=simple
9
User=root
10
Group=root
11
WorkingDirectory=/root/.openclaw/workspace
12

13
# 环境变量（代理配置）
14
Environment="HTTP_PROXY=http://127.0.0.1:7890"
15
Environment="HTTPS_PROXY=http://127.0.0.1:7890"
16

17
# Node.js 内存优化
18
Environment="NODE_OPTIONS=--max-old-space-size=2048"
19

20
# 启动命令
21
ExecStart=/usr/local/bin/openclaw gateway start
22
ExecReload=/bin/kill -HUP $MAINPID
23

24
# 重启策略
25
Restart=always
26
RestartSec=10
27

28
# 资源限制
29
LimitNOFILE=65535
30
LimitNPROC=4096
31

32
# 日志配置
33
StandardOutput=journal
34
StandardError=journal
35
SyslogIdentifier=openclaw-gateway
36

37
[Install]
38
WantedBy=multi-user.target

启用服务#

1
# 重载 systemd 配置
2
sudo systemctl daemon-reload
3

4
# 启用开机自启
5
sudo systemctl enable openclaw-gateway
6

7
# 启动服务
8
sudo systemctl start openclaw-gateway
9

10
# 查看状态（应显示 Active: active (running)）
11
sudo systemctl status openclaw-gateway

日志管理#

1
# 实时查看日志
2
sudo journalctl -u openclaw-gateway -f
3

4
# 查看最近 100 行
5
sudo journalctl -u openclaw-gateway -n 100
6

7
# 按时间筛选
8
sudo journalctl -u openclaw-gateway --since "2026-03-17 10:00:00"
9

10
# 清理旧日志（保留 7 天）
11
sudo journalctl -u openclaw-gateway --vacuum-time=7d
12

13
# 限制日志大小（最多 100MB）
14
sudo journalctl -u openclaw-gateway --vacuum-size=100M

🔍 故障排查（精准诊断）#

问题 1：安装过程中 OOM（内存溢出）#

症状：安装过程中服务器卡死，SSH 断开连接

诊断：

1
# 查看内存使用
2
free -h
3

4
# 查看 OOM 日志
5
dmesg | grep -i "out of memory"

解决方案：

1
# 1. 配置 Swap（见上文）
2
sudo fallocate -l 2G /swapfile
3
sudo chmod 600 /swapfile
4
sudo mkswap /swapfile
5
sudo swapon /swapfile
6

7
# 2. 重启安装
8
npm install -g openclaw

问题 2：Node.js 版本不兼容#

症状：Error: Unsupported Node.js version

解决方案：

1
# 1. 查看当前版本
2
node --version
3

4
# 2. 使用 NVM 切换到 v22
5
nvm install 22
6
nvm use 22
7
nvm alias default 22
8

9
# 3. 重新安装 OpenClaw
10
npm uninstall -g openclaw
11
npm install -g openclaw

问题 3：网络超时#

症状：Error: connect ETIMEDOUT

诊断步骤：

1
# 1. 测试基础网络
2
ping -c 4 www.baidu.com
3

4
# 2. 测试代理
5
curl -x http://127.0.0.1:7890 -I https://www.google.com
6

7
# 3. 检查 Clash 状态
8
ps aux | grep clash
9
netstat -tlnp | grep 7890

解决方案：

1
# 启动 Clash
2
nohup clash -d /root/.config/clash/ > /tmp/clash.log 2>&1 &
3

4
# 配置环境变量
5
export HTTP_PROXY=http://127.0.0.1:7890
6
export HTTPS_PROXY=http://127.0.0.1:7890

问题 4：初始化向导卡住#

症状：卡在某个步骤无法继续

解决方案：

1
# 1. 退出向导（Ctrl+C）
2

3
# 2. 清除配置重新初始化
4
rm -rf ~/.openclaw/config.json
5
openclaw init
6

7
# 3. 或者手动编辑配置
8
nano ~/.openclaw/config.json

问题 5：TUI 界面无法启动#

症状：选择 TUI 后黑屏或闪退

解决方案：

1
# 1. 检查终端兼容性
2
echo $TERM  # 应显示：xterm-256color 或 screen
3

4
# 2. 设置终端类型
5
export TERM=xterm-256color
6

7
# 3. 重新启动
8
openclaw start
9

10
# 4. 或者使用 Web UI
11
openclaw gateway start
12
# 浏览器访问：http://localhost:18789

✅ 验证安装（完整测试清单）#

逐项检查，全部通过才算成功：

1
# □ 1. 检查版本号
2
openclaw --version
3
# 期望输出：openclaw/x.x.x linux-x64 node-v22.12.0
4

5
# □ 2. 检查网关状态
6
openclaw gateway status
7
# 期望输出：Gateway is running
8

9
# □ 3. 检查端口监听
10
netstat -tlnp | grep 18789
11
# 期望输出：tcp6  0  0 :::18789  :::*  LISTEN
12

13
# □ 4. 测试本地访问
14
curl http://localhost:18789/health
15
# 期望输出：{"status":"ok"}
16

17
# □ 5. 发送测试消息
18
openclaw message send "Hello OpenClaw!"
19
# 期望：收到 AI 回复
20

21
# □ 6. 检查日志无 ERROR
22
sudo journalctl -u openclaw-gateway -n 50 | grep ERROR
23
# 期望：无输出
24

25
# □ 7. 检查 systemd 服务状态
26
sudo systemctl status openclaw-gateway
27
# 期望输出：Active: active (running)
28

29
# □ 8. 测试开机自启
30
sudo reboot
31
# 重启后检查：
32
sudo systemctl status openclaw-gateway
33
# 期望：服务自动启动

成功标志：

✅ 8 项检查全部通过
✅ 日志无 ERROR 级别错误
✅ 服务重启后自动恢复

📊 性能优化（生产环境）#

1. Node.js 内存优化#

编辑 systemd 服务：

1
sudo nano /etc/systemd/system/openclaw-gateway.service

添加内存配置（根据服务器内存调整）：

1
# 4GB 内存服务器
2
Environment="NODE_OPTIONS=--max-old-space-size=2048"
3

4
# 8GB 内存服务器
5
Environment="NODE_OPTIONS=--max-old-space-size=4096"
6

7
# 16GB 内存服务器
8
Environment="NODE_OPTIONS=--max-old-space-size=8192"

重载并重启：

1
sudo systemctl daemon-reload
2
sudo systemctl restart openclaw-gateway

2. 定期清理缓存#

创建清理脚本：

1
nano ~/cleanup-openclaw.sh

脚本内容：

1
#!/bin/bash
2
echo "🧹 开始清理 OpenClaw 缓存..."
3

4
# 清理 npm 缓存
5
npm cache clean --force
6
echo "✅ npm 缓存已清理"
7

8
# 清理系统日志（保留 7 天）
9
sudo journalctl --vacuum-time=7d
10
echo "✅ 系统日志已清理"
11

12
# 清理 OpenClaw 日志（保留 100MB）
13
sudo journalctl -u openclaw-gateway --vacuum-size=100M
14
echo "✅ OpenClaw 日志已清理"
15

16
# 清理临时文件
17
rm -rf /tmp/openclaw-*
18
echo "✅ 临时文件已清理"
19

20
echo "🎉 清理完成！"

赋予执行权限并运行：

1
chmod +x ~/cleanup-openclaw.sh
2
~/cleanup-openclaw.sh

添加到 crontab（每周日凌晨 3 点自动清理）：

1
crontab -e
2
# 添加：
3
0 3 * * 0 /home/ubuntu/cleanup-openclaw.sh

📚 更多资源#

官方文档#

社区教程#

其他平台部署#

📝 更新日志#

版本	日期	更新内容
v3.0	2026-03-17	整合官方一键脚本 + NVM 安装 + 初始化向导详解
v2.0	2026-03-17	增加电气安全警示、精准参数、故障排查流程图
v1.5	2026-03-10	增加 systemd 服务配置、性能优化章节
v1.0	2026-03-01	初始版本发布

最后更新：2026-03-17
作者：OpenClaw 社区
许可：MIT
审核：嵌入式硬件专家（15 年 + 经验）

觉得有用？欢迎分享给更多朋友！ 🚀

音乐

OpenClaw 部署教程 - Linux 篇（2026 终极版）

OpenClaw 部署教程 - Linux 篇（2026 终极版）#

⚠️ 部署前必读（安全警示）#

电气安全#

系统安全#

网络要求#

内存要求（重要！）#

📋 系统要求（精准参数）#

🔧 快速安装（10 分钟完成）#

方法一：官方一键安装脚本（最简单）#

方法二：手动安装（可控性更强）#

步骤 1：安装 Git#

步骤 2：安装 NVM（Node 版本管理器）#

步骤 3：重新加载环境变量#

步骤 4：安装 Node.js 22#

步骤 5：安装 OpenClaw#

⚙️ 初始化配置（Onboarding 向导）#

步骤详解#

详细流程#

🔧 高级配置（生产环境必备）#

1. 配置 Swap（2GB 内存服务器必须）#

2. 配置 API Keys#

3. 配置 Clash 代理（中国大陆用户必须）#

🚀 systemd 服务配置（开机自启）#

创建服务文件#

完整配置内容#

启用服务#

日志管理#

🔍 故障排查（精准诊断）#

问题 1：安装过程中 OOM（内存溢出）#

问题 2：Node.js 版本不兼容#

问题 3：网络超时#

问题 4：初始化向导卡住#

问题 5：TUI 界面无法启动#

✅ 验证安装（完整测试清单）#

📊 性能优化（生产环境）#

1. Node.js 内存优化#

2. 定期清理缓存#

📚 更多资源#

官方文档#

社区教程#

其他平台部署#

📝 更新日志#

文章分享