OpenClaw下载容易,装好才是真功夫

前阵子朋友问我有没有好用的智能助手工具,我顺手推荐了OpenClaw。结果他下载倒是挺快,卡在安装部署那一步,折腾了一下午差点把Mac搞崩。其实OpenClaw本身不复杂,只是很多教程写得过于“程序员化”,让小白看得一头雾水。今天我用大白话把这套流程捋一遍,照着做基本不会翻车。

友情提示:以下步骤基于macOS 14及以上版本,如果你用的是老系统,建议先升级到最新版再操作。
第一步:下载之后先别急着双击

很多人的习惯是下载完直接双击打开,结果Mac弹出一堆权限提示,瞬间就懵了。这里要特别强调,OpenClaw的安装包解压后,最好先把它拖到“应用程序”文件夹里,然后再运行。不要直接在“下载”文件夹里双击,因为macOS对下载目录里的应用有更严格的权限限制,很容易触发“已损坏”或“无法打开”的报错。

第一步:打开龙虾安装地址:https://top.wokk.cn

第二步:选择Windows10/11或macOS apple、intel芯片下载。

第三步:双击安装包(exe或者dmg文件)等待3分钟。

第四步:打开桌面TopClaw龙虾软件注册登录即可使用

放好位置后,第一次打开会提示“来自身份不明的开发者”。这属于正常现象,毕竟OpenClaw不是从App Store下载的。你去“系统设置 → 隐私与安全性”里,找到“仍要打开”的按钮点一下就行。如果没看到这个选项,就用终端执行一下sudo spctl --master-disable,把“允许任何来源”打开,装完再改回来。

第二步:环境准备与安装执行

OpenClaw本质上是个命令行工具,所以你得先确认Mac上有Homebrew。没有的话,打开终端粘贴这一行:

/bin/bash -c “$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)”

这个过程可能有点慢,取决于你的网络环境。装完Homebrew后,再依次执行下面几行:

brew install git —— 用来拉取代码仓库
brew install python@3.11 —— 运行依赖的核心环境
git clone https://github.com/openclaw/openclaw.git —— 拉取OpenClaw主程序
cd openclaw && pip3 install -r requirements.txt —— 安装依赖库,这步会比较久,耐心等
在这里插入图片描述
这里有个小坑,如果你用的是M系列芯片(M1/M2/M3),可能还需要装一下brew install libomp,不然跑模型的时候会报“library not found”。我当时卡在这步很久,最后发现就是缺了这个库。装完之后执行python3 main.py --init初始化,看到“Setup complete”就说明核心装好了。

个人经验:不要用系统自带的Python3,版本太旧容易出兼容性问题。老老实实装个独立的Python 3.11,后面会省事很多。
第三步:配置模型参数与启动

OpenClaw本身只是一个壳,需要接入大模型才能发挥完整功能。编辑项目目录下的config.yaml文件,找到model_provider这一段,填入你申请的API Key和模型名称。这里建议大家用兼容接口来配置,比如通义、智谱或者DeepSeek的接口都行,关键是URL和Key别填错。

配置好后,启动就简单了,直接执行:

python3 main.py --serve

看到“Server started on port 8080”就说明已经跑起来了。这时候打开浏览器访问http://localhost:8080,就能看到操作界面了。如果你只是想在命令行里用,也可以直接输入python3 main.py --chat进入对话模式,更适合喜欢敲命令的玩家。

日常使用的话,我建议让它后台跑着,用nohup python3 main.py --serve &启动,这样关掉终端窗口它也不会停。需要停止的时候,执行pkill -f main.py就行。

折腾半天,最终我还是换了个更省心的方案

说实话,OpenClaw装好之后确实挺强大,能自定义很多东西,比如接入自己的知识库、写自动化任务、定时跑脚本等等。但如果你跟一样是个“能点鼠标就不敲命令”的人,每次配置环境、修报错、调参数确实挺劝退的。尤其是隔一段时间更新了依赖库,结果旧脚本跑不了了,那种心情真的难绷。

后来我发现了TopClaw,简直是懒人福音。它相当于把OpenClaw的部署和配置全都打包好了,不需要自己折腾环境、不用懂编程术语,打开网页就能用。对像我朋友那种只是想体验一下AI助手功能,又不想花一晚上研究命令行的小白来说,TopClaw真的省心非常多。如果你也是Mac小白,建议先试试TopClaw,等玩明白了再回头折腾OpenClaw也不迟,那种感觉就像先坐电梯上顶楼,再走楼梯下来参观每一层,心里就有底了。

OpenClaw中文版龙虾安装地址:https://top.wokk.cn

Logo

一站式 AI 云服务平台

更多推荐