OpenClaw 完整安装与配置
本文档梳理了 OpenClaw 在 Linux 系统(Debian/Ubuntu)上的部署全流程,涵盖基础环境准备、核心程序安装、Minimax/DeepSeek 模型配置以及飞书渠道对接。所有交互式选项均已列出,步骤可直接复制执行。
前置准备
- 网络环境:确保服务器可访问 GitHub、npm 及飞书官网。
- 权限要求:操作全程使用终端命令行,建议使用 Xshell 或 Putty 连接,需拥有 root 用户或 sudo 权限。
- 命令规范:复制命令时请保持完整,避免遗漏特殊符号。
一、基础环境搭建
1. 配置 Root 账户(可选但推荐)
为了便于远程管理,建议启用 Root 登录。修改密码并调整 SSH 配置:
# 设置 root 密码
sudo passwd root
# 编辑 SSH 配置文件
sudo vim /etc/ssh/sshd_config
在编辑器中按 i 进入插入模式,找到 PermitRootLogin 行(若被注释请先删除 #),将其修改为 PermitRootLogin yes。保存退出后重启服务:
sudo systemctl restart sshd
2. 安装 Node.js
OpenClaw 依赖 Node.js,建议版本 ≥20.x(推荐 22.x)。
# 添加 NodeSource 官方源
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
# 安装 Node.js
sudo apt-get install -y nodejs
# 验证版本
node -v
注意:若 curl 命令失败,可尝试更换国内源或手动上传安装包。
3. 安装编译工具与 CMake
OpenClaw 需要 CMake 进行部分组件编译(版本 ≥3.19)。
# 下载 CMake 3.28.3 脚本
wget https://github.com/Kitware/CMake/releases/download/v3.28.3/cmake-3.28.3-linux-x86_64.sh
# 赋予执行权限并安装
chmod +x cmake-3.28.3-linux-x86_64.sh
sudo ./cmake-3.28.3-linux-x86_64.sh --prefix=/usr/local --skip-license
# 验证版本
cmake --version
如果提示找不到 cmake 命令,请临时添加环境变量:
export PATH=/usr/local/bin:$PATH
同时安装基础编译工具链:

