Appearance
第六章:OneClaw 桌面版
不用命令行,也能拥有强大的 AI 助手。
本章概览
在这一章中,你将了解:
- OneClaw 是什么,它和 OpenClaw CLI 版本的关系
- 如何下载和安装 OneClaw
- 首次设置:配置 LLM Provider 和 API Key
- 日常使用的完整操作指南
- OneClaw 的适用人群
- CLI 版本和桌面版的详细对比
本章适合谁?
如果你对命令行操作不太熟悉,或者就是喜欢图形界面的操作方式,这一章就是专门为你准备的。即使你已经使用了 CLI 版本,了解 OneClaw 也能帮你向非技术同事推荐这个工具。
6.1 什么是 OneClaw?
一句话解释
OneClaw 是 OpenClaw 的桌面应用包装版 -- 它把 OpenClaw 的所有功能打包成了一个可以直接双击打开的桌面应用程序。
用一个比喻来理解
OpenClaw CLI(命令行版本):
相当于手动挡汽车
- 更灵活,可以精确控制每个细节
- 但需要会"踩离合、换挡"(命令行操作)
OneClaw(桌面版):
相当于自动挡汽车
- 上手简单,踩油门就走
- 功能一样强大
- 不需要知道"离合"是什么OneClaw 的核心理念
OneClaw 的诞生是为了解决一个现实问题:OpenClaw 非常好用,但安装和配置过程对非技术用户不友好。
安装 OpenClaw CLI 需要:
安装 Node.js使用 npm 命令在终端中操作编辑 YAML 配置文件
OneClaw 把这些全部隐藏了,你只需要:
- 下载安装包
- 双击安装
- 在图形界面中填写配置
- 开始使用
项目信息
| 信息 | 详情 |
|---|---|
| 项目名称 | OneClaw |
| GitHub 地址 | github.com/oneclaw/oneclaw |
| 基于 | OpenClaw 核心引擎 |
| 开发框架 | Electron |
| 支持平台 | macOS / Windows / Linux |
| 开源协议 | MIT License |
| 定位 | 面向非技术用户的 OpenClaw 桌面客户端 |
6.2 安装 OneClaw
macOS 安装
第一步:下载
- 打开浏览器,访问 github.com/oneclaw/oneclaw/releases
- 找到最新版本(Latest Release)
- 在 Assets 列表中,下载
.dmg文件- Intel Mac:选择
OneClaw-x.x.x-x64.dmg - Apple Silicon Mac (M1/M2/M3/M4):选择
OneClaw-x.x.x-arm64.dmg
- Intel Mac:选择
不确定自己是 Intel 还是 Apple Silicon?
点击左上角的苹果菜单 → "关于本机":
- 如果显示 "芯片" 是 "Apple M1/M2/M3/M4",选择 arm64 版本
- 如果显示 "处理器" 是 "Intel",选择 x64 版本
第二步:安装
- 双击打开下载的
.dmg文件 - 你会看到一个窗口,里面有 OneClaw 图标和 Applications 文件夹
- 把 OneClaw 图标拖到 Applications 文件夹
┌──────────────────────────────────────┐
│ │
│ 🐾 OneClaw → 📁 Applications │
│ │
│ 把左边拖到右边即可 │
└──────────────────────────────────────┘第三步:首次打开
- 打开 "访达"(Finder)→ "应用程序"(Applications)
- 找到 OneClaw,双击打开
首次打开可能会提示安全警告
由于 OneClaw 是开源项目,没有 Apple 的开发者签名,macOS 可能会提示:
"无法打开 OneClaw,因为无法验证开发者"
解决方法:
- 点击"取消"
- 打开 系统偏好设置 → 安全性与隐私 → 通用
- 你会看到 "OneClaw 被阻止打开" 的提示
- 点击 "仍然打开"
- 在弹出的对话框中再次点击 "打开"
以后就不会再弹出这个提示了。
Windows 安装
第一步:下载
- 访问 github.com/oneclaw/oneclaw/releases
- 下载最新的
OneClaw-Setup-x.x.x.exe
第二步:安装
- 双击运行下载的
.exe文件 - 如果弹出 "Windows 保护了你的电脑" 的 SmartScreen 提示:
- 点击 "更多信息"
- 点击 "仍要运行"
- 按照安装向导的提示操作
- 安装完成后,勾选 "启动 OneClaw"
第三步:启动
- 从开始菜单中找到 OneClaw
- 或者双击桌面快捷方式
Linux 安装
AppImage 方式(推荐):
bash
# 下载 AppImage
# 访问 github.com/oneclaw/oneclaw/releases 下载
# 添加执行权限
chmod +x OneClaw-x.x.x.AppImage
# 运行
./OneClaw-x.x.x.AppImageDeb 包方式(Ubuntu/Debian):
bash
# 下载 .deb 包后
sudo dpkg -i oneclaw_x.x.x_amd64.deb6.3 首次设置
欢迎界面
第一次打开 OneClaw,你会看到一个友好的欢迎界面:
┌─────────────────────────────────────────────────┐
│ │
│ 🐾 欢迎使用 OneClaw │
│ │
│ 你的个人 AI 助手,就在桌面上。 │
│ │
│ 让我们花 2 分钟完成初始设置。 │
│ │
│ │
│ [ 开始设置 →] │
│ │
└─────────────────────────────────────────────────┘第一步:选择 LLM Provider
点击"开始设置"后,第一步是选择你要使用的 AI 后端:
┌─────────────────────────────────────────────────┐
│ │
│ 第 1 步:选择 AI 引擎 │
│ │
│ ┌─────────────────────────────────────────┐ │
│ │ ○ Claude (Anthropic) │ │
│ │ 推荐 · 综合能力最强 │ │
│ │ │ │
│ │ ○ GPT (OpenAI) │ │
│ │ 广受欢迎 · 生态丰富 │ │
│ │ │ │
│ │ ○ DeepSeek │ │
│ │ 性价比高 · 中文表现好 │ │
│ │ │ │
│ │ ○ Ollama (本地模型) │ │
│ │ 完全免费 · 无需网络 │ │
│ └─────────────────────────────────────────┘ │
│ │
│ [← 上一步] [下一步 →] │
│ │
└─────────────────────────────────────────────────┘不知道选哪个?
- 如果你已经有某个平台的 API Key,就选那个
- 如果你什么都没有,推荐选 Claude 或 DeepSeek
- 如果你完全不想花钱,选 Ollama
第二步:输入 API Key
选择 Provider 后,需要输入对应的 API Key:
┌─────────────────────────────────────────────────┐
│ │
│ 第 2 步:输入 API Key │
│ │
│ 你选择了 Claude (Anthropic) │
│ │
│ API Key: │
│ ┌─────────────────────────────────────────┐ │
│ │ sk-ant-api03-************************* │ │
│ └─────────────────────────────────────────┘ │
│ │
│ 🔒 你的 API Key 安全地存储在本地, │
│ 不会上传到任何服务器。 │
│ │
│ 还没有 API Key? │
│ [点击这里了解如何获取 →] │
│ │
│ [← 上一步] [验证并继续 →] │
│ │
└─────────────────────────────────────────────────┘点击"验证并继续"后,OneClaw 会自动验证你的 API Key 是否有效:
✅ API Key 验证成功!连接到 Claude Sonnet。第三步:选择模型
┌─────────────────────────────────────────────────┐
│ │
│ 第 3 步:选择模型 │
│ │
│ ┌─────────────────────────────────────────┐ │
│ │ ● Claude Sonnet(推荐) │ │
│ │ 速度快、效果好、性价比高 │ │
│ │ │ │
│ │ ○ Claude Opus │ │
│ │ 最强能力、适合复杂任务、费用较高 │ │
│ │ │ │
│ │ ○ Claude Haiku │ │
│ │ 最快速度、适合简单任务、费用最低 │ │
│ └─────────────────────────────────────────┘ │
│ │
│ [← 上一步] [下一步 →] │
│ │
└─────────────────────────────────────────────────┘第四步:设置完成
┌─────────────────────────────────────────────────┐
│ │
│ 🎉 设置完成! │
│ │
│ 你的 AI 助手已经准备好了。 │
│ │
│ AI 引擎: Claude Sonnet │
│ 模型: claude-sonnet-4-20250514 │
│ 状态: ✅ 已连接 │
│ │
│ 接下来你可以: │
│ · 直接在 OneClaw 中和 AI 对话 │
│ · 连接聊天平台(Telegram、WhatsApp 等) │
│ · 安装更多 Skills 扩展功能 │
│ │
│ [开始使用 OneClaw →] │
│ │
└─────────────────────────────────────────────────┘6.4 OneClaw 主界面
界面布局
设置完成后,你会进入 OneClaw 的主界面:
┌──────────────────────────────────────────────────────────┐
│ 🐾 OneClaw ─ □ × │
├──────────┬───────────────────────────────────────────────┤
│ │ │
│ 💬 对话 │ 和 AI 助手对话 │
│ │ │
│ 🔌 平台 │ ┌──────────────────────────────────────┐ │
│ │ │ AI: 你好!我是你的 AI 助手。 │ │
│ 🛠 技能 │ │ 有什么我可以帮你的吗? │ │
│ │ └──────────────────────────────────────┘ │
│ 🧠 记忆 │ │
│ │ │
│ 📊 统计 │ │
│ │ │
│ ⚙️ 设置 │ │
│ │ ┌──────────────────────────────────────┐ │
│ │ │ 输入消息... [发送] │ │
│ │ └──────────────────────────────────────┘ │
│ │ │
└──────────┴───────────────────────────────────────────────┘界面分为两个主要区域:
左侧导航栏:
- 对话 -- 直接和 AI 聊天
- 平台 -- 管理连接的聊天平台
- 技能 -- 管理 Skills
- 记忆 -- 查看和管理 AI 的记忆
- 统计 -- 使用统计数据
- 设置 -- 应用程序设置
右侧内容区:
- 根据左侧选择显示不同内容
- 默认显示对话界面
6.5 基本使用流程
直接对话
最简单的使用方式就是直接在 OneClaw 中和 AI 对话:
你: 帮我写一个产品周报的模板
AI: 好的!这是一个产品周报模板:
## 产品周报 - 第 X 周(X月X日 - X月X日)
### 本周重点
-
### 进行中的项目
| 项目 | 进度 | 状态 | 备注 |
|------|------|------|------|
| | | | |
### 关键指标
- DAU:
- 新注册用户:
- 转化率:
### 下周计划
1.
2.
3.
### 需要的支持
-
需要我调整模板的结构吗?连接聊天平台
点击左侧的"平台"图标,进入平台管理页面:
┌──────────────────────────────────────────────────────────┐
│ 🔌 聊天平台 │
│ │
│ 已连接的平台: │
│ (暂无) │
│ │
│ 可添加的平台: │
│ │
│ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐ │
│ │ 📱 Telegram │ │ 💬 WhatsApp │ │ 💼 Slack │ │
│ │ [添加] │ │ [添加] │ │ [添加] │ │
│ └──────────────┘ └──────────────┘ └──────────────┘ │
│ │
│ ┌──────────────┐ ┌──────────────┐ │
│ │ 🎮 Discord │ │ ➕ 其他 │ │
│ │ [添加] │ │ [添加] │ │
│ └──────────────┘ └──────────────┘ │
│ │
└──────────────────────────────────────────────────────────┘点击"添加"后,OneClaw 会弹出一个引导式对话框,一步一步教你完成配置。
以 Telegram 为例:
┌─────────────────────────────────────────────────┐
│ │
│ 添加 Telegram │
│ │
│ 第 1 步:创建 Telegram Bot │
│ │
│ 1. 打开 Telegram │
│ 2. 搜索 @BotFather │
│ 3. 发送 /newbot │
│ 4. 按照提示操作,获取 Bot Token │
│ │
│ [查看详细教程(附截图)→] │
│ │
│ Bot Token: │
│ ┌─────────────────────────────────────────┐ │
│ │ 123456789:ABCdefGHIjklMNOpqrsTUVwxyz │ │
│ └─────────────────────────────────────────┘ │
│ │
│ 你的 Telegram User ID: │
│ ┌─────────────────────────────────────────┐ │
│ │ 87654321 │ │
│ └─────────────────────────────────────────┘ │
│ [不知道?点击这里了解如何获取] │
│ │
│ [取消] [连接 Telegram →] │
│ │
└─────────────────────────────────────────────────┘管理 Skills
点击"技能"图标,进入 Skills 管理页面:
┌──────────────────────────────────────────────────────────┐
│ 🛠 Skills 管理 │
│ │
│ 已安装 [浏览 ClawHub →] │
│ │
│ ┌─────────────────────────────────────────────────┐ │
│ │ 📂 File Manager 内置 ✅ 已启用 [设置] │ │
│ ├─────────────────────────────────────────────────┤ │
│ │ 🌐 Web Browse 内置 ✅ 已启用 [设置] │ │
│ ├─────────────────────────────────────────────────┤ │
│ │ 📝 Memo 内置 ✅ 已启用 [设置] │ │
│ ├─────────────────────────────────────────────────┤ │
│ │ 🖥 Shell 内置 ❌ 未启用 [启用] │ │
│ ├─────────────────────────────────────────────────┤ │
│ │ 📧 Email Sender v1.2.0 ✅ 已启用 [设置] │ │
│ └─────────────────────────────────────────────────┘ │
│ │
│ 推荐安装 │
│ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐ │
│ │ 📅 Calendar │ │ 📋 Todo │ │ 🌐 Translator│ │
│ │ ★ 4.8 · 免费 │ │ ★ 4.6 · 免费 │ │ ★ 4.5 · 免费 │ │
│ │ [安装] │ │ [安装] │ │ [安装] │ │
│ └──────────────┘ └──────────────┘ └──────────────┘ │
│ │
└──────────────────────────────────────────────────────────┘查看记忆
┌──────────────────────────────────────────────────────────┐
│ 🧠 AI 记忆 [搜索...] │
│ │
│ 共 12 条记忆 [清空全部] │
│ │
│ ┌─────────────────────────────────────────────────┐ │
│ │ #1 个人信息 │ │
│ │ "用户叫张三,是一名产品经理" │ │
│ │ 来源: Telegram · 2025-01-10 · 重要度: ★★★ │ │
│ │ [编辑] [删除] │ │
│ ├─────────────────────────────────────────────────┤ │
│ │ #2 工作相关 │ │
│ │ "正在开发电商平台,预计 Q2 上线" │ │
│ │ 来源: WhatsApp · 2025-01-12 · 重要度: ★★★ │ │
│ │ [编辑] [删除] │ │
│ ├─────────────────────────────────────────────────┤ │
│ │ #3 偏好 │ │
│ │ "喜欢简洁的回复风格" │ │
│ │ 来源: Telegram · 2025-01-13 · 重要度: ★★ │ │
│ │ [编辑] [删除] │ │
│ └─────────────────────────────────────────────────┘ │
│ │
└──────────────────────────────────────────────────────────┘设置页面
┌──────────────────────────────────────────────────────────┐
│ ⚙️ 设置 │
│ │
│ AI 引擎 │
│ ┌─────────────────────────────────────────────────┐ │
│ │ Provider: Claude (Anthropic) [更换] │ │
│ │ Model: Claude Sonnet [更换] │ │
│ │ API Key: sk-ant-***...*** [更换] │ │
│ │ 状态: ✅ 已连接 │ │
│ └─────────────────────────────────────────────────┘ │
│ │
│ 助手设置 │
│ ┌─────────────────────────────────────────────────┐ │
│ │ 名字: My Assistant [修改] │ │
│ │ 语言: 中文 [修改] │ │
│ │ 个性提示词: [编辑] │ │
│ │ "你是一个友好的 AI 助手..." │ │
│ └─────────────────────────────────────────────────┘ │
│ │
│ 通用设置 │
│ ┌─────────────────────────────────────────────────┐ │
│ │ ☑ 开机自动启动 │ │
│ │ ☑ 启动时最小化到系统托盘 │ │
│ │ ☑ 收到消息时显示通知 │ │
│ │ ☐ 启用调试日志 │ │
│ └─────────────────────────────────────────────────┘ │
│ │
│ 关于 │
│ ┌─────────────────────────────────────────────────┐ │
│ │ OneClaw v1.2.0 │ │
│ │ OpenClaw Engine v3.5.0 │ │
│ │ [检查更新] [查看日志] [导出配置] │ │
│ └─────────────────────────────────────────────────┘ │
│ │
└──────────────────────────────────────────────────────────┘6.6 OneClaw 的特色功能
系统托盘常驻
OneClaw 可以最小化到系统托盘(Windows 的任务栏右下角 / macOS 的菜单栏),在后台安静运行。
系统托盘图标:🐾
右键菜单:
┌──────────────────┐
│ 打开 OneClaw │
│ ──────────────── │
│ 状态: 运行中 │
│ 平台: Telegram ✅│
│ ──────────────── │
│ 暂停 │
│ 设置 │
│ 退出 │
└──────────────────┘桌面通知
当收到新消息时,OneClaw 会弹出桌面通知:
┌──────────────────────────────────┐
│ 🐾 OneClaw · Telegram │
│ │
│ 你有新消息: │
│ "明天下午的会议改到 3 楼了" │
│ │
│ [查看] [忽略] │
└──────────────────────────────────┘自动更新
OneClaw 内置了自动更新机制:
┌──────────────────────────────────┐
│ 🐾 OneClaw 更新可用 │
│ │
│ 新版本: v1.3.0 │
│ 当前版本: v1.2.0 │
│ │
│ 更新内容: │
│ · 新增 Discord 平台支持 │
│ · 修复 WhatsApp 消息延迟问题 │
│ · 性能优化 │
│ │
│ [稍后提醒] [立即更新] │
└──────────────────────────────────┘对话导出
你可以把和 AI 的对话导出为文件:
导出格式选择:
○ Markdown (.md)
○ PDF (.pdf)
○ 纯文本 (.txt)
○ JSON (.json)这在你需要归档重要对话或分享给同事时非常有用。
6.7 OneClaw 的适用人群
最适合的用户画像
用户 A:产品经理小王
背景: 不会写代码,日常使用 Telegram 和 Slack
需求: 想要一个 AI 助手帮忙处理日常工作
选择: OneClaw ✅
原因: 图形界面操作,不需要命令行用户 B:市场部主管李姐
背景: 完全不懂技术,不知道什么是 Terminal
需求: 听说 AI 很强大,想试试
选择: OneClaw ✅
原因: 下载安装就能用,和装微信一样简单用户 C:创业公司 CEO
背景: 有一定技术认知但不想花时间折腾
需求: 快速部署一个 AI 助手给团队用
选择: OneClaw ✅(但 CLI 版也可以)
原因: 快速上手,专注于业务而非配置不太适合的场景
虽然 OneClaw 很好用,但以下场景可能更适合 CLI 版本:
场景 1: 部署到云服务器
→ 服务器没有图形界面,需要用 CLI 或 Docker
场景 2: 需要精细化配置
→ 高级配置选项在 OneClaw 中可能还没有图形化
场景 3: 开发自定义 Skills
→ 开发工作需要在终端中进行
场景 4: 自动化脚本集成
→ 需要和其他命令行工具配合使用6.8 CLI 版本 vs OneClaw 桌面版
功能对比
| 功能 | CLI 版本 | OneClaw 桌面版 |
|---|---|---|
| 安装方式 | npm install -g | 下载安装包 |
| 需要 Node.js | 是 | 否(内置) |
| 需要命令行 | 是 | 否 |
| 图形界面 | 无 | 有 |
| 配置方式 | 编辑 YAML 文件 | 图形界面表单 |
| AI 对话 | openclaw chat | 内置对话窗口 |
| 平台管理 | 命令行操作 | 可视化面板 |
| Skills 管理 | 命令行操作 | 可视化商店 |
| 记忆管理 | 命令行操作 | 可视化列表 |
| 后台运行 | --daemon | 系统托盘 |
| 开机自启 | 手动配置 | 一键开启 |
| 自动更新 | openclaw update | 自动检测更新 |
| 桌面通知 | 无 | 有 |
| 对话导出 | 手动操作 | 一键导出 |
| 适合人群 | 技术用户 | 所有用户 |
核心引擎是同一个
重要的是要理解:OneClaw 的底层引擎和 CLI 版本完全相同。
CLI 版本:
用户 → Terminal → OpenClaw Engine → LLM
OneClaw:
用户 → 图形界面 → OpenClaw Engine → LLM
↑
(只有这一层不同)这意味着:
- 两个版本的 AI 能力完全一样
- 两个版本支持的 Skills 完全一样
- 两个版本的平台集成完全一样
- 唯一的区别是交互方式(命令行 vs 图形界面)
数据互通
如果你先用了 CLI 版本,后来切换到 OneClaw(或反过来),你的数据是完全互通的,因为它们共享同一个 ~/.openclaw/ 目录:
~/.openclaw/ ← 两个版本共用这个目录
├── config.yaml ← 配置文件(两边都能读写)
├── conversations/ ← 对话历史(共享)
├── memory/ ← 记忆数据(共享)
├── skills/ ← Skills(共享)
└── gateway/ ← 平台配置(共享)可以同时使用两个版本吗?
理论上可以,但不建议同时运行。因为两个版本会共享同一个 Gateway 端口和配置文件,同时运行可能导致端口冲突。
推荐做法:选择一个版本作为主力使用。
选择建议
你应该选择 CLI 版本,如果你:
✓ 熟悉命令行操作
✓ 需要部署到服务器
✓ 想要最大的灵活性和控制力
✓ 需要与其他命令行工具集成
✓ 想要开发自定义 Skills
你应该选择 OneClaw 桌面版,如果你:
✓ 不熟悉命令行
✓ 想要最简单的上手体验
✓ 喜欢图形化操作
✓ 需要桌面通知功能
✓ 想向非技术同事推荐6.9 常见问题
OneClaw 会收费吗?
OneClaw 本身是免费开源的。但你使用的 LLM 服务(Claude、GPT 等)需要按量付费。如果使用 Ollama 本地模型,则完全免费。
OneClaw 和直接用 ChatGPT 网页版有什么区别?
主要区别:
- 多平台集成 -- OneClaw 可以接入 Telegram、WhatsApp 等,ChatGPT 只能在网页上用
- 持久化记忆 -- OneClaw 记得你之前说过的话
- Skills 扩展 -- OneClaw 可以执行实际任务(发邮件、管理文件等)
- 数据本地化 -- 你的数据存在自己电脑上
- 多 LLM 支持 -- 你可以自由选择使用哪个 AI 后端
OneClaw 的系统托盘图标消失了怎么办?
- Windows:检查系统托盘是否有隐藏图标(点击任务栏右下角的 ^ 箭头)
- macOS:检查菜单栏是否被其他图标挤掉(可能需要扩大菜单栏空间)
- 如果真的退出了:重新从应用列表中打开 OneClaw
可以把 OneClaw 推荐给完全不懂技术的朋友吗?
完全可以!这正是 OneClaw 存在的意义。唯一需要提前准备的是一个 LLM 的 API Key(或者教他们用 Ollama 本地模型)。
你可以帮他们完成初始设置,之后他们就可以独立使用了。
OneClaw 支持中文界面吗?
OneClaw 的界面语言跟随系统语言设置。如果你的操作系统是中文,OneClaw 也会显示中文界面。你也可以在设置中手动切换语言。
本章小结
在这一章中,我们详细介绍了:
- OneClaw 是什么 -- OpenClaw 的桌面应用包装版,面向非技术用户
- 安装过程 -- 下载 → 安装 → 打开,就像安装任何普通应用一样简单
- 首次设置 -- 选择 LLM Provider → 输入 API Key → 选择模型 → 完成
- 日常使用 -- 对话、平台管理、Skills 管理、记忆查看,全部图形化操作
- 特色功能 -- 系统托盘、桌面通知、自动更新、对话导出
- 与 CLI 版本的对比 -- 底层引擎相同,区别只在于交互方式
课程总结
恭喜你完成了 OpenClaw 系列课程的全部六章内容!让我们回顾一下你学到了什么:
- 第一章 -- 了解了 OpenClaw 的背景、理念和定位
- 第二章 -- 掌握了三种安装方式和配置方法
- 第三章 -- 理解了 Gateway 消息路由架构
- 第四章 -- 学会了将 AI 接入各种聊天平台
- 第五章 -- 了解了 Skills 生态和持久化记忆
- 第六章 -- 掌握了 OneClaw 桌面版的使用方法
无论你是想自己使用 AI 助手提升效率,还是想为团队引入 AI 工具,OpenClaw/OneClaw 都是一个值得尝试的选择。
继续探索
- OpenClaw 官方文档:openclaw.dev/docs
- OneClaw 下载页面:github.com/oneclaw/oneclaw/releases
- 社区 Discord:加入社区和其他用户交流
- ClawHub Skills 市场:发现更多有趣的 Skills
返回 课程目录