laborany

LaborAny — 桌面 AI 工作台

像招聘数字员工一样使用 AI：技能驱动、意图分发、记忆感知。

为什么选 LaborAny · 架构 · 快速开始 · 功能速览 · 致谢 · 许可与贡献 · 免费获取API-Key

Why LaborAny

AI 模型能力越来越强，但普通用户很难稳定地调度和复用它们。LaborAny 把 AI 能力封装为「技能」，让非开发者也能像管理员工一样管理 AI 劳动力。

设计亮点：

技能驱动 — 不是聊天优先，而是任务优先。每个技能是一个可复用的工作单元。
意图分发 — 首页输入自然语言，系统自动识别意图并匹配最合适的技能执行。
记忆感知 — 跨会话上下文记忆，AI 能记住你的偏好和工作习惯。

核心能力：

24 内置技能（文档、写作、数据、研究、运营等）
智能意图分发（自然语言 → 意图识别 → 候选确认 → 执行）
飞书 Bot 远程触发（通过飞书消息远程执行任务，流式卡片回传结果）
QQ Bot 远程触发（通过 QQ 消息远程执行任务，当前支持 C2C 私聊）
丰富文件预览（PDF / DOCX / XLSX / PPTX / 图片 / 音视频 / 代码等）
对话式技能创建（用自然语言描述需求，自动生成新技能）
定时调度（支持 at / every / cron 三种模式）
全局记忆系统（用户画像、工作手册、记忆档案）
跨平台桌面应用（Windows / macOS / Linux）
本地运行，数据不离开你的电脑

Architecture

