Linux 安装方法 2（APT）：直接安装（不推荐）
推荐等级说明
| 安装方式 | 推荐等级 | 隔离性 | 资源占用 | 适用场景 |
|---|---|---|---|---|
| Docker | ⭐⭐⭐⭐⭐ 推荐 | 优秀 | 低 | 大多数用户的首选 |
| 直接安装 (APT) | ⭐⭐ 不推荐 | 无 | 最低 | 仅限无敏感数据的专用服务器 |
| 直接安装 (YUM) | ⭐⭐ 不推荐 | 无 | 最低 | 仅限无敏感数据的专用服务器 |
重要提示
不推荐在包含以下内容的计算机上使用此安装方式：
- 工作相关资料：会计财务数据、商业机密、商用资料、客户信息
- 个人隐私内容：个人照片、文档、聊天记录、密码文件
- 敏感开发项目：私有代码仓库、API 密钥、配置文件
- 任何你不希望暴露的数据
原因：直接安装会将 OpenClaw 运行在主机系统上，如果 OpenClaw 或其依赖存在安全漏洞，可能影响系统上的所有数据。
适用场景：
- ✅ 专用于 OpenClaw 的独立服务器
- ✅ 临时测试环境（无敏感数据）
- ✅ 虚拟机快照环境（可随时回滚）
- ❌ 日常使用的个人电脑
- ❌ 包含任何工作或隐私数据的生产服务器
强烈建议使用 Docker 安装方式 以获得更好的隔离性和安全性。
这是传统的 Linux 安装方式，直接在主机系统上安装和运行 OpenClaw。本文档适用于 基于 APT 的发行版（Debian、Ubuntu、Linux Mint 等）。
确认你的系统类型
在开始之前，请确认你的系统使用的是 APT 包管理器：
which apt如果输出 /usr/bin/apt，说明你的系统使用 APT，可以继续本文档。
如果输出为空或你使用的是 CentOS、Fedora、RHEL 等系统，请参考 Linux 安装方法 2（YUM）：直接安装。
前置条件
- Debian 11 (Bullseye) 或更高版本
- Ubuntu 20.04 LTS 或更高版本（推荐 Ubuntu 24.04 LTS）
- Linux Mint 20 或更高版本
- 至少 2GB 可用内存
- 至少 10GB 可用磁盘空间
- root 权限或 sudo 权限
遇到任何安装失败，请直接看文末的 失败指引。
步骤 1：配置加速源
因为默认是访问国外的网络，加速源是国内大厂做的中转，会快十倍甚至更多
source /etc/os-release
echo "deb https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ ${VERSION_CODENAME} main restricted universe multiverse" | sudo tee /etc/apt/sources.list > /dev/null
echo "deb https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ ${VERSION_CODENAME}-updates main restricted universe multiverse" | sudo tee -a /etc/apt/sources.list > /dev/null
echo "deb https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ ${VERSION_CODENAME}-backports main restricted universe multiverse" | sudo tee -a /etc/apt/sources.list > /dev/null
echo "deb https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ ${VERSION_CODENAME}-security main restricted universe multiverse" | sudo tee -a /etc/apt/sources.list > /dev/nullapt modernize-sources这里会很久，这跟linux的发行方式和更新方式有关，建议耐心等待
sudo apt update && sudo apt upgrade -y步骤 2：安装 curl（必做）
很多刚装好的 Linux 默认没有 curl，而安装脚本需要用到它：
sudo apt update
sudo apt install -y curl说明：OpenClaw 官方安装脚本会在需要时自动准备 Node 环境，你不必手动安装或管理 Node。
步骤 4：安装 龙虾
curl -fsSL https://openclaw.ai/install.sh | bash安装脚本会自动：
- 下载最新版本的 OpenClaw
- 完成安装并让
openclaw命令可用（实际位置用which openclaw查看）
重新加载 shell 使 PATH 生效：
source ~/.bashrc验证安装：
which openclaw
openclaw --version步骤 5：启用 systemd（可选但推荐）
OpenClaw 的后台服务需要 systemd。大多数现代 Linux 发行版默认已启用。
检查 systemd 是否可用：
systemctl --version如果显示版本信息，说明 systemd 已启用。
如果 systemd 不可用（如某些容器环境），你只能以前台方式运行 OpenClaw。
步骤 6：运行新手引导
如果你是通过 curl -fsSL https://openclaw.ai/install.sh | bash 安装的，安装流程通常会在最后直接进入一次 onboard 的快速设置。
只有在你当时跳过了/中途退出了向导时，才需要手动执行：
openclaw onboard建议先参考我们的 快速设置 提前准备好大模型 API Key，并优先完成 API Key 这一项，其它配置后面再补。
新手引导会配置：
- 认证（API Key、OAuth 等）
- Gateway 网关设置
- 可选的消息渠道
- 后台服务
步骤 7：验证安装
# 检查 Gateway 状态
openclaw status
# 打开 Control UI
openclaw dashboard如果 Control UI 能加载（http://127.0.0.1:18789/），你的 Gateway 网关就已准备就绪。
PATH 诊断与修复
如果你遇到 openclaw: command not found，按顺序执行下面命令快速定位：
node -v
npm -v
npm prefix -g
echo "$PATH"如果 $(npm prefix -g)/bin 不在你的 $PATH 中，shell 就找不到全局 npm 二进制文件（包括 openclaw）。
修复方式：把下面这一行加入你的 shell 启动文件（~/.bashrc 或 ~/.zshrc），然后重新打开终端：
export PATH="$(npm prefix -g)/bin:$PATH"常用命令
# 诊断问题
openclaw doctor
# 查看 Gateway 状态
openclaw status
# 打开浏览器 UI
openclaw dashboard
# 重新配置
openclaw configure如需临时以前台方式运行 Gateway（用于调试/改端口），再使用：
openclaw gateway --port 18789后台服务管理
OpenClaw 使用 systemd 用户服务管理后台进程：
# 启用 lingering（防止注销后服务停止）
sudo loginctl enable-linger $USER
# 查看服务状态
systemctl --user status openclaw-gateway
# 启动/停止/重启服务
systemctl --user start openclaw-gateway
systemctl --user stop openclaw-gateway
systemctl --user restart openclaw-gateway失败指引（折叠）
安装或运行失败时请展开
1. Node/命令环境问题
如果遇到 node: command not found 或 openclaw: command not found，优先按本文的「PATH 诊断与修复」排查。
2. 龙虾 安装脚本失败
下载失败
# 手动下载安装脚本
curl -fsSL https://openclaw.ai/install.sh -o install.sh
bash install.sh权限问题
# 确保有执行权限
chmod +x install.sh
bash install.shPATH 未生效
# 检查 PATH
echo $PATH
# 手动添加（按 npm 全局前缀修复）
echo 'export PATH="$(npm prefix -g)/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc3. systemd 服务问题
服务未找到
# 检查服务文件
ls -la ~/.config/systemd/user/
# 重新运行 onboard（仅当你首次安装时跳过/中途退出过）
openclaw onboard服务无法启动
# 查看服务日志
journalctl --user -u openclaw-gateway -f
# 检查服务状态
systemctl --user status openclaw-gatewaylingering 未启用
# 启用 lingering
sudo loginctl enable-linger $USER
# 验证
ls /var/lib/systemd/linger4. 端口已被占用
错误：EADDRINUSE: address already in use
# 查看占用端口的进程
sudo lsof -i :18789
# 停止占用端口的进程
sudo kill <PID>
# 或使用其他端口
openclaw gateway --port 187905. 权限问题
无法写入配置文件
# 检查配置目录权限
ls -la ~/.openclaw
# 修复权限
chmod 700 ~/.openclaw
chown -R $USER:$USER ~/.openclaw6. Node 版本不兼容
错误：The engine "node" is incompatible
建议直接重新运行官方安装脚本（它会在需要时准备兼容的 Node 环境）：
curl -fsSL https://openclaw.ai/install.sh | bash7. 依赖安装失败
Python 或编译工具缺失
# 安装完整构建工具
sudo apt install -y build-essential python3 python3-pip
# 重新安装 龙虾
curl -fsSL https://openclaw.ai/install.sh | bash8. 内存不足
错误：JavaScript heap out of memory
# 增加 Node.js 内存限制
export NODE_OPTIONS="--max-old-space-size=4096"
# 或在运行时指定
NODE_OPTIONS="--max-old-space-size=4096" openclaw gateway9. 完全重置
警告：这会删除所有配置
# 停止服务
systemctl --user stop openclaw-gateway
# 备份配置（可选）
tar -czf openclaw-backup-$(date +%Y%m%d).tar.gz ~/.openclaw
# 删除配置
rm -rf ~/.openclaw
# 卸载 openclaw（如果是通过 npm 全局安装的）
npm uninstall -g openclaw || true
# 清理服务文件
rm -f ~/.config/systemd/user/openclaw-*.service
systemctl --user daemon-reload
# 重新安装
curl -fsSL https://openclaw.ai/install.sh | bash
source ~/.bashrc
# 如需重新做一次快速设置（仅当你跳过/中途退出过）
openclaw onboard10. 性能问题
CPU 占用过高
# 检查系统资源
top -p $(pgrep -f openclaw)
# 限制 CPU 使用（需要 cpulimit）
sudo apt install cpulimit
cpulimit -l 50 -p $(pgrep -f openclaw)内存占用过高
# 检查内存使用
ps aux | grep openclaw
# 限制内存（使用 systemd）
mkdir -p ~/.config/systemd/user/openclaw-gateway.service.d
cat > ~/.config/systemd/user/openclaw-gateway.service.d/limits.conf <<EOF
[Service]
MemoryMax=2G
EOF
systemctl --user daemon-reload
systemctl --user restart openclaw-gateway