OpenClaw 完整安装与配置
本文档梳理了 OpenClaw 在 Linux 系统(Debian/Ubuntu 系列)下的完整部署流程,涵盖基础环境搭建、核心程序安装、Minimax 与 DeepSeek 模型配置,以及飞书渠道对接。所有交互式配置选项均已列出,步骤可直接复制执行。
一、环境准备
前置要求
- 服务器需联网,确保能访问 GitHub、npm 及飞书官网;
- 操作全程使用终端命令行,建议使用远程工具连接;
- 拥有 root 用户或 sudo 权限;
- 建议 Node.js 版本 ≥20.x(推荐 22.x)。
1.1 配置 Root 账户(可选但推荐)
为了便于远程登录操作,建议修改 Root 密码并开启 SSH 远程登录权限。
# 修改 root 密码(执行后按提示输入两次新密码)
sudo passwd root
# 修改 sshd 配置文件
sudo vim /etc/ssh/sshd_config
编辑文件时,找到 PermitRootLogin 行(若被注释请先删除 #),将其修改为 PermitRootLogin yes。保存退出后重启服务:
sudo systemctl restart sshd
1.2 安装 Node.js
OpenClaw 依赖 Node.js,请确保版本符合要求。
# 添加 NodeSource 官方源(22.x 稳定版)
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
# 安装 Node.js
sudo apt-get install -y nodejs
# 验证版本
node -v
*注意:若 curl 命令失败,可尝试更换国内源或手动下载安装包上传至服务器。
1.3 安装编译工具与 CMake
OpenClaw 部分模块需要编译,需安装 CMake(≥3.19)及基础构建工具。
# 下载 CMake 安装脚本
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 版本
cmake --version
若提示找不到 cmake 命令,请配置环境变量:export PATH=/usr/local/bin:$PATH。
同时安装基础编译工具:
sudo apt install -y make gcc g++ build-essential

