3 分钟快速上手

方式一：U 盘便携版（免安装）

方式二：桌面安装版

方式三：开发者自己搭建

git clone https://github.com/dongsheng123132/u-claw.git

# 便携版
cd u-claw/portable && bash setup.sh

# 桌面版
cd u-claw/u-claw-app && bash setup.sh

# 便携版
bash Mac-Start.command   # Mac
Windows-Start.bat        # Windows

# 桌面版
npm run dev

从 U 盘运行（免安装便携模式）

便携模式下，所有配置、API Key、记忆保存在 U 盘的 data/ 目录。换电脑插上 U 盘，配置还在。

U 盘文件说明

目录结构

portable/
├── app/                    ← 运行时（约 2.3GB）
│   ├── core/                  OpenClaw + 依赖 + QQ 插件
│   └── runtime/
│       ├── node-mac-arm64/    Mac Apple Silicon
│       ├── node-win-x64/     Windows 64-bit
├── data/                   ← 用户数据（配置、记忆、备份）
│   ├── .openclaw/             openclaw.json 配置文件
│   ├── memory/                AI 记忆
│   └── backups/               备份
└── [启动脚本和HTML页面]

安装到电脑（桌面版）

桌面版是 Electron 应用，安装后像普通 App 一样使用。自动管理 OpenClaw 网关的启停。

方法一：下载安装包（推荐）

方法二：开发者自己构建

git clone https://github.com/dongsheng123132/u-claw.git
cd u-claw/u-claw-app

# Mac 一键安装（自动下载 Node.js + Electron + 依赖，全部国内镜像）
bash setup.sh

# Windows 一键安装
setup.bat

# 打包
npm run build:mac-arm64  # Mac Apple Silicon → release/U-Claw-x.x.x-arm64.dmg
npm run build:mac-x64    # Mac Intel → release/U-Claw-x.x.x-x64.dmg
npm run build:win        # Windows → release/U-Claw-x.x.x.exe（需在 Windows 上运行）

安装版 vs 便携版

开发者搭建指南

克隆代码库后，一键脚本自动配置完整开发环境。全部依赖从国内镜像下载，无需翻墙。

代码库结构

搭建便携版（U 盘版）

git clone https://github.com/dongsheng123132/u-claw.git
cd u-claw/portable

# 一键搭建（自动下载 Node.js v22 + OpenClaw + QQ 插件）
bash setup.sh

# 启动测试
bash Mac-Start.command   # Mac
# 或双击 Windows-Start.bat  # Windows

搭建桌面版（Electron App）

cd u-claw/u-claw-app

# Mac 一键安装
bash setup.sh

# Windows 一键安装
setup.bat

打包分发

npm run dev              # 开发模式运行
npm run build:mac-arm64  # 打包 Mac ARM64 → release/*.dmg
npm run build:mac-x64    # 打包 Mac Intel → release/*.dmg
npm run build:win        # 打包 Windows → release/*.exe（需在 Windows 上）

制作 U 盘

搭建完便携版后，把整个 portable/ 目录复制到 U 盘即可：

# 搭建完成后
cp -R portable/ /Volumes/你的U盘/U-Claw/

U 盘容量建议 4GB 以上（便携版约 2.3GB）。

环境变量

配置文件格式

{
  "gateway": {"mode": "local", "auth": {"token": "uclaw"}},
  "agent": {
    "model": "deepseek-chat",
    "apiKey": "sk-xxx",
    "baseUrl": "https://api.deepseek.com/v1"
  },
  "channels": {"qqbot": {"token": "appid:secret"}}
}

国内镜像源

U-Claw 的一键脚本默认使用国内镜像，无需翻墙即可完成全部安装。

npm 镜像

手动切换镜像

# 临时使用（推荐）
npm install --registry=https://registry.npmmirror.com

# 永久设置
npm config set registry https://registry.npmmirror.com

# 恢复官方源
npm config set registry https://registry.npmjs.org

Node.js 下载镜像

Electron 下载镜像

setup.sh 已自动设置，手动设置方法：