┌──────────────────────────────────────────────────────────────────┐
│                       Electron Shell                              │
│  ┌────────────────────────────────────────────────────────────┐  │
│  │              Frontend (React + Vite :3000)                  │  │
│  └─────────┬──────────────────────────────┬───────────────────┘  │
│            │ /api/*                       │ /agent-api/*          │
│  ┌─────────▼───────────────┐  ┌──────────▼────────────────────┐  │
│  │  src-api (Hono)         │  │  agent-service (Express)       │  │
│  │  :3620                  │  │  :3002                         │  │
│  │  认证 / 配置 / 技能      │  │  分发 / 执行 / 定时 / 记忆     │  │
│  │  会话 / 文件 / 预览      │  │  ┌────────────┬─────────────┐ │  │
│  └─────────────────────────┘  │  │ Feishu Bot │  Cron Timer  │ │  │
│                                │  │ (WebSocket)│  (动态调度)   │ │  │
│                                │  │  QQ Bot    │              │ │  │
│                                │  │ (WebSocket)│              │ │  │
│                                │  └────────────┴─────────────┘ │  │
│                                └──────────┬────────────────────┘  │
│                                           │                       │
│                                ┌──────────▼────────────────────┐  │
│                                │     Claude Code CLI            │  │
│                                └───────────────────────────────┘  │
└──────────────────────────────────────────────────────────────────┘

        ┌──────────────┐
        │  飞书客户端    │──── WebSocket ────→ agent-service (Feishu Bot)
        └──────────────┘

        ┌──────────────┐
        │  QQ 客户端     │──── WebSocket ────→ agent-service (QQ Bot)
        └──────────────┘

Frontend：React SPA，负责交互与预览渲染
src-api：统一 REST API 层，管理认证、配置、技能、会话、文件、预览
agent-service：AI 执行引擎，负责意图分发、技能执行、定时调度、记忆归纳
Feishu Bot：飞书远程触发入口，通过 WebSocket 接收消息，复用 converse + execute 链路
QQ Bot：QQ 远程触发入口，当前支持 C2C 私聊消息，复用 converse + execute 链路
Cron Timer：动态定时调度，事件驱动，精确唤醒
Claude Code CLI：底层 AI 运行时，所有执行最终通过 CLI 完成

详细设计文档见 docs/ 目录。

Quick Start

下载安装（终端用户）

前往 GitHub Releases 下载对应平台安装包：

Windows：.exe 安装程序
macOS：.dmg 镜像
Linux：.AppImage 或 .deb

首次运行：进入设置页填写 API Key → 回到首页输入任务即可开始。

本地开发（贡献者）

环境要求：Node.js >= 20

git clone https://github.com/laborany/laborany.git
cd laborany
cp .env.example .env        # 编辑 .env 填入 ANTHROPIC_API_KEY
npm run install:all
npm run dev

访问 http://localhost:3000。

打包桌面应用

# Windows
npm run build:electron

# macOS
npm run build:electron:mac

# Linux
npm run build:electron:linux

构建产物输出到 release/ 目录。

Feature Overview

首页分发器

在首页输入自然语言描述你的需求，系统自动完成：

意图识别 — 理解你想做什么
候选匹配 — 从技能库中找到最合适的技能
确认执行 — 确认后进入统一执行面板

支持四种动作：推荐技能、通用执行、创建新技能、设置定时任务。

技能体系

LaborAny 的能力以「技能」为单位组织，支持两种获取方式：

对话式创建：访问 /create 页面，用对话方式描述你需要的能力，系统自动生成完整的技能目录。
引入外部技能：将技能目录复制到用户技能目录即可，系统自动检测并注册。

技能目录结构：

skills/my-skill/
├── SKILL.md         # 主提示词（必须）
├── steps.yaml       # 复合技能步骤（可选）
├── scripts/         # 工具脚本（可选）
├── references/      # 参考资料（可选）
└── assets/          # 资源文件（可选）

飞书 Bot 集成

通过飞书消息远程触发 LaborAny 任务，执行结果以流式卡片实时回传；也支持直接在飞书里创建定时任务，并在任务执行完成后主动把结果推送回创建者私聊。

能力概览：

智能路由 — 复用 converse 意图分发，自动匹配最合适的技能
流式卡片 — 基于 CardKit schema 2.0，实时展示执行过程
文件支持 — 支持图片、文档、音视频等文件的接收与产物回传
定时任务 — 支持自然语言或 /cron 命令创建 cron / at / every 三类调度
命令系统 — /skill、/skills、/cron、/new、/stop、/help

关键环境变量：

FEISHU_ENABLED=true
FEISHU_APP_ID=cli_xxx
FEISHU_APP_SECRET=xxx
FEISHU_ALLOW_USERS=ou_xxx,ou_yyy   # 可选，空=全部允许
FEISHU_DOMAIN=feishu                # feishu 或 lark

详细规范见 docs/feishu-bot-spec.md。

QQ Bot 集成

通过 QQ 消息远程触发 LaborAny 任务，当前仅支持 C2C 私聊场景。

能力概览：

智能路由 — 复用 converse 意图分发，自动匹配最合适的技能
流式消息 — 使用多条消息实时展示执行过程
文件支持 — 支持图片、文件的接收与产物回传
命令系统 — /skill、/skills、/new、/stop、/help、/model、/cron
私聊优先 — 当前仅启用 C2C 私聊链路（更稳定）

注册与接入：

在 QQ 开放平台创建 Bot 应用，获取 AppID 与 AppSecret（推荐）。
在 LaborAny 设置页 QQ Bot 分组中填写配置并保存。
启动后用 QQ 私聊机器人，先发送 /help 验证连接。

配置项（.env 或设置页）：

QQ_ENABLED=true
QQ_APP_ID=your-qq-app-id
QQ_APP_SECRET=your-qq-app-secret   # 推荐，支持自动换取访问令牌
QQ_BOT_TOKEN=your-qq-bot-token     # 可选（与 QQ_APP_SECRET 二选一）
QQ_ALLOW_USERS=user1,user2         # 可选，空=全部允许
QQ_SANDBOX=false                   # 是否使用沙箱环境
QQ_REQUIRE_ALLOWLIST=false         # 为 true 时白名单不能为空
QQ_BOT_NAME=LaborAny
QQ_DEFAULT_SKILL=__generic__

常用命令：

/help 查看帮助
/new 重置会话
/skills 查看技能列表
/skill <id> [query] 指定技能执行
/model [name|id] 查看或切换默认模型
/cron help 查看定时任务命令
/stop 中止当前任务

详细规范见 docs/qq-bot-spec.md。

定时调度

支持三种调度模式：

at — 指定时间点执行一次
every — 按固定间隔重复执行
cron — 标准 cron 表达式

特性：动态定时器（事件驱动，精确唤醒）、手动触发、执行历史、通知推送。定时任务既可在桌面端创建，也可在飞书 Bot 中通过自然语言或 /cron 命令创建；飞书创建的任务默认将结果推送到创建者的飞书私聊。

记忆系统

三层记忆架构：

MemCell（原子记忆） — 每轮对话提炼的最小事实单元
Episode（情节记忆） — 将近期 MemCell 聚类成主题片段
Profile（用户画像） — 稳定偏好与行为模式

前端 /memory 页面提供三面板管理：工作手册（BOSS.md）、我的画像（Profile）、记忆档案（MemCell/Episode）。

文件预览

统一执行面板中栏支持丰富的文件预览：

文档：PDF / DOCX / XLSX / PPTX / Markdown
媒体：图片（PNG/JPG/GIF/SVG）/ 音频 / 视频
代码：语法高亮预览

更多细节见 docs/ 目录。

如何获取 API-Key？

免费！最强模型！请参考 👉API Key 获取和配置教程.

Acknowledgments

Claude Code — Anthropic 官方 CLI
Codex — OpenAI 编码引擎
WorkAny — AI 工作流平台
OpenClaw — 开源智能体框架
EverMemOS — 记忆操作系统

License & Contributing

本项目基于 MIT License 开源。

欢迎贡献：

提交 Issue 报告问题或建议
发起 Pull Request 贡献代码
创建并分享你的自定义技能

Provide feedback

Saved searches

Use saved searches to filter your results more quickly