HappyClaw Logo

HappyClaw

自托管多用户 AI Agent 系统

基于 Claude Code 驱动,通过飞书、Telegram 和 Web 随时访问

核心优势

原生 Claude Code 驱动

不是 API Wrapper,直接复用完整运行时。Claude Code 每次升级,HappyClaw 零适配自动受益。

多渠道统一接入

飞书 + Telegram + Web 三端统一。消息路由、状态同步、格式适配一套搞定。

Per-user 完全隔离

独立工作区、独立通道、独立会话、独立记忆。多用户互不干扰。

产品截图

happyclaw.cc
Chat Tool TrackingChat MarkdownChat Image Generation

强大特性

原生 Claude Code 运行时

基于 Claude Agent SDK,底层为完整的 Claude Code CLI 运行时,继承全部能力

多渠道统一接入

飞书 WebSocket + Telegram Bot API + Web 实时通信,消息统一路由

Per-user 完全隔离

独立工作区、IM 通道、会话记忆,每个用户互不干扰

移动端 PWA

iOS/Android 一键安装到桌面,响应式布局,随时随地使用

10 个内置 MCP 工具

消息发送、任务调度、记忆管理,Agent 与主进程双向通信

定时任务调度

Cron 表达式 / 固定间隔 / 一次性执行,完整执行日志

自主记忆系统

用户全局 + 会话 + 日期记忆,全文检索,跨会话持久化

40+ 预装工具链容器

Node.js、Python、Chromium、ffmpeg 等,Docker 隔离执行

企业级安全

RBAC 权限、AES-256-GCM 加密、审计日志、邀请码注册

一键启动

git clone + make start,3 步部署,Web 设置向导完成初始化

技术架构

接入层 飞书 Telegram Web UI 主进程 路由分发 任务队列 会话调度 WebSocket 执行层 宿主机进程 Docker 沙箱 运行时 Claude Agent SDK MCP Tools 流式输出 存储层 SQLite 会话记忆 文件系统
Node.js TypeScript Hono React Vite Tailwind Docker SQLite Claude SDK Zustand

快速开始

只需三步,即可启动你的 AI Agent 系统

Terminal
# 克隆仓库
$ git clone https://github.com/riba2534/happyclaw.git

# 进入目录
$ cd happyclaw

# 一键启动
$ make start

访问 http://localhost:3000 开始使用

前置要求:Node.js >= 20 + Docker

技术栈

N
Node.js
TS
TypeScript
R
React
V
Vite
T
Tailwind CSS
D
Docker
S
SQLite
H
Hono
C
Claude SDK
Z
Zustand