ARTICLE · 1054238
Openclaw小龙虾搭建指南:U盘版+Mac+Windows
Openclaw小龙虾搭建指南:U盘版+Mac+Windows最近这段时间,我把自己用了小半年的“小龙虾”(OpenClaw)整个搬进了一只 U 盘。原因很简单:家里一台 Windows 台式机,公司一台 MacBook,两台机器来回倒腾配置实在太累了——今天在这边登录一遍,明天在那边重新配对一遍,时间全花在重复劳动上。干脆做成便携版,插上就能用,拔掉不留痕。
一、先想清楚:为什么要做 U 盘版
很多人第一反应是“装本地不香吗”,香,但要看场景。小龙虾这类工具的特点是需要长期保存配置、凭证和会话记录,一旦换机器,等于从零开始。U 盘版解决的正是这件事。
配置跟着盘走:账号、配对信息、偏好设置全在 U 盘里,换机器不用重新初始化。
不污染宿主机:不在别人电脑上留下缓存和日志,公共机器上用完就拔。
好回滚:升级翻车了?换一只 U 盘就是一套全新环境,主系统毫发无损。
备份省事:整个 U 盘复制一份,就是一次完整备份。
第一步:打开龙虾安装地址:https://top.wokk.cn
第二步:选择Windows10/11或macOS apple、intel芯片下载。
第三步:双击安装包(exe或者dmg文件)等待3分钟。
第四步:打开桌面TopClaw龙虾软件注册登录即可使用
我的经验是:U 盘版最大的价值不是“便携”,而是“隔离”。把运行环境和日常系统隔开,折腾、试错、升级,搞坏了都不心疼。
动手之前有两个硬性建议。第一,U 盘尽量选固态的,USB 3.0 以上,普通低速盘跑起来会明显卡顿。第二,文件系统用 exFAT,Windows 和 macOS 都能读写,别图省事格式化成 NTFS,Mac 那边会很难受。
二、Windows 篇:把运行环境和数据一起塞进 U 盘
Windows 上的核心思路是“免安装 + 环境变量重定向”。别用官方的安装包,那东西会往系统目录和注册表里写东西,等于白折腾。 
把 U 盘格式化为 exFAT,建三个目录:openclaw\node、openclaw\data、openclaw\logs。
下载 Node 运行时的 Windows 免安装压缩包,解压进 node 目录,不要双击安装。
在根目录写一个 start.bat:先把 U 盘上的 node 目录加进 PATH,再把配置目录、用户目录这类环境变量指向 data,最后执行启动命令。
首次运行时按提示完成初始化,确认生成的配置和凭证都落在 data 里,而不是 C 盘。
之后换电脑就简单了:插上 U 盘,双击 start.bat,环境自动就位。具体用哪些环境变量、变量名叫什么,不同版本可能略有差异,建议对照官方文档确认一遍,别照抄网上过期的教程。
提醒一句:路径里尽量别出现中文和空格,U 盘盘符也尽量固定(可以在磁盘管理里手动指定)。另外用完记得先停掉进程再拔盘,直接拔容易把数据文件搞坏。
三、Mac 篇:同一只盘,两套环境共用一份数据
Mac 这边有个绕不开的现实:Node 的二进制包是按系统和芯片架构分的,Windows 的版本在 macOS 上跑不了。所以最省心的方案是——一只 U 盘里放两套运行环境,共用同一份 data 配置目录。
分别下载 macOS 版运行时,注意区分 Apple 芯片和 Intel 芯片两个版本,解压到不同目录。
写一个 start.command 启动脚本,内容思路和 Windows 版一致:设置 PATH、把配置目录指向同一份 data,然后启动。
给脚本加执行权限(chmod +x),第一次运行时如果被系统拦下,右键选择“打开”放行即可。
exFAT 不保存 Unix 权限位,如果脚本怎么都跑不起来,可以把运行时压缩包放在 U 盘上,启动时先解压到本地临时目录,配置继续留在 U 盘。
一句话总结这条路线:程序可以临时落地到本地,数据必须留在 U 盘。只要配置目录不变,换哪台机器都是熟悉的那只小龙虾。
最后说句实在话,U 盘版不是万能的。它牺牲了一点读写性能,换来的是随插随用和数据隔离。如果你本来就固定在一台电脑上干活,老老实实装本地反而更省事;真正值得推荐的是像我这样经常在两三台机器之间切换、又不想每次从头配一遍的人。备一只质量靠谱的固态 U 盘,按上面的思路搭一次,之后每次插上就能直接开工——这种顺手的感觉,用久了真的回不去。
OpenClaw中文版龙虾安装地址:https://top.wokk.cn
一、先想清楚:为什么要做 U 盘版
很多人第一反应是“装本地不香吗”,香,但要看场景。小龙虾这类工具的特点是需要长期保存配置、凭证和会话记录,一旦换机器,等于从零开始。U 盘版解决的正是这件事。
配置跟着盘走:账号、配对信息、偏好设置全在 U 盘里,换机器不用重新初始化。
不污染宿主机:不在别人电脑上留下缓存和日志,公共机器上用完就拔。
好回滚:升级翻车了?换一只 U 盘就是一套全新环境,主系统毫发无损。
备份省事:整个 U 盘复制一份,就是一次完整备份。
第一步:打开龙虾安装地址:https://top.wokk.cn
第二步:选择Windows10/11或macOS apple、intel芯片下载。
第三步:双击安装包(exe或者dmg文件)等待3分钟。
第四步:打开桌面TopClaw龙虾软件注册登录即可使用
我的经验是:U 盘版最大的价值不是“便携”,而是“隔离”。把运行环境和日常系统隔开,折腾、试错、升级,搞坏了都不心疼。
动手之前有两个硬性建议。第一,U 盘尽量选固态的,USB 3.0 以上,普通低速盘跑起来会明显卡顿。第二,文件系统用 exFAT,Windows 和 macOS 都能读写,别图省事格式化成 NTFS,Mac 那边会很难受。
二、Windows 篇:把运行环境和数据一起塞进 U 盘
Windows 上的核心思路是“免安装 + 环境变量重定向”。别用官方的安装包,那东西会往系统目录和注册表里写东西,等于白折腾。

