OpenClaw 一鍵安裝教程：手把手帶你跑通第一個(gè)機(jī)械臂AI任務(wù)

問題

你剛拿到一臺(tái)支持 OpenClaw 的機(jī)械臂（比如 UR5e、DJI RoboMaster EE 或國(guó)產(chǎn) AutoClaw 兼容機(jī)型），想讓它抓杯子、分揀積木，卻卡在第一步：連不上電腦，裝不上控制軟件，更別說讓 AI 下指令了。

這不是你的問題。OpenClaw 默認(rèn)不預(yù)裝，也不是點(diǎn)“下一步”就能用的圖形軟件。它是一套面向開發(fā)者的開源機(jī)器人AI框架，需要手動(dòng)配置環(huán)境。整個(gè)過程其實(shí)只要 5 分鐘，關(guān)鍵就三件事：Python 版本對(duì)、代碼倉庫對(duì)、啟動(dòng)命令對(duì)。

方案

用 conda 創(chuàng)建純凈 Python 環(huán)境 + git clone 官方穩(wěn)定版 + 運(yùn)行內(nèi)置測(cè)試?yán)?。不?Docker、不編譯 C++、不搭 ROS——新手能直接跑通的路徑。

? 為什么選 conda？
OpenClaw 依賴 PyTorch（需 CUDA 11.8）、PyRep、numpy 等幾十個(gè)包，版本沖突常見。conda 能自動(dòng)解決；用 pip 容易報(bào) ERROR: Could not find a version that satisfies...——那是依賴在打架，不是代碼錯(cuò)了。

步驟

1. 安裝 Miniconda（輕量版 Anaconda）

去官網(wǎng)下載對(duì)應(yīng)系統(tǒng)安裝包：

• 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）或終端執(zhí)行（macOS）：

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

? 為什么不用系統(tǒng)自帶 Python？
macOS 和 Linux 自帶的 Python 是系統(tǒng)級(jí)的，改它可能讓 ls、ssh 等命令崩潰。conda 隔離出一個(gè)獨(dú)立環(huán)境，只給 OpenClaw 用。

2. 創(chuàng)建專用環(huán)境并安裝 OpenClaw

打開終端（Windows 用 Anaconda Prompt），逐行執(zhí)行：

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 這類文件，不用反復(fù) pip install，改完直接運(yùn)行生效。調(diào)試技能時(shí)省掉一半時(shí)間。

3. 運(yùn)行首個(gè)真實(shí)任務(wù)：仿真抓取

不接真機(jī)也能驗(yàn)證環(huán)境是否正常。啟動(dòng) PyRep 仿真器：

python examples/run_pick_place.py --sim

你會(huì)看到窗口彈出一個(gè)藍(lán)色機(jī)械臂，自動(dòng)伸向紅色方塊 → 張開夾爪 → 合攏 → 提起 → 放到目標(biāo)區(qū)域。全程約 12 秒。

? 這個(gè)例子在干什么？
它調(diào)用了 OpenClaw 內(nèi)置的 PickPlaceSkill 技能，背后是預(yù)訓(xùn)練好的視覺-動(dòng)作策略模型（ResNet+LSTM）。你沒寫一行強(qiáng)化學(xué)習(xí)代碼，但已經(jīng)讓機(jī)械臂“看懂”并“執(zhí)行”了任務(wù)。

驗(yàn)證

成功標(biāo)志有三個(gè)：

• 終端最后輸出 Task succeeded ?
• 仿真窗口中夾爪精準(zhǔn)接觸方塊（無抖動(dòng)、無懸停失?。?/li>
• logs/ 文件夾下生成 pick_place_20240520_142211.json ——記錄每次抓取的位置誤差（單位：毫米）

如果卡在 ImportError: No module named 'pyrep'，說明第 2 步漏了 pip install -e .；如果窗口黑屏，是顯卡驅(qū)動(dòng)不支持 OpenGL ——加 --headless 參數(shù)跑無界面模式：

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

結(jié)果完全一樣，只是看不到動(dòng)畫。

常見問題

Q：提示 CUDA out of memory？
A：你的顯卡顯存 < 6GB（如 MX350、集成核顯）。加參數(shù)強(qiáng)制用 CPU：

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

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

Q：真機(jī)連接不上 UR5e？
A：先確認(rèn)硬件線已接好（USB-C 轉(zhuǎn)以太網(wǎng)適配器 + 網(wǎng)線直連機(jī)械臂），再運(yùn)行：

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

IP 地址必須和機(jī)械臂控制器面板顯示的一致（默認(rèn)常為 192.168.50.100）。

Q：想換國(guó)產(chǎn)機(jī)械臂（如 AutoClaw）怎么辦？
A：AutoClaw 已內(nèi)置驅(qū)動(dòng)。只需把上條命令改成：

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

然后確保 AutoClaw 控制盒和電腦在同一局域網(wǎng)（手機(jī)熱點(diǎn)不行，必須路由器或網(wǎng)線直連）。

下一步

你現(xiàn)在能跑通仿真和真機(jī)基礎(chǔ)任務(wù)。接下來建議：

• 【必學(xué)】《Skills 技能開發(fā)入門》：修改 skills/pick_place.py，讓機(jī)械臂抓不同顏色的積木 → m.gsdl.org.cn/tutorials/skills-basics
• 【延伸】《用手機(jī)拍張照，讓機(jī)械臂復(fù)現(xiàn)動(dòng)作》：零樣本模仿學(xué)習(xí)實(shí)戰(zhàn) → m.gsdl.org.cn/tutorials/imitation
• 【避坑】《國(guó)產(chǎn)機(jī)械臂網(wǎng)絡(luò)配置全指南》：解決 AutoClaw/CloudClaw 常見斷連、延遲高問題 → m.gsdl.org.cn/guides/network-setup

環(huán)境裝好了，機(jī)械臂就在你桌面上等著接第一道指令。現(xiàn)在，試試把 run_pick_place.py 里的 red 換成 green，看看它會(huì)不會(huì)去找綠方塊？