在ubuntu22上全流程安装openclaw详细教程

喜讯：国内、香港、海外云服务器租用特惠活动，2核/4G/10M仅需31元每月，点击抢购>>>

在 Ubuntu 22.04 上部署 OpenClaw 主要分为四个阶段：环境准备、安装本体、向导配置和守护进程设置。

整个过程在命令行完成，按顺序操作即可。

📋 第一步：环境准备

OpenClaw 需要 Node.js 环境，版本必须为 v22 或更高。

1. 更新系统并安装必要工具

   bash

   sudo apt update && sudo apt upgrade -y
   sudo apt install -y curl git

2. 安装 Node.js 22
   使用 NodeSource 仓库安装官方版本，避免使用系统自带或 nvm 管理，以防止权限或路径问题 。

   bash

   # 下载并运行 Node.js 22 安装脚本
   curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
   # 安装 Node.js
   sudo apt install -y nodejs

3. 验证安装
   执行以下命令，确认返回的版本号均正确。

   bash

   node -v  # 应显示 v22.x.x 或更高
   npm -v   # 应显示对应的 npm 版本号

🚀 第二步：安装 OpenClaw

环境就绪后，通过 npm 全局安装 OpenClaw 命令行工具。

npm install -g openclaw@latest

⚙️ 第三步：运行配置向导

安装完成后，需要运行初始化向导，这是让 OpenClaw “活起来”的关键一步。

openclaw onboard --install-daemon

向导会以交互式菜单询问一系列问题，以下是主流推荐选项 ：

🔧 第四步：配置守护进程（systemd）

为了确保 OpenClaw 在后台持续运行，并在服务器重启后自动启动，需要将其配置为系统服务。

1. 创建 systemd 服务文件
   新建并编辑服务配置文件 /etc/systemd/system/openclaw.service。

   bash

   sudo nano /etc/systemd/system/openclaw.service

2. 写入以下配置
   这是基础的安全配置，将服务限制在普通用户权限下运行 。请务必将 User 和 Group 后面的 ubuntu 替换为你当前登录的用户名。

   ini

   [Unit]
   Description=OpenClaw Gateway
   After=network.target
   
   [Service]
   Type=simple
   User=ubuntu
   Group=ubuntu
   WorkingDirectory=/home/ubuntu
   Environment="PATH=/usr/bin:/usr/local/bin"
   ExecStart=/usr/bin/openclaw gateway --port 18789
   Restart=always
   RestartSec=10
   
   [Install]
   WantedBy=multi-user.target

3. 启用并启动服务

   bash

   # 重新加载 systemd 配置
   sudo systemctl daemon-reload
   # 设置开机自启
   sudo systemctl enable openclaw.service
   # 立即启动服务
   sudo systemctl start openclaw.service

✅ 第五步：验证与访问

1. 检查服务状态

   bash

   sudo systemctl status openclaw.service

   如果看到 active (running) 字样，说明服务已成功运行。

2. 访问 Web 管理界面
   在本地浏览器中访问 http://你的服务器IP:18789。首次登录需要输入 Token，可以通过以下命令获取：

   bash

   cat ~/.openclaw/openclaw.json | grep token

⚠️ 注意事项

• 防火墙：请确保云服务商的安全组和服务器防火墙已放行 18789 端口。

• 安全警告：Web 界面包含管理功能，切勿将其直接暴露在公网。建议通过 SSH 隧道或 VPN 访问 。

• 模型费用：调用 OpenAI、Anthropic 等云端大模型 API 会产生费用，请注意用量和 API Key 安全。