export ELECTRON_MIRROR="https://npmmirror.com/mirrors/electron/"
export ELECTRON_BUILDER_BINARIES_MIRROR="https://npmmirror.com/mirrors/electron-builder-binaries/"

Git 克隆加速

# 方法一：GitHub 镜像（如果直连慢）
git clone https://ghproxy.com/https://github.com/dongsheng123132/u-claw.git

# 方法二：Gitee 镜像（如果有的话）
git clone https://gitee.com/dongsheng123132/u-claw.git

首次配置向导

首次运行自动进入 onboard 向导：

手动重新运行：openclaw onboard

国产模型（免翻墙）

国际模型

DeepSeek 配置指南

配置步骤

Base URL:  https://api.deepseek.com/v1
API Key:   你的 DeepSeek API Key
Model ID:  deepseek-chat
Alias:     deepseek（可自定义）

API Key 申请：platform.deepseek.com

QQ 机器人接入（1 分钟）

# 安装 QQ 插件
openclaw plugins install @sliverp/qqbot@latest

# 绑定机器人
openclaw channels add --channel qqbot --token "你的AppID:你的AppSecret"

# 设置白名单（重要！）
openclaw config set channels.qqbot.allowFrom "你的QQ号"

# 重启网关
openclaw gateway restart

飞书接入

OpenClaw 内置飞书支持（feishu 命令）。

# 安装飞书插件
openclaw plugins install @larksuiteoapi/feishu-openclaw-plugin

# 运行配置向导
openclaw onboard

详细文档：u-claw.org/docs/channels/feishu

钉钉接入

OpenClaw 内置钉钉连接器。

# 运行配置向导会引导钉钉配置
openclaw onboard

详细文档：u-claw.org/docs/channels/dingtalk

企业微信接入

OpenClaw 内置企业微信 API 支持。

# 运行配置向导
openclaw onboard

详细文档：u-claw.org/docs/channels/wecom

Telegram 接入（最快）

# 1. 在 @BotFather 创建 Bot，获取 Token
# 2. 添加渠道
openclaw channels add --channel telegram --token "你的Bot_Token"
# 3. 重启网关
openclaw gateway restart

全部聊天平台一览

技能概览

U-Claw 预装了 52 个技能，覆盖编程、搜索、文件管理、社交媒体等场景。总大小仅 404KB。

预装技能列表

国内热门技能推荐

以下技能专为国内社交媒体和内容创作设计，可通过 ClawHub 安装。

自媒体运营（6 大平台）

内容创作工具

数据分析与增长

一键安装全部自媒体技能

# 一键安装全部 6 大平台 + 创作工具（推荐）
clawhub install xiaohongshu-ops canghe-post-to-wechat douyin-publisher bilibili-helper weibo-scheduler multi-post copywriter headline-optimizer canghe-xhs-images trending-hot analytics-dashboard

基础效率工具（推荐新手）

技能安装与管理

# 查看已安装技能
openclaw skills list

# 安装新技能
openclaw skills install <skill-name>

# 从 ClawdHub 安装
openclaw skills install clawdhub/<skill-name>

# 创建自定义技能
openclaw skill-creator

网页控制台

启动网关后，浏览器访问：

http://127.0.0.1:18789

控制台功能

• 直接和 AI 聊天（无需其他平台）
• 查看所有渠道状态
• 管理技能和插件
• 查看聊天记录
• 配置模型和参数

手动打开：openclaw dashboard

常用命令速查

环境变量

U-Claw 便携模式通过环境变量把配置指向 U 盘：

诊断修复

# 运行诊断
openclaw doctor

# 强制启动（端口被占用时）
openclaw gateway run --force

# 查看日志
openclaw logs

常见问题排查

• 端口 18789 被占用 — 加 --force 参数
• 控制台打不开 — 先运行 openclaw gateway status 确认网关在跑
• 渠道连不上 — 检查 API Key 是否正确，运行 openclaw status

维护与卸载

U-Claw 的菜单脚本（Mac-Menu / Windows-Menu）内置了完整的维护功能，选择对应编号即可操作。

