⚠️ 重要前置提醒：OpenClaw 最低要求 Node ≥ 22.22.3，不要使用 v22.14.0！本教程已修正为 node-v22.22.3

✅ 适配：Ubuntu 20.04 (Focal)｜内置 Workboard 任务看板｜国内镜像直连｜全程逐行复制粘贴

💡 小提示：输入 sudo 密码时屏幕不显示字符，正常；Ctrl+C 终止卡住的命令

第 0 步：基础依赖（先跑）

sudo apt update && sudo apt upgrade -y
sudo apt install -y build-essential curl git python3 libssl-dev pkg-config

第 1 步：国内镜像下载 Node v22.22.3（amd64）

cd ~
wget https://npmmirror.com/mirrors/node/v22.22.3/node-v22.22.3-linux-x64.tar.xz

wget 超时备用 curl 版本：

curl -L https://npmmirror.com/mirrors/node/v22.22.3/node-v22.22.3-linux-x64.tar.xz -o node-v22.22.3-linux-x64.tar.xz

第 2 步：解压 + 部署到系统

tar -xf node-v22.22.3-linux-x64.tar.xz
sudo mv node-v22.22.3-linux-x64 /usr/local/node22

第 3 步：写入环境变量（永久生效）

echo 'export PATH=/usr/local/node22/bin:$PATH' >> ~/.bashrc
source ~/.bashrc

第 4 步：验证 node & npm（必须输出 v22.22.3）

node -v
npm -v

✅ 输出 v22.22.3 才算达标！

第 5 步：npm 国内镜像（必做，防止安装超时）

npm config set registry https://registry.npmmirror.com

第 6 步：npm 全局安装 OpenClaw（绕开难连接的在线 install 脚本）

npm install -g openclaw

第 7 步：验证 OpenClaw

openclaw --version

提示 command not found 就执行：

source ~/.bashrc

第 8 步：初始化 + 生成 workspace 工作区

openclaw onboard --install-daemon

👉 向导选项（上下方向键选择、回车确认）

1. 安装 systemd 网关 → yes
2. QuickStart 快速配置 → 选 QuickStart
3. 模型自选（小白优先 Ollama 本地模型，免费无需 API）
4. Discord/Telegram 机器人通道 → 直接跳过
5. 确认生成默认工作区 ~/.openclaw/workspace

✅ 第 9 步：启用 Workboard 工作看板（核心！你要的任务看板）

openclaw plugins enable workboard
openclaw gateway restart

第 10 步：开机自启 + 查看网关运行状态

loginctl enable-linger $USER
systemctl --user status openclaw-gateway

看到绿色 active (running) = 网关正常运行

第 11 步：访问 Web 管理面板（左侧自带 Workboard 看板）

浏览器打开地址：

http://localhost:18789

---

📌 Workboard 看板｜终端快捷命令（备用，不用网页也能管理任务）

# 列出所有任务卡片
openclaw workboard list
创建任务示例
openclaw workboard create "自动化脚本开发" --notes "读取 CSV 并输出报表" --priority high
查看单张任务详情（替换为你的卡片 ID）
openclaw workboard show 7f4a2c10
移动任务状态 todo/doing/review/done
openclaw workboard move 7f4a2c10 --status doing
派发任务交给智能体执行
openclaw workboard dispatch

🧪 环境自检（任何报错优先执行这条排查）

openclaw doctor

🧹 完整卸载脚本（后续需要干净删除时使用）

# 停止并取消自启网关
systemctl --user stop openclaw-gateway
systemctl --user disable openclaw-gateway
# 卸载 openclaw
npm uninstall -g openclaw
# 删除 node、配置文件、工作区
sudo rm -rf /usr/local/node22
sed -i '/node22\/bin/d' ~/.bashrc
rm -rf ~/.openclaw
source ~/.bashrc

❗ 常见排错清单

1. openclaw: command not found → 执行 source ~/.bashrc 或者重启终端
2. 网页找不到 Workboard 标签页 → 重新执行 openclaw plugins enable workboard && openclaw gateway restart 然后刷新页面
3. Node 版本不满足报错 → 确认 node -v 输出是 v22.22.3
4. 内存不足崩溃（≤ 2G 内存），执行增加 2G 交换分区：

   sudo fallocate -l 2G /swapfile
   sudo chmod 600 /swapfile
   sudo mkswap /swapfile
   sudo swapon /swapfile
   echo '/swapfile none swap sw 0 0' | sudo tee -a /etc/fstab

。