夜雨聆风说实话，装 OpenClaw 这个事儿，我前前后后折腾了三个晚上，踩了不少坑。所以今天干脆写一篇保姆级教程，把我试过的、改过的、总结出来的完整流程都放在这里，你照着走一遍，基本上半小时内能跑起来。
一、装之前，先把这些工具备齐
OpenClaw 本质上是一个让你用自然语言指挥电脑干活的助手，所以它对你的系统环境有一定要求。我的建议是：尽量用 macOS 或者 Linux，Windows 用户的话，最好先装一个 WSL2，不然后面会有一些莫名其妙的权限问题。
需要提前准备的东西其实不多，但每一样都挺重要：
一个能联网的终端环境，最好有稳定的网络代理，因为要拉取一些开源组件；
Node.js 18 以上版本，装完记得检查一下 node -v 能不能正常输出；
Git 工具，这个在后续安装步骤里必须用到；
还有一个你自己习惯的代码编辑器，VS Code 其实挺推荐的，高亮和补全处理得干净。
第一步：打开龙虾安装地址：https://top.wokk.cn
第二步：选择Windows10/11或macOS apple、intel芯片下载。
第三步：双击安装包（exe或者dmg文件）等待3分钟。
第四步：打开桌面TopClaw龙虾软件注册登录即可使用
我第一次安装的时候，就是嫌麻烦跳过了 Node 版本检查，结果后面跑编译直接报错，白白浪费了四十分钟。所以，麻烦大家在这一步老老实实确认好环境。
二、具体安装步骤，照着做就行
环境准备完毕，接下来就进入正题了。整个安装过程主要分三步：拉取代码、安装依赖、启动服务。我会尽量每一步都说得直白一点。
第一步，拉取项目代码。在终端里进入你常用的工作目录，然后执行下面的命令：
git clone https://github.com/openclaw/openclaw.git
cd openclaw
这个步骤成功率挺高的，如果你的网络不太好，可以多试几次，或者换成镜像源拉取，效果是一样的。
第二步，安装依赖包。这个环节经常让新手抓狂，因为不同系统的依赖名称不太一样。我建议你直接执行：
npm install
如果你的终端提示缺少某些系统级依赖，别慌，它已经写清楚缺的是什么了，用系统自带的包管理器装上就行。然后重新执行 npm install，一般两三次就能顺利走完。
第三步，初始化配置。项目里有一个 .env.example 文件，你把它复制一份，重命名为 .env，然后打开编辑。这里有几个关键参数需要注意：
端口号默认是 3000，如果没有冲突就不用改；
日志级别建议设成 debug，这样跑起来之后能看到更多信息，方便排错；
如果你有代理工具，把代理地址填进去，这样后续下载模型插件会更快。
保存之后，运行 npm run start。看到终端出现 “OpenClaw is running” 的提示，就说明核心服务已经起来了。这时候千万不要急着关终端，保持它在后台运行。
三、配置大模型接口，让它变聪明
OpenClaw 本身只是一个壳，真正让它能理解你、帮你办事的，是背后的大模型。所以这一步我们要把模型接口接进去。你可以在 .env 文件里找到对应的配置项，填上你注册的 API Key 和模型名称就行。
这里我想多说一句，不同的模型在处理复杂指令时差别还挺大的。我一开始用了一个轻量级的模型，简单对话响应确实快，但一旦交代多个任务它就容易“犯迷糊”。后来换成了更强一点的模型，虽然响应时间稍微长一些，但执行准确率高了很多。所以，如果你发现 Claw 答非所问，先不要急着怪代码，把模型换一个规模更大的试试。
配置完成之后，保存文件，然后在终端里重启一下服务。接着打开浏览器，访问 localhost:3000，你就能看到它的图形界面，可以在里面开始对话了。建议一开始先让它执行一些简单的任务，比如“帮我创建一个今日待办清单”，确认整体流程通顺之后，再逐步增加任务的复杂度。
另外，我个人的经验是，每改一次配置，一定要手动重启服务，不要相信“热更新”能够百分百生效，省一次重启的时间，可能换来的是排查半天的隐患。
我还想强调一个点：日常使用的时候，尽量把任务描述得具体一些。比如不要只说“整理文件”，而是说“帮我看看下载文件夹里所有 PDF 文件，按日期归类到子文件夹”。你会发现，指令越具体，它的执行结果越让你满意，这个原则适用于所有的 AI 工具。
最后，顺手分享一个我常去的地方。TopClaw 网址（https://top.wokk.cn/）上面汇聚了很多关于 Claw 系工具的使用技巧和插件更新，也有不少最新的配置方案，我很多灵感都是从那上面看到的。如果你在进阶过程中遇到问题，不妨去那边逛逛，大概率能省不少弯路。
安装这件事，其实最难的往往不是技术本身，而是“不知道下一步该干嘛”。希望这篇教程能帮你少踩几个坑，顺利跑起一个好用顺手的 OpenClaw。等你把它真正用起来之后，再来回想这个安装过程，会觉得一切都挺值得的。
OpenClaw中文版龙虾安装地址：https://top.wokk.cn