[9] 杀死残留进程

[10] 查看日志

data/logs/gateway.log

[11] 恢复出厂设置

[12] 完整卸载指南

rm -rf ~/Library/Application\ Support/U-Claw/

rd /s /q "%APPDATA%\U-Claw"

# 卸载 OpenClaw
npm uninstall -g openclaw

# 删除配置和数据
rm -rf ~/.openclaw/

[13] 检查更新

# U 盘便携版
cd app/core && npm update openclaw

# npm 全局安装版
npm update -g openclaw

# 查看当前版本
openclaw --version

[14] 清理空间

# npm 缓存
npm cache clean --force

# 日志
rm -f data/logs/gateway.log

# 备份
rm -rf data/backups/

[15] 插件管理

# 查看已安装插件
openclaw plugin list

# 安装插件
openclaw plugin install <插件名>

# 卸载插件
openclaw plugin uninstall <插件名>

常见问题

🛠️ AI 开发工具推荐

配置好 U-Claw 之后，这些免费工具能帮你进一步提升效率——无论是在终端用 AI 写代码，还是用可视化编辑器开发项目。

🖥️ 终端 AI 工具（CLI）

CLI 工具运行在终端里，适合喜欢命令行操作或想快速完成自动化任务的用户。

uv tool install kimi-cli

📝 AI 编辑器（IDE）

如果你更习惯图形界面，AI 编辑器是更直观的选择。

📊 工具对比

联系我们

有任何问题、建议，或想加入社区，欢迎通过以下方式联系：

💚 微信

扫码添加开发者微信

微信号：hecare888

加好友请备注「U-Claw」

📮 其他联系方式

邮箱	hefangsheng@gmail.com
GitHub	@dongsheng123132
小红书	关注主页
官网	u-claw.org

Linux 启动盘模式

把整个 Linux 系统 + OpenClaw 刻到 U 盘，开机从 USB 启动直接进入 Linux 桌面 + AI 助手。

准备材料

制作启动盘步骤

BIOS/UEFI 设置 USB 启动

首次启动 Linux Mint

# 打开终端 (Ctrl+Alt+T)
sudo apt update
sudo apt install -y language-pack-zh-hans fonts-wqy-microhei

安装 OpenClaw

# 打开终端 (Ctrl+Alt+T)
curl -O https://raw.githubusercontent.com/dongsheng123132/u-claw/main/portable/setup-linux-usb.sh
bash setup-linux-usb.sh

# 1. 安装 Node.js
curl -# -L https://npmmirror.com/mirrors/node/v22.14.0/node-v22.14.0-linux-x64.tar.gz -o /tmp/node.tar.gz
mkdir -p ~/node && tar -xzf /tmp/node.tar.gz -C ~/node --strip-components=1
export PATH="$HOME/node/bin:$PATH"

# 2. 安装 OpenClaw
mkdir -p ~/openclaw && cd ~/openclaw
npm init -y
npm install openclaw@latest --registry=https://registry.npmmirror.com

# 3. 启动
node node_modules/openclaw/openclaw.mjs gateway run --port 18789

日常使用

• 开机选择 USB 启动 → 自动进入 Linux Mint 桌面
• 双击桌面的 U-Claw AI 助手 图标启动
• 浏览器自动打开控制台，开始使用
• 关机前正常关闭 Linux（不要直接拔 U 盘）

常见问题

USB 启动不了

• 检查 BIOS 启动顺序，确保 USB 排在硬盘前面
• 关闭 Secure Boot
• GPT/MBR 选择要匹配电脑的 UEFI/Legacy 模式
• 换一个 USB 口试试（优先 USB 3.0 口）

持久化不生效（重启后配置丢失）

• 确认 Rufus 制作时设置了 Persistent Partition Size（8-16 GB）
• Rufus 版本需要 4.0 以上才支持持久化
• 部分电脑 UEFI 模式下持久化可能有问题，尝试用 MBR + BIOS 模式

运行很慢

