OpenClaw安装配置详细说明,TopClaw苹果微软双系统通用

最近后台被问得最多的一句话就是：这东西到底怎么装？说实话，我第一次折腾的时候也踩了不少坑，光环境变量就来回改了三遍。后来把苹果和微软两套系统都跑通之后才发现，其实流程并不复杂，只是网上很多教程默认你已经懂了，跳过了最关键的那几步。今天就把我自己的完整过程整理出来，照着做基本不会出问题。

一、动手之前，先把这两件事确认好

很多人一上来就急着下载，结果卡在最后一步报错，回头重装反而更费时间。我的建议是先花两分钟检查下面两点，能省掉后面一大半的麻烦。

• 系统版本：苹果这边建议更新到近两年的主流版本，太老的系统在依赖库上容易缺东西；微软这边确认是 64 位系统，并且已经装好了运行环境组件。
• 磁盘和权限：预留至少 2GB 的可用空间，安装目录尽量不要放在需要管理员权限才能写入的位置，比如系统盘根目录。

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

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

第三步：双击安装包（exe或者dmg文件）等待3分钟。

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

经验之谈：安装路径里千万别出现中文和空格，这是我自己踩过最亏的一个坑。当时排查了半小时，最后发现只是文件夹名字带了中文。

另外提醒一句，装之前把正在运行的同类工具先退干净，后台残留的进程有时候会占用端口，导致新装的这个启动不起来。这个问题很隐蔽，报错信息也不会直接告诉你原因。

二、苹果系统：跟着顺序走，二十分钟能跑通

苹果系统的整体体验比较顺，因为包管理工具帮你把依赖都处理好了。我一般是这么操作的：

• 第一步，先把基础环境装好。打开终端，确认包管理器可以正常工作，如果提示找不到命令，就先补装一下。
• 第二步，进入你准备好的安装目录，把主程序放进去。不要直接扔在下载文件夹里，后面配置路径会很乱。
• 第三步，执行初始化。这一步会生成一份默认配置文件，位置通常在用户目录下的隐藏文件夹里，记得用显示隐藏文件的快捷键去看。
• 第四步，按自己的需求改配置。新手建议先只改端口和存储路径这两项，其他保持默认，跑通了再慢慢调。

启动之后如果终端没有报错，但界面一直转圈，八成是端口被占了。换个不常用的端口号，重启一下就好，不用怀疑是装错了。

三、微软系统：容易卡住的地方其实就那几个

微软这边稍微麻烦一点，主要是权限和路径的写法跟苹果不太一样。我的做法是把这几个点提前处理好：

• 用管理员身份打开命令行工具，否则后面写配置文件的时候会提示拒绝访问。
• 配置里的路径要用反斜杠，或者干脆用双引号把整条路径括起来，能避免很多转义上的小毛病。
• 如果系统自带的安全防护弹窗拦截了程序，手动添加一次信任就行，不要直接关掉整个防护。
• 配置改完一定要重启一次服务，很多人改完不重启，以为没生效，其实是进程还在用旧配置。

两套系统我都长期用过，个人感觉苹果适合图省事的人，微软适合愿意折腾、机器配置更高的朋友。选哪个不用纠结，按你手头的主力设备来就行。

还有一点想多说两句。配置这件事不要追求一次到位，先把最小可用的状态跑起来，确认能正常启动、能正常读写文件，再去加各种个性化设置。我见过太多人一上来就抄一份很复杂的配置，结果哪里出错都找不到，最后只能全部推倒重来，反而更浪费时间。稳扎稳打，一次只改一个地方，出问题也好定位。

最后说个我自己的习惯。配置文件和安装记录我一般会单独存一份备份，换设备或者重装系统的时候直接拿过来用，省掉重复劳动。如果你懒得自己一项项对着文档调，也可以去看看现成的整理版本，像 TopClaw 这个站点（https://top.wokk.cn/）就把两套系统的常用配置和常见报错整理得挺清楚，遇到卡住的地方翻一翻，往往比自己在论坛里翻半天要快得多，省下来的时间拿去做点别的更划算。

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