AgentBrother：统一管理OpenClaw与ZeroClaw的AI Agent框架部署指南

项目介绍

AgentBrother 是一个跨平台的 AI Agent 统一管理开源框架，其核心目标在于解决底层 Agent 框架配置复杂、技术门槛高的痛点。它基于 OpenClaw（龙虾）、ZeroClaw（螃蟹）等底层 人工智能 Agent 框架，搭建了一个上层管理平台，旨在为开发者和普通用户提供“一键式”的智能体管理工具。

通过该平台，使用者无需关注底层复杂的命令行配置，即可在可视化的应用层界面中，所见即所得地创建、配置和管理各种 AI 数字员工或智能体。它支持虚拟组织的创建和项目任务的自动化推进，有效推动了 AI 代理在不同业务场景中的落地应用。

项目优势

低门槛易上手

它将原本需要专业开发者才能驾驭的复杂 AI 工具，转化为直观的“一键式”应用，支持零配置启动。即使是没有任何技术背景的用户，也能轻松上手操作，解决了 AI 技术应用的“最后一公里”难题。

分层设计解耦高效

框架采用清晰的分层架构，底层负责对 OpenClaw、ZeroClaw 等框架的基础能力进行封装，而上层则专注于业务场景的落地实现。这种设计职责清晰，在保持系统灵活性的同时，显著降低了开发与使用之间的耦合度，便于未来扩展新的底层框架和功能模块。

跨平台多端兼容

项目全面支持 macOS、Windows 系统，同时提供 Web 端和移动设备访问能力。桌面端基于 Electron 构建，提供原生应用体验；Web 端可通过浏览器直接访问，确保了用户在不同设备和平台下都能获得一致的使用体验。

统一管理高效协作

用户可以在一个平台内集中监控和配置所有 AI Agent 的运行状态，并能无缝切换不同的底层框架（如 OpenClaw 与 ZeroClaw），无需来回切换终端或重启应用。此外，还支持创建虚拟项目、为项目分配任务，实现对 AI 数字员工的团队化高效管理。

资源优化更省成本

框架支持本地解析上传的文档内容（如 txt， doc， pdf），无需将文件内容传输至云端处理，这能有效节省调用大模型时的 Token 消耗。同时，其智能化的资源管理机制，可以优化资源分配，避免因频繁切换不同底层框架而造成的资源浪费。

交互便捷体验友好

提供了全局快捷方式调出的浮点输入窗口、文件拖拽解析等便捷的交互方式，操作直观，告别了繁琐的命令行。项目还为 Agent 设计了独特的情感和个性表达，进一步提升了用户的使用体验。

安全与扩展性兼备

在安全性上，已移除项目中的硬编码 API KEY，避免敏感信息泄露。其模块化的设计使得框架扩展变得简单，开发者可以通过开发简单的桥接类并进行注册，来添加新的 Agent 框架，也支持自定义多种类型（聊天、代码、图像等）的 AI 代理。

技术栈

核心开发技术

• 前端: HTML5, CSS3, JavaScript (ES6+)
• 桌面端: Electron 33+（提供原生桌面应用体验）
• 后端: Node.js, Express
• 类型校验: TypeScript 5+
• 构建工具: electron-builder

功能依赖库

• 文件解析: mammoth@^1.11.0（解析 doc/docx 文件）、pdf-parse@^2.4.5（解析 pdf 文件）
• 通信能力: 支持 WebSocket、HTTP API 实时通信，实现与 Agent 的即时交互

功能介绍

1. 核心管理功能

• 多框架集成: 无缝对接 OpenClaw、ZeroClaw 等主流 Agent 框架，可在界面内快速切换底层引擎，以满足不同任务需求。
• AI 数字员工创建: 通过所见即所得的可视化界面，在选择底层框架后，仅需配置名称、图标、模型等参数，即可快速创建专属的 AI 代理。
• 统一状态管理: 集中监控所有 AI Agent 的运行状态，支持统一配置参数、手动启停管理底层框架的 Gateway 服务。
• 项目化协作: 可以创建虚拟项目来对 AI 任务进行归类管理，为项目添加具备不同技能的 AI 数字员工，并支持定时或即时任务的分发与执行进度监控。

2. 便捷交互功能

• 浮点输入: 支持通过全局快捷方式（默认 Cmd/Ctrl + Shift + A）快速调出浮点输入窗口，随时与 AI Agent 对话，并可配置窗口位置、透明度、是否置顶等属性。
• 文件拖拽解析: 支持将 txt, doc, docx, pdf 格式文件（≤100KB）直接拖拽上传，框架会在本地自动提取文本内容并整合到对话上下文中。此功能目前仅限桌面端使用。

3. 自动化与优化功能

• 自动启动检测: 应用启动后会自动检测并尝试启动已配置的 OpenClaw Gateway 服务，无需手动操作，同时也提供界面手动管理选项。
• 本地文件解析: 上传的文件内容均在本地进行处理，不占用云端资源，从而有效节省调用大模型所需的 Token 消耗。
• 资源智能管理: 根据任务的实际需求优化系统资源分配，避免因频繁切换不同框架而造成的 Token 和系统资源浪费。

4. 扩展功能

• 多类型 Agent 支持: 支持创建 chat（聊天）、code（代码）、image（图像）、video（视频）、audio（音频）、custom（自定义）六大类 AI 代理，满足多元化场景需求。
• 框架灵活扩展: 通过简单的桥接类开发与注册流程，即可添加新的 Agent 框架，轻松适配更多底层 AI 能力。

安装部署

1. 环境要求

• 运行环境: Node.js ≥ 20.0.0, npm ≥ 10.0.0
• 支持系统: macOS, Windows（桌面端）；所有支持现代浏览器的设备（Web 端）

2. 基础部署步骤（开发/使用版）

（1）源码安装（开发模式）

1. 克隆项目仓库后，在项目根目录执行命令安装依赖：npm install
2. 启动桌面应用：npm run dev
3. 启动 Web 应用：npm run start:web
4. 应用构建（编译 + 打包）：
   • 编译 TypeScript 代码：npm run build
   • 打包桌面应用：npm run dist

3. 配置说明

• 框架自动检测: 系统会自动检测系统环境或指定路径下的 OpenClaw、ZeroClaw 框架，通常情况下无需手动配置路径。
• 环境变量: 需要配置 ARK_API_KEY（火山引擎 API 密钥）。可选配置 OPENCLAW_CONFIG_PATH（指向自定义的 OpenClaw 配置文件路径）。
• 浮点输入配置: 在应用程序的设置中，可以配置浮点输入功能的启用/禁用、全局快捷方式、以及窗口的位置、透明度和置顶状态。

UI 展示

主界面

项目管理

任务管理

代理管理

项目任务

任务详情与代理工作区

AgentBrother 框架通过其统一的管理界面和便捷的操作，显著降低了使用和集成 OpenClaw、ZeroClaw 等 AI Agent 框架的复杂度。无论是用于个人效率提升、内容创作，还是团队项目协作，它都提供了一个强大的可视化管控平台，是探索 AI 数字员工应用落地的实用工具。如果你对 AI Agent 的开发和集成感兴趣，不妨在 云栈社区 与其他开发者一起交流探讨。