• 使用 USB 3.0 或更快的 U 盘
• 避免使用太便宜的 U 盘（随机读写速度太低）
• 推荐品牌：三星 BAR Plus、闪迪 CZ880

中国区原生安装教程

不用 U 盘，直接在中国网络环境下从零安装 OpenClaw。全程使用国内镜像，无需翻墙。

第一步：安装 Node.js

OpenClaw 需要 Node.js v22 或以上版本。

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

• Node.js 中文网：nodejs.cn/download（国内直连，速度快）
• 下载 .pkg（Mac）或 .msi（Windows）安装包，双击安装

方法 B：使用 nvm 版本管理器（推荐开发者）

# 1. 安装 nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.0/install.sh | bash

# 2. 设置 Node.js 国内镜像（关键！否则下载很慢）
export NVM_NODEJS_ORG_MIRROR=https://npmmirror.com/mirrors/node
echo 'export NVM_NODEJS_ORG_MIRROR=https://npmmirror.com/mirrors/node' >> ~/.zshrc

# 3. 安装 Node.js 22
nvm install 22
nvm use 22

# 4. 验证
node -v   # 应显示 v22.x.x

方法 C：使用 fnm（更快的版本管理器，基于 Rust）

# Mac/Linux:
curl -fsSL https://fnm.vercel.app/install | bash

# Windows (PowerShell):
winget install Schniz.fnm

# 设置国内镜像
export FNM_NODE_DIST_MIRROR=https://npmmirror.com/mirrors/node
echo 'export FNM_NODE_DIST_MIRROR=https://npmmirror.com/mirrors/node' >> ~/.zshrc

# 安装 Node.js 22
fnm install 22 && fnm use 22

第二步：设置 npm 国内镜像

安装完 Node.js 后，必须先换镜像源，否则安装 OpenClaw 会超时。

# 推荐：淘宝 npmmirror（最稳定，速度最快）
npm config set registry https://registry.npmmirror.com

# 验证
npm config get registry
# 应返回: https://registry.npmmirror.com/

国内可用的 npm 镜像源

使用 nrm 快速切换镜像

# 安装 nrm 镜像源管理工具
npm install -g nrm

nrm ls          # 查看所有可用镜像源
nrm use taobao  # 一键切换淘宝源
nrm test        # 测速，看哪个最快

第三步：安装 OpenClaw

# 全局安装
npm install -g openclaw@latest

# 如果超时，手动指定镜像：
npm install -g openclaw@latest --registry=https://registry.npmmirror.com

# 验证
openclaw --version

第四步：配置国产 AI 模型

启动配置向导：

# 启动引导向导 + 安装后台守护进程
openclaw onboard --install-daemon

# 或只启动引导向导
openclaw onboard

国产模型注册与配置

配置示例（DeepSeek）

# 在配置向导中：
# 1. 选择 Custom Provider
# 2. 填写：
#    API Base URL: https://api.deepseek.com/v1
#    API Key: sk-xxxxxxxx（在 platform.deepseek.com 获取）
#    Model: deepseek-chat

第五步：启动与验证

# 启动网关
openclaw gateway run

# 查看状态
openclaw gateway status

# 浏览器打开控制台
# http://127.0.0.1:18789

常见问题

npm install 超时 / ECONNREFUSED

# 1. 确认镜像源已切换
npm config get registry
# 应该是 https://registry.npmmirror.com/

# 2. 如果还超时，试其他镜像
npm config set registry https://mirrors.cloud.tencent.com/npm/

# 3. 清除缓存重试
npm cache clean --force
npm install -g openclaw@latest

node: command not found

# 重新打开终端，或手动加载配置
source ~/.zshrc   # macOS
source ~/.bashrc  # Linux

openclaw onboard 报错

# 确认 Node.js 版本
node -v  # 需要 v22+

# 如果版本太低
nvm install 22 && nvm use 22
# 或
fnm install 22 && fnm use 22

API 调用失败

• 检查 API Key 是否正确（注意不要多余空格）
• 检查 API Base URL 是否正确
• 确认模型名称正确（如 deepseek-chat）
• 国产模型 API 直连，不需要翻墙