OpenClaw 安装教程，Windows 和 Mac 都踩了一遍坑

xiaopang_dev · 2026 年4 月 8 日 02:02

花了一整天把 OpenClaw 在 Windows 和 Mac 上各装了一遍，踩了不少坑记录一下。Windows 主要卡在 Python 环境和 Node.js 版本，Mac 上 M 芯片有个依赖编译问题。

jiangnan_coder · 2026 年4 月 8 日 06:12

Windows 安装确实坑多。最大的坑是 Python 版本，OpenClaw 要求 3.10 以上但不支持 3.13，装了最新版 Python 反而跑不起来建议直接装 3.11 最稳。Node.js 最好用 LTS 版本别用 Current。Mac 上 M 芯片的问题主要是 onnxruntime 这个依赖编译不过加个 platform 参数就好了。另外强烈建议用 Docker 部署一行命令搞定不用折腾环境，特别是 Windows 上用 WSL2 + Docker 比原生安装省心太多了。

xiaopang_dev · 2026 年4 月 8 日 06:15

Docker 方案确实最省事，后来改用 Docker 五分钟就跑起来了早该这么搞

anzhuang_ku · 2026 年4 月 10 日 11:49

Mac M系列芯片有个依赖要手动编译，作者可以补充一下

winmac_bro · 2026 年4 月 10 日 12:59

Windows下我建议装wsl再跑，原生环境问题太多

macuser99 · 2026 年4 月 10 日 12:59

mac版就顺滑多了，brew一把梭基本搞定

silverpin · 2026 年4 月 13 日 04:01

Mac装完直接能跑，Windows要先装个wsl不然环境配不对

guo_patch · 2026 年4 月 13 日 06:10

感谢踩坑，我Windows装的时候环境变量配了半天

jjfly_404 · 2026 年4 月 13 日 06:10

Mac上homebrew直接装就行了，Windows确实麻烦点

lightstone_v · 2026 年4 月 14 日 08:50

Windows上用WSL装比原生省事太多了

saltbreeze_m · 2026 年4 月 14 日 15:22

Mac上直接brew install最方便，三条命令搞定

haowen_inst · 2026 年4 月 15 日 14:12

Windows安装坑最多的是环境变量配置，PATH没设对什么都跑不了

canglan_mw · 2026 年4 月 17 日 04:06

Windows和Mac都踩了坑这篇写得很全面

shuxin_vpq · 2026 年4 月 25 日 04:46

装了三次终于成功了，环境依赖太多

pinocarvone · 2026 年4 月 27 日 06:04

两个平台都踩了一遍坑，这种教程最有用了