把 U 盘格式化为 exFAT,建三个目录:openclaw\node、openclaw\data、openclaw\logs。
下载 Node 运行时的 Windows 免安装压缩包,解压进 node 目录,不要双击安装。
在根目录写一个 start.bat:先把 U 盘上的 node 目录加进 PATH,再把配置目录、用户目录这类环境变量指向 data,最后执行启动命令。
首次运行时按提示完成初始化,确认生成的配置和凭证都落在 data 里,而不是 C 盘。
之后换电脑就简单了:插上 U 盘,双击 start.bat,环境自动就位。具体用哪些环境变量、变量名叫什么,不同版本可能略有差异,建议对照官方文档确认一遍,别照抄网上过期的教程。
提醒一句:路径里尽量别出现中文和空格,U 盘盘符也尽量固定(可以在磁盘管理里手动指定)。另外用完记得先停掉进程再拔盘,直接拔容易把数据文件搞坏。
三、Mac 篇:同一只盘,两套环境共用一份数据
Mac 这边有个绕不开的现实:Node 的二进制包是按系统和芯片架构分的,Windows 的版本在 macOS 上跑不了。所以最省心的方案是——一只 U 盘里放两套运行环境,共用同一份 data 配置目录。
分别下载 macOS 版运行时,注意区分 Apple 芯片和 Intel 芯片两个版本,解压到不同目录。
写一个 start.command 启动脚本,内容思路和 Windows 版一致:设置 PATH、把配置目录指向同一份 data,然后启动。
给脚本加执行权限(chmod +x),第一次运行时如果被系统拦下,右键选择“打开”放行即可。
exFAT 不保存 Unix 权限位,如果脚本怎么都跑不起来,可以把运行时压缩包放在 U 盘上,启动时先解压到本地临时目录,配置继续留在 U 盘。
一句话总结这条路线:程序可以临时落地到本地,数据必须留在 U 盘。只要配置目录不变,换哪台机器都是熟悉的那只小龙虾。
最后说句实在话,U 盘版不是万能的。它牺牲了一点读写性能,换来的是随插随用和数据隔离。如果你本来就固定在一台电脑上干活,老老实实装本地反而更省事;真正值得推荐的是像我这样经常在两三台机器之间切换、又不想每次从头配一遍的人。备一只质量靠谱的固态 U 盘,按上面的思路搭一次,之后每次插上就能直接开工——这种顺手的感觉,用久了真的回不去。
OpenClaw中文版龙虾安装地址:https://top.wokk.cn