OpenClaw完整安装指南 - Derek Zhao Blog

最近爆火的开源机械爪控制工具库OpenClaw，凭借轻量适配、无缝对接ROS/ROS2的优势，成为机器人抓取项目的刚需选择，但网上热议的大多是功能应用，却鲜有完整的安装配置指南——如果您正被依赖缺失、编译报错、环境不生效、launch文件启动失败等问题卡住，搜遍教程要么简略要么过时，那这篇超详细、可直接复制命令、新手也能照做的OpenClaw安装配置教程，绝对能帮您一步跑通，Ubuntu 20.04/22.04通用，全程无跳步直接抄作业。

官网网站：https://openclaw.ai/

一、环境准备（必做前置步骤）#

推荐系统：Ubuntu 20.04 LTS（搭配ROS Noetic）、Ubuntu 22.04 LTS（搭配ROS2 Humble），打开终端依次执行以下命令安装基础编译工具与依赖库：

1
sudo apt update && sudo apt upgrade -y
2
sudo apt install -y git cmake build-essential gcc g++
3
sudo apt install -y libboost-all-dev libeigen3-dev libpcl-dev

OpenClaw核心功能依赖ROS生态，未安装ROS/ROS2的可快速补齐（以ROS Noetic为例）：

1
sudo sh -c 'echo "deb http://packages.ros.org/ros/ubuntu $(lsb_release -sc) main" > /etc/apt/sources.list.d/ros-latest.list'
2
curl -s https://raw.githubusercontent.com/ros/rosdistro/master/ros.asc | sudo apt-key add -
3
sudo apt update
4
sudo apt install -y ros-noetic-desktop-full
5
sudo rosdep init
6
rosdep update

临时加载ROS环境（后续将配置永久生效）：

1
source /opt/ros/noetic/setup.bash

二、源码获取与编译构建#

首先创建标准ROS工作空间并拉取OpenClaw源码：

1
mkdir -p ~/catkin_ws/src
2
cd ~/catkin_ws/src
3
git clone https://github.com/openclaw/openclaw.git
4
cd ~/catkin_ws

接着自动安装ROS包依赖并编译工作空间：

1
rosdep install --from-paths src --ignore-src -r -y
2
catkin_make -DCMAKE_BUILD_TYPE=Release

小提示：如果提示C++版本不兼容，可添加编译参数：catkin_make -DCMAKE_CXX_STANDARD=11

三、环境变量配置（永久生效）#

未配置环境变量会导致每次打开终端都需重新加载，操作如下：

1
gedit ~/.bashrc

在打开的文件末尾添加对应ROS版本的配置（根据系统选择）：

1
# ROS Noetic（Ubuntu 20.04）
2
source /opt/ros/noetic/setup.bash
3
source ~/catkin_ws/devel/setup.bash
4

5
# ROS2 Humble（Ubuntu 22.04）
6
# source /opt/ros/humble/setup.bash
7
# source ~/catkin_ws/install/setup.bash

保存文件后，执行以下命令使配置立即生效：

1
source ~/.bashrc

四、安装验证（确认成功标志）#

检查包识别状态#

执行以下命令，若输出OpenClaw的安装路径，则说明系统已成功识别该包：

1
rospack list | grep openclaw

启动示例节点验证#

运行核心控制节点，若终端无报错且正常输出INFO日志，即为安装配置完全成功：

1
roslaunch openclaw openclaw_controller.launch

五、常见问题快速排坑#

rosdep update 失败：多为网络问题，可更换国内镜像源，或跳过该步骤直接手动安装缺失依赖；
编译提示找不到 Eigen/PCL：重新执行安装命令：sudo apt install libeigen3-dev libpcl-dev；
提示找不到launch文件/节点：回到工作空间根目录重新编译（catkin_make），并执行 source devel/setup.bash；
命令不生效：99%是未配置环境变量或未在正确工作空间操作，可重新检查.bashrc文件配置并source生效。

写在最后#

OpenClaw本身的使用门槛并不高，真正卡住大多数开发者的，始终是环境依赖、编译细节、环境变量这三大核心问题。这篇教程已做到命令可直接复制、步骤无跳步、逻辑贴合新手操作习惯，且提前标注了高频坑点，只要跟着顺序执行，基本都能一次成功。如果您在安装过程中遇到特殊报错、特定硬件适配（如不同品牌机械爪）问题，或需要Windows版本的适配方案，欢迎在评论区留言，我会逐一回复并补充到后续教程中。原创教程不易，整理、测试、排坑均花费大量时间，欢迎点赞、在看、转发给身边做机器人、机械臂、抓取项目的朋友，您的支持就是我持续更新干货的动力～后续还会推出OpenClaw基础控制示例（开合、力度、闭环控制）、ROS2迁移与移植指南、机械爪常见硬件接线与驱动等内容，关注我，不错过每一篇能直接落地的机器人开发教程。

参考资料#

openclaw接入飞书教程

https://x.com/0xValkyrie_ai/status/2020330035652227360

发现新文章