HappyClaw

它是什么

HappyClaw 是一个自托管、多用户平台，可让您将 Claude Code 代理（Anthropic 的“Claude Agent SDK”）作为长期运行的服务。它将官方的 Claude Code 运行时封装在 Node.js/TypeScript 服务器中，并通过 Web UI 和 8 个即时通讯渠道（飞书、Telegram、QQ、钉钉、微信、企业微信、Discord、WhatsApp）公开代理。用户可以创建代理、将其分配到隔离的工作区，并让这些代理执行代码、运行 shell 命令、浏览网页或调用自定义的 Skills/MCP。

核心功能

领域	提供内容
代理优先的工作流	创建、编辑、版本管理和恢复 Claude 代理；附加自定义提示词、Skills、MCP 和插件。
工作区	隔离的文件系统目录；可以在宿主机（管理员）或非 root Docker 容器（普通用户）中运行。
多渠道访问	面向飞书、Telegram、QQ、钉钉、微信、企业微信、Discord、WhatsApp 和 Web PWA 的统一消息集成。
提供商管理	配置多个 Anthropic 或兼容的 Claude 端点；负载均衡（轮询、加权、故障转移）、健康检查和会话粘性路由。
调度	Cron 风格、固定间隔或一次性任务，可运行代理或 shell 脚本，具有幂等运行 ID 和可重试通知。
内存与文件处理	工作区范围的内存存储、版本化的文件编辑、CAS 风格更新、搜索和终端访问。
使用量与计费	按代理、工作区和模型进行 Token 级核算；支持 CSV 导出、配额、订阅和兑换码。
运营与安全	RBAC、邀请注册、审计日志、Docker 镜像管理、备份/恢复、机密加密存储。
客户端体验	实时流式输出、工具追踪可视化、Markdown/Mermaid/KaTeX 渲染、响应式 UI 和 PWA 支持。

谁可能会用

想要一个私有的、可控的 Claude Code 环境，而不是公共聊天 API 的团队。
需要运行 AI 驱动的自动化（代码审查、CI 辅助、数据提取）并能从内部聊天工具触发这些自动化的公司。
希望尝试 Claude 代理同时保持执行隔离在 Docker 容器中的开发人员。
需要细粒度权限控制、使用量跟踪以及能够在本地托管整个栈的组织。

快速入门

克隆并启动 – git clone https://github.com/riba2534/happyclaw.git && cd happyclaw && make start。
在 http://localhost:3000 打开 Web UI，并按照向导创建管理员账户。
在 设置 → 模型和提供商 中添加 Anthropic（或兼容）的 Claude 提供商。
（可选）在 设置 → 消息频道 下连接一个或多个即时通讯频道。
创建一个 工作区，选择 宿主机（管理员）或容器（普通用户）执行模式。
构建一个代理（Claude Code）——给它一个名称、头像、提示词，并附加您需要的任何 Skills 或 MCP。
打开会话（或绑定频道）并开始聊天——代理可以读/写文件、运行 shell 命令、浏览网页等。

架构概览

Web/PWA  →  HappyClaw Node 服务 (Hono, WebSocket, SQLite)
   │                │
   ├─ Auth/RBAC    ├─ Router & Scheduler
   │                │
   └─ Provider pool (Claude endpoints)
        │
        ├─ Host Runner (direct CLI)
        └─ Docker Agent Runner (isolated containers)
                │
                └─ Claude Agent SDK + Claude Code CLI

核心服务处理认证、消息路由、任务调度和持久化。代理执行被委派给宿主机（管理员批准的目录）或运行锁定版本 Claude Code 运行时的 Docker 容器。

许可与社区

许可证: MIT（见 LICENSE）。
星标: ⭐ — 仓库显示 GitHub 星标徽章。
贡献: 指南位于 README 的贡献部分；欢迎提交 issue 或 pull request。
文档: API 参考、运行时架构、ACL 矩阵和部署指南在 docs/ 文件夹和官方网站 https://happyclaw.cc/ 中提供。

以上所有信息均直接取自项目 README；未推断任何附加功能。

riba2534/happyclaw