qyclaw

概述

Qyclaw 是一个面向多租户场景的平台化智能体任务平台。它超越了简单的聊天界面或黑盒智能体容器，通过提供完整的分层"智能体操作系统"，确保智能体可运行、可隔离、可审计。

架构分为三层：

• 上层：多用户、多会话、多技能、多连接器的平台能力。
• 中层：运行时编排，包括队列、调度、内存、权限和审计。
• 下层：容器化工具执行沙盒（仅应用于高风险操作）。

核心特性

• 多租户与用户系统：内置用户登录、会话管理、权限控制及管理后台。支持会话级工作空间、技能发布/审核与用户隔离。

• 分层记忆模型：

  • 长期用户记忆（跨会话持久化）
  • 会话私有记忆
  • 候选记忆与完整审计日志，支持可追溯性
  • 集成 Hindsight 实现异步记忆存取与低频反思机制

• 工具、技能与连接器：

  • 系统工具（终端、网页搜索、URL抓取等）
  • 技能：封装行为/工作流，支持草稿发布/分组/共享/复制，作用域涵盖全局、群组、用户或会话
  • MCP连接器：用户私有的外部集成（GitHub、Postgres、Notion、自定义HTTP），支持会话级绑定与隔离

• 安全执行：高风险操作（Shell命令、文件读写、技能脚本、Office/PDF处理）在隔离的Docker容器中运行，核心状态管理保持轻量化与可恢复性

• 多后端支持：按会话动态切换 deepagents、Claude 等后端。平台资产（会话、记忆、技能、审计日志）保持独立，便于灰度更新或故障回退

• 队列与调度：会话级串行队列、全局并发控制、任务重试、定时任务、长时运行任务及人工审批工作流

技术栈

• 后端：Python（主要语言）
• 前端：Vue.js
• 部署：Docker Compose 搭配 PostgreSQL 及沙箱容器
• 配置：基于 YAML 的配置文件（config.yaml / config-docker.yaml）

部署选项

Docker（生产环境推荐）

git clone https://github.com/760485464/qyclaw.git
cd qyclaw
# 编辑 config-docker.yaml 配置后端路由、API密钥等
sh docker_certs.sh
docker compose -f docker-compose-docker.yaml up -d --build

访问前端：http://localhost:8080/frontend/，后端API文档：http://localhost:8000/docs。

本地开发

通过Docker Compose分别启动后端（FastAPI）和前端（Vue），并运行PostgreSQL + 沙箱容器。

使用场景

• 为团队构建内部AI工作台
• 安全的多用户智能体自动化平台
• 可审计的企业AI任务编排系统
• 需要强隔离工具执行环境，同时保持持久化记忆与技能共享的场景

Qyclaw强调安全边界、可审计性与操作可靠性，适用于生产级多租户AI智能体部署。

相关链接

• GitHub: https://github.com/760485464/qyclaw
• 相关项目：Hindsight 记忆整合

（注：此项目与更广泛生态中的 OpenClaw/QClaw 个人助理项目不同。）