OpenClaw 一键安装教程：手把手带你跑通第一个机械臂AI任务

问题

你刚拿到一台支持 OpenClaw 的机械臂（比如 UR5e、DJI RoboMaster EE 或国产 AutoClaw 兼容机型），想让它抓杯子、分拣积木，却卡在第一步：连不上电脑，装不上控制软件，更别说让 AI 下指令了。

这不是你的问题。OpenClaw 默认不预装，也不是点“下一步”就能用的图形软件。它是一套面向开发者的开源机器人AI框架，需要手动配置环境。整个过程其实只要 5 分钟，关键就三件事：Python 版本对、代码仓库对、启动命令对。

方案

用 conda 创建纯净 Python 环境 + git clone 官方稳定版 + 运行内置测试例程。不碰 Docker、不编译 C++、不搭 ROS——新手能直接跑通的路径。

✅ 为什么选 conda？
OpenClaw 依赖 PyTorch（需 CUDA 11.8）、PyRep、numpy 等几十个包，版本冲突常见。conda 能自动解决；用 pip 容易报 ERROR: Could not find a version that satisfies...——那是依赖在打架，不是代码错了。

步骤

1. 安装 Miniconda（轻量版 Anaconda）

去官网下载对应系统安装包：

• Windows：https://repo.anaconda.com/miniconda/Miniconda3-latest-Windows-x86_64.exe
• macOS（Intel）：https://repo.anaconda.com/miniconda/Miniconda3-latest-MacOSX-x86_64.sh
• macOS（Apple Silicon）：https://repo.anaconda.com/miniconda/Miniconda3-latest-MacOSX-arm64.sh

双击安装（Windows）或终端执行（macOS）：

bash Miniconda3-latest-MacOSX-arm64.sh -b -p $HOME/miniconda3
source $HOME/miniconda3/bin/activate

✅ 为什么不用系统自带 Python？
macOS 和 Linux 自带的 Python 是系统级的，改它可能让 ls、ssh 等命令崩溃。conda 隔离出一个独立环境，只给 OpenClaw 用。

2. 创建专用环境并安装 OpenClaw

打开终端（Windows 用 Anaconda Prompt），逐行执行：

conda create -n openclaw python=3.9
conda activate openclaw
git clone https://github.com/Intellifox/OpenClaw.git
cd OpenClaw
pip install -e .

✅ -e 是什么？
“可编辑模式”——你改 skills/pick_place.py 这类文件，不用反复 pip install，改完直接运行生效。调试技能时省掉一半时间。

3. 运行首个真实任务：仿真抓取

不接真机也能验证环境是否正常。启动 PyRep 仿真器：

python examples/run_pick_place.py --sim

你会看到窗口弹出一个蓝色机械臂，自动伸向红色方块 → 张开夹爪 → 合拢 → 提起 → 放到目标区域。全程约 12 秒。

✅ 这个例子在干什么？
它调用了 OpenClaw 内置的 PickPlaceSkill 技能，背后是预训练好的视觉-动作策略模型（ResNet+LSTM）。你没写一行强化学习代码，但已经让机械臂“看懂”并“执行”了任务。

验证

成功标志有三个：

• 终端最后输出 Task succeeded ✅
• 仿真窗口中夹爪精准接触方块（无抖动、无悬停失败）
• logs/ 文件夹下生成 pick_place_20240520_142211.json ——记录每次抓取的位置误差（单位：毫米）

如果卡在 ImportError: No module named 'pyrep'，说明第 2 步漏了 pip install -e .；如果窗口黑屏，是显卡驱动不支持 OpenGL ——加 --headless 参数跑无界面模式：

python examples/run_pick_place.py --sim --headless

结果完全一样，只是看不到动画。

常见问题

Q：提示 CUDA out of memory？
A：你的显卡显存 < 6GB（如 MX350、集成核显）。加参数强制用 CPU：

python examples/run_pick_place.py --sim --device cpu

速度慢 3 倍，但功能完全一致。

Q：真机连接不上 UR5e？
A：先确认硬件线已接好（USB-C 转以太网适配器 + 网线直连机械臂），再运行：

python examples/run_pick_place.py --robot ur5e --ip 192.168.50.100

IP 地址必须和机械臂控制器面板显示的一致（默认常为 192.168.50.100）。

Q：想换国产机械臂（如 AutoClaw）怎么办？
A：AutoClaw 已内置驱动。只需把上条命令改成：

python examples/run_pick_place.py --robot autoclaw --ip 192.168.1.101

然后确保 AutoClaw 控制盒和电脑在同一局域网（手机热点不行，必须路由器或网线直连）。

下一步

你现在能跑通仿真和真机基础任务。接下来建议：

• 【必学】《Skills 技能开发入门》：修改 skills/pick_place.py，让机械臂抓不同颜色的积木 → yitb.com/tutorials/skills-basics
• 【延伸】《用手机拍张照，让机械臂复现动作》：零样本模仿学习实战 → yitb.com/tutorials/imitation
• 【避坑】《国产机械臂网络配置全指南》：解决 AutoClaw/CloudClaw 常见断连、延迟高问题 → yitb.com/guides/network-setup

环境装好了，机械臂就在你桌面上等着接第一道指令。现在，试试把 run_pick_place.py 里的 red 换成 green，看看它会不会去找绿方块？