MultiUserClaw 是一个多用户 AI SaaS Hermes Agent 平台，基于 Hermes 改造的轻量级 AI 助手框架，目标是帮助用户快速打造商用 SaaS 平台。根据仓库说明，目前 OpenClaw 和 NanoBot 都是面向个人使用、不太支持多用户，该项目基于多用户需求重新修改 Bot，未对 OpenClaw 进行任何更改，属于原生能力封装。
一、用途 该平台用于搭建支持多租户隔离的 AI 助手服务，支持多平台渠道接入、工具调用、定时任务和 Web 实时通信，可作为商用 SaaS 平台的基础框架。
二、主要能力 平台支持创建、配置和管理多个 AI Agents，每个 Agent 拥有独立的对话上下文；支持 Agent 身份设置（名称、Emoji 图标）；消息以 Markdown 渲染并支持代码高亮。平台支持定时任务（Cron Jobs）并可选择将执行结果通知发送到渠道。每个 Agent 拥有独立的知识库目录，支持上传文档、PDF、图片和数据文件，并提供文本、代码、JSON 等文件预览。平台还提供技能商店，可搜索和安装来自 skills.sh 的 AI 技能，支持按 Agent 维度管理 API Token 的生成与管理。在隔离层面，每个用户拥有独立的 Docker 容器，容器级资源隔离规格为 2GB RAM、4 CPU。
三、分支与内核 main 分支为当前主分支，基于 Hermes 6 月底版本，因 Hermes 比 OpenClaw 快很多而全面切换为 Hermes 分支，相比之前的 OpenClaw 具有更快的启动速度和响应性能。openclaw 分支为旧主分支（已归档），基于 OpenClaw 2026.5.10；nanobot014v3 分支为 nanobot 的 0.1.4 post v3 版本。
四、架构设计 平台新增 platform 作为控制容器的网关，每个用户单独创建容器进行管理。整体分为：Frontend（前端页面显示，调用 platform 进行交互）、Platform（控制容器管理，调用 Hermes Agent 进行 AI 交互）、Hermes Agent（基于 Hermes 的 AI Agent 运行时）。升级 Hermes 时重建 hermes 镜像即可。
多租户部署采用 Docker Compose，组件包括：Frontend（Vite + React Web 界面，负责用户注册、登录、聊天）、Gateway（平台网关，Python FastAPI，负责认证、用户容器管理、LLM 代理、配额控制）、用户容器（每个用户一个独立的 Hermes 实例，自动创建，数据隔离）、PostgreSQL（存储用户账户、容器元数据、用量记录）。
五、Hermes Agent 引擎能力 Hermes 是一个高性能的 AI Agent 框架（Python），核心能力包括 Agent Loop（ReAct 模式的工具调用循环，支持多轮迭代）、工具系统（Bash 执行、文件读写、Web 搜索/抓取、消息发送等）、Skills 系统（Markdown 格式的技能文件，支持内置与用户自定义）、Session 管理（对话历史持久化）、多 Provider 支持（通过 OpenAI 兼容接口对接各种 LLM）。
六、使用方式 部署需要 Docker 与 Docker Compose，以及至少一个 LLM 提供商的 API Key。在项目根目录创建 .env 文件并填入 API Key 和配置后，用户即可使用配置的模型。Gateway 根据模型名自动匹配提供商并注入对应的 API Key，用户容器内不存储任何密钥。MiniMax 默认将 MiniMax-M2.7 路由到同族 highspeed 变体以降低回答等待时间；需要严格使用原始模型时设置 MINIMAX_M27_USE_HIGHSPEED=false。
本地开发可使用 legacy helper：python start_local.py，或 python start_local.py --only db,gateway,frontend。测试打包 Hermes dedicated runtime 使用命令：docker build -f hermes-agent/Dockerfile.bridge -t nanobot-hermes-agent:latest hermes-agent/。状态检查使用 python check_status.py。本地开发环境启动后涉及地址包括 PostgreSQL（http://127.0.0.1:5432）、Hermes Agent（http://127.0.0.1:18080）、Platform Gateway（http://127.0.0.1:8080）、Frontend Dev（http://127.0.0.1:3080）。
前端为 Vite + React Router 单页应用，暗色主题。生产环境中前端通过 nginx 反代 /api/* 到 gateway 容器，无需硬编码 IP；开发环境中 Vite 代理 /api/* 到 http://localhost:8080。前端使用相对路径 /api/...，换网不需要重新 build。WebSocket 协议为前端到 Gateway 再到 Hermes Agent 逐层代理。
技能文件位于 hermes-agent/skills/，每个技能是一个包含 SKILL.md 的目录，用户也可以在自己的工作区中创建自定义技能。技能管理接口包括 GET /api/skills（列出所有技能）、POST /api/skills/upload（上传 ZIP 格式技能）、DELETE /api/skills/:name（删除用户自定义技能）、GET /api/skills/:name/download（导出技能）。
部署模板目录 deploy_copy 在启动时自动将预置的 Agent 和技能同步到 Hermes 运行目录，同步流程幂等，只拷贝不存在的文件。同步需要完成三步：创建 Agent 目录、同步工作空间（存放 SOUL.md、AGENTS.md 等文件）、写入配置（配置文件中添加 Agent 信息，作为 API 返回 Agent 列表的数据源）。如果只做第二步而缺少第一、三步，Agent 不会在 Web UI 中显示。部署后访问 http://localhost:3080/agents 即可看到新 Agent。
通过 call_agent_api.py 脚本可以从命令行调用 Agent，适合外部系统集成。
七、在线体验与参考文档 在线体验地址：https://ai.infox-med.com:13080/（直接注册即可使用）。配置文档：https://my.feishu.cn/wiki/KfTlwurh7ix0PHkQmHic2L0Snue。
八、运维与已知问题 容器内部端口 5900（浏览器端口）和 30000（外部端口）会被映射到主机的随机端口上。渠道配置（QQ、飞书等）参考链接：https://zhuanlan.zhihu.com/p/2016049817437111235。相关文档包括 doc/hermes_web.conf（nginx 域名设置）、doc/table.md（数据库表结构）、doc/离线部署.md（离线部署）、doc/vllm.md（vLLM 支持）、doc/更改Logo和名称.md（更改 Logo 和名称）。
仓库中列出的待改进项包括：后台前端能否添加自己的模型统计；渠道管理安装完点击删除没有响应；对话框输入超过两行时能否自动扩充到六七行高度；上传文件名字太长会顶掉删除按钮位置导致无法删除；模型回复过多（如写文献时）被截断的机制是否需要修正；思考过程能否展示或以折叠方式展示（当前只展示结果）；希望支持 Agent 配置备份与分发，管理员统一配置并备份 Agent 后下发给普通用户，防止用户误删或改坏技能；实时终端升级需求。
九、限制与缺失说明 仓库未提供具体价格、收费模式或商业授权条款信息。项目的 Security policy 内容暂未提供具体细节。作者联系方式为 johnsongzc。
