ClawKit 是一个基于 Tauri + React + TypeScript 的本地桌面端项目，把 OpenClaw 变成一个更顺手、更像常规桌面软件的工作台。
- 降低 OpenClaw 日常使用门槛
- 减少频繁切换对话窗口的成本
- 让
agent / 对话 / model / skill / channel / usage这些 OpenClaw 核心对象可视化
当前 OpenClaw 本身已经具备很强的能力，但在桌面端高频使用时，有几个体验问题比较明显：
-
切换对话窗口不够顺手
- 多个会话并行时，需要频繁切换
- 很难像常规桌面软件一样总览当前工作状态
-
agent 和对话的关系不够直观
- OpenClaw 可以配置多个 agent
- 每个 agent 下又可能有多个对话 / session
- 目前这种结构没有很好地体现在界面里
-
skills 和 channel 配置分散
- skill 列表、channel 连接配置、统计信息分散在不同地方
- 不利于集中管理和快速查看
所以 ClawKit 的目标不是替代 OpenClaw，而是做一个 OpenClaw 的本地桌面工作台。
ClawKit 想解决的是以下几类需求：
- 把 OpenClaw 的日常操作组织成更清晰的桌面工作流
- 在一个界面里管理多个 agent 与多个对话
- 让工作中的对话自动排到前面
- 让已关闭的对话不占据主工作区，但仍然保留在左侧资源列表中，方便重新打开
- 可视化管理模型 provider、模型列表和默认模型
- 可视化查看 skills
- 可视化查看 channel 连接状态与配置入口
- 可视化查看 OpenClaw usage
- 提供一键打开本地 OpenClaw 网页入口
核心定位：
ClawKit = OpenClaw 的桌面工作台 / 管理壳，而不是另一个聊天机器人 UI。
- React 19
- TypeScript
- Vite 7
- Tauri 2
- Rust
Rust 端负责 Tauri 命令桥接、OpenClaw Gateway 代理、文件/目录选择、外部终端安装入口等能力。
通用：
- Node.js 22.14+，推荐 Node 24
- pnpm
- Rust / Cargo
macOS：
- Xcode Command Line Tools
- 系统 Terminal 可用
Windows：
- Windows 10/11
- WebView2 Runtime
- Microsoft C++ Build Tools
- PowerShell 可用
OpenClaw：
- ClawKit 运行时依赖本机 OpenClaw Gateway
- 推荐先按官方文档完成 OpenClaw 安装与 onboarding
- 开发环境中也可以使用 OpenClaw 源码仓库，但当前 ClawKit 的安装检测仍以
openclaw命令是否可用为准
安装依赖：
pnpm install启动桌面开发环境：
pnpm tauri dev仅启动前端开发环境：
pnpm dev说明：仅前端模式适合看界面；涉及 Gateway、文件、安装入口、目录选择等能力时，需要运行 Tauri 桌面模式。
仅构建前端：
pnpm build检查 Tauri / Rust 端：
cargo check --manifest-path src-tauri/Cargo.toml1 — 01-install-detect.png · 首次运行与环境检测
2 — 02-openclaw-multi-switch.png · 多会话切换（对照）
3 — 03-clawkit-workspace.png · ClawKit 工作区
4 — 04-tools-flood.png · 高密度工具输出（对照）
5 — 05-tools-collapsed.png · 工具调用折叠
6 — 06-focus-mode.png · 专注模式
7 — 07-create-agent.png · 创建 Agent
8 — 08-edit-agent-md.png · 编辑 Agent 说明
9 — 09-model-config.png · 模型与 Provider
10 — 10-oauth.png · OAuth 授权
11 — 11-wechat-channel.png · 微信通道
12 — 12-usage-global.png · 全局用量
13 — 13-usage-session.png · 会话用量
14 — 14-cron.png · 计划任务
15 — 15-openclaw-update.png · OpenClaw 更新提示
16 — 16-community-pet.png · 桌面伴侣
