YouClaw

English | 简体中文 | 日本語

基于多提供商 Coding Agent 运行时的桌面 AI 助手

---

如果 YouClaw 对你有帮助，请给项目点个 GitHub Star。更多的 Star 能帮助更多人发现这个项目。

---

下载与安装

macOS

从 Releases 页面下载 .dmg 文件，打开并直接将 YouClaw 拖入 Applications 文件夹。

支持 Apple Silicon (M1/M2/M3/M4) 及 Intel 芯片。

Windows

从 Releases 页面下载 .exe 安装程序并运行。

Linux

🚧 即将推出 —— 敬请期待！

---

功能特性

• 多 Agent 管理 — 通过 YAML 创建和配置多个 AI Agent，每个 Agent 拥有独立的个性、记忆和技能
• 多渠道接入 — 支持将 Agent 连接至 Telegram、钉钉、飞书、QQ 和企业微信
• 浏览器自动化 — 内置基于 Playwright 的 Agent 浏览器技能，支持网页交互、数据采集和测试
• 定时任务 — 支持 Cron 表达式、固定间隔或一次性任务，具备自动重试和卡死检测功能
• 持久化记忆 — 每个 Agent 拥有独立的记忆系统及对话日志
• 技能系统 — 兼容 OpenClaw SKILL.md 格式，支持三级优先级加载、热重载及技能市场
• 身份认证 — 云端部署内置身份认证系统
• Web UI — 基于 React + shadcn/ui，支持 SSE 流式传输及多语言（中文 / English）
• 轻量级桌面应用 — 基于 Tauri 2 构建，包体积约 27 MB（对比 Electron 的约 338 MB），提供原生系统托盘支持

浏览器配置 (Browser Profiles)

YouClaw 支持三种浏览器驱动配置：

• Managed Chromium — 推荐大多数用户使用
• Remote CDP — 适用于现有的高级自动化环境
• Extension Relay — 高级本地挂载模式，适用于已暴露回环 CDP 端点的浏览器

详细指南：

• English: docs/browser-profiles.md
• 简体中文: docs/browser-profiles.zh.md

技术栈

层级	技术选型
运行时与包管理器	Bun
桌面外壳	Tauri 2 (Rust)
后端	Hono + bun:sqlite + Pino
Agent	@mariozechner/pi-coding-agent + @mariozechner/pi-ai
前端	Vite + React + shadcn/ui + Tailwind CSS
渠道	grammY (Telegram) · dingtalk-stream (钉钉) · @larksuiteoapi/node-sdk (飞书) · QQ · 企业微信
定时任务	croner
E2E 测试	Playwright

架构

┌──────────────────────────────────────────────────────┐
│                Tauri 2 (Rust Shell)                   │
│   ┌──────────────┐    ┌────────────────────────────┐ │
│   │   WebView     │    │   Bun Sidecar              │ │
│   │  Vite+React   │◄──►  Hono API Server           │ │
│   │  shadcn/ui    │ HTTP│  Multi-provider Agent RT  │ │
│   │               │ SSE │  bun:sqlite               │ │
│   └──────────────┘    └────────────────────────────┘ │
└──────────────────────────────────────────────────────┘
         │                        │
    Tauri Store              EventBus
   (settings)          ┌────────┴────────────┐
                        │                     │
                   Web / API         Multi-Channel
                              ┌───────┼───────┐
                           Telegram 钉钉 飞书
                              QQ    企业微信
                                     │
                              浏览器自动化
                               (Playwright)

• 桌面模式：Tauri 启动 Bun 边车（sidecar）进程；WebView 加载前端界面
• Web 模式：Vite 前端 + Bun 后端独立部署
• 三层设计：入口层（Telegram/钉钉/飞书/QQ/企业微信/Web/API）→ 核心层（Agent/调度/记忆/技能）→ 存储层（SQLite/文件系统）

---

在快速开始之前：如果你希望看到 YouClaw 不断改进，请点击 Star。这一个小小的点击能让项目可持续发展。

---

快速开始（开发环境）

前置要求

• Bun >= 1.1
• Rust (用于 Tauri 桌面构建)
• 你所选模型提供商的 API Key

安装与设置

git clone https://github.com/CodePhiliaX/youClaw.git
cd youClaw

# 安装依赖
bun install
cd web && bun install && cd ..

# 配置环境变量
cp .env.example .env
# 编辑 .env 文件并设置 MODEL_API_KEY

Web 模式

# 终端 1 — 后端
bun dev

# 终端 2 — 前端
bun dev:web

打开 http://localhost:5173 · API 地址 http://localhost:62601

桌面模式 (Tauri)

bun dev:tauri

构建桌面应用

bun build:tauri

输出路径：src-tauri/target/release/bundle/ (DMG / MSI / AppImage)

命令列表

bun dev              # 后端开发服务器 (热重载)
bun dev:web          # 前端开发服务器
bun dev:tauri        # Tauri 开发模式 (前端 + 后端 + WebView)
bun start            # 生产环境运行后端
bun typecheck        # 类型检查