U-Claw 操作笔记：从插U盘到跑通，一步步来

跟着官方教程走了一遍，把实操过程记下来了。本文按U-Claw官网教程整理，加了点自己的踩坑记录。

一、先搞清楚这是个啥

U-Claw是OpenClaw的便携版——把整套系统塞进U盘，插上就能用，不用折腾环境变量、不用翻墙，所有依赖都走的国内镜像。

官方教程地址：https://www.u-claw.org/tutorial.html

核心架构就三块：

你的聊天平台 ←→ OpenClaw Gateway ←→ AI 模型
 (QQ/飞书/TG)      (你的电脑)        (DeepSeek/Kimi/Claude)
                         ↕
                    技能 & 工具
              (邮件/笔记/日程/搜索...)

简单说就是：你把AI模型和聊天软件连起来，中间加个能干活的大脑。

二、三种安装方式怎么选

我三种都试了，下面按实操顺序记录。

三、方式A：U盘安装（最省事）

这是官方最推荐的方式，尤其适合不想折腾的人。

操作步骤

1. 插入U-Claw U盘 → 电脑识别后打开
2. 运行启动脚本：
   • Mac：双击 Mac-Start.command
   • Windows：双击 Windows-Start.bat
3. 首次配置：浏览器自动打开配置页面，选模型、填API Key，完成

踩坑提醒

Mac提示“未验证的开发者”：右键脚本 → 打开 → 确认运行即可。

安装到电脑（可选）

如果不想每次都插U盘：

• Mac：双击 Mac-Install.command，安装到 ~/.uclaw/
• Windows：双击 Windows-Install.bat，安装到 %USERPROFILE%\.uclaw\

实测感受：U盘版确实2分钟就能跑起来，适合先体验一下。但如果想长期用，建议装到电脑，省一个USB口。

四、方式B：一键脚本（适合有终端基础的）

如果手头没有U盘，或者想在服务器上装，用这个。

Mac / Linux / WSL2

curl -fsSL https://openclaw.ai/install.sh | bash

Windows (PowerShell 管理员)

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
iwr -useb https://openclaw.ai/install.ps1 | iex

验证安装

openclaw --version    # 看版本号
openclaw onboard      # 启动配置向导

注意：脚本会自动检测国内环境，切换镜像源。我跑的时候没遇到下载慢的问题。

五、方式C：手工安装（开发者路线）

如果你跟我一样，想搞清楚每个组件是怎么工作的，可以走这条路。

第一步：装Node.js 22+

OpenClaw需要Node.js v22以上。不知道怎么查版本的，终端跑 node -v 看一下。

方法A：官网下载（最简单）

• 国内直连：nodejs.cn/download（速度快）
• 官网：nodejs.org/download

下载 .pkg（Mac）或 .msi（Windows）安装包，双击装就行。

方法B：nvm（推荐开发者）

# 1. 安装nvm

转载自CSDN-专业IT技术社区

原文链接：https://blog.csdn.net/cncdns/article/details/159682566