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 / Linux 一键安装（自动下载 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 / Linux 一键安装
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

常见问题

联系我们

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

💚 微信

扫码添加开发者微信

微信号：hecare888

加好友请备注「U-Claw」

📮 其他联系方式

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