3 分钟快速上手

从 U 盘运行（便携模式）

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

U 盘文件说明

安装到电脑（永久模式）

方法一：从 U 盘安装

双击 Mac-安装到电脑.command 或 Windows-安装到电脑.bat

会将 Node.js + OpenClaw + 依赖复制到 ~/.uclaw/，并添加到系统 PATH

方法二：在线安装（需联网）

# macOS / Linux
curl -fsSL https://u-claw.org/install.sh | bash

# Windows PowerShell
iwr -useb https://u-claw.org/install.ps1 | iex

# npm 国内镜像
npm install -g openclaw@latest --registry https://registry.npmmirror.com

安装后使用

openclaw onboard --install-daemon   # 首次配置
openclaw dashboard                   # 打开控制台

首次配置向导

首次运行自动进入 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