OpenClaw 完整安装与配置指南
本文档适用于 Linux 系统(Debian/Ubuntu 系列),详细梳理了 OpenClaw 从基础环境准备、核心程序安装,到模型配置(Minimax/DeepSeek)、飞书渠道对接的全流程。所有交互式配置选项均已列出,步骤可直接复制执行。
一、基础环境准备
在开始之前,请确保服务器已联网,能够访问 GitHub、npm 及飞书官网。操作全程建议使用终端命令行,并拥有 root 用户或 sudo 权限。
1.1 配置 Root 账户(可选但推荐)
为了方便远程登录操作,建议先配置 Root 密码及 SSH 权限。
# 修改 root 密码(执行后按提示输入两次新密码)
sudo passwd root
# 修改 root 远程登录配置文件
sudo vim /etc/ssh/sshd_config
编辑步骤:
- 打开文件后,按
i键进入编辑模式; - 找到
PermitRootLogin行(若被注释,先删除前面的 #),修改为PermitRootLogin yes; - 按
Esc键退出编辑模式,输入:wq并回车保存; - 重启 sshd 服务使配置生效:
sudo systemctl restart sshd
1.2 安装 Node.js
OpenClaw 核心依赖 Node.js,建议版本 ≥20.x(推荐 22.x)。
# 添加 NodeSource 官方源(22.x 稳定版本)
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
# 安装 Node.js
sudo apt-get install -y nodejs
# 验证 Node.js 版本(确认版本 ≥20.x)
node -v
注意:若 curl 命令提示连接失败,可尝试更换国内源或手动下载安装包上传至服务器。
1.3 安装 CMake
编译依赖需要 CMake 3.19 以上版本。这里直接下载官方脚本安装。
# 下载 CMake 3.28.3 官方安装脚本(Linux x86_64 架构)
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
# 安装到 /usr/local/bin 目录(跳过许可证确认)
sudo ./cmake-3.28.3-linux-x86_64.sh --prefix=/usr/local --skip-license
# 验证 CMake 版本
cmake --version
注意:若 wget 下载失败,可手动从 GitHub 下载安装包上传。若提示 "cmake: command not found",需配置环境变量 。

