Hexabot
开源多渠道 AI 自动化平台,支持 YAML/图形双模式工作流编排,自托管部署
加载项目详情…
本应用为开源项目,仅供学习研究,请遵守其开源协议。
开源多渠道 AI 自动化平台,支持 YAML/图形双模式工作流编排,自托管部署
加载项目详情…
本应用为开源项目,仅供学习研究,请遵守其开源协议。
想象一下:你有一个客户,每天通过微信、Discord、网站聊天框同时联系你。人工回复忙不过来,单纯的关键词回复机器人又太傻——不够灵活、接不上你的 ERP、也无法在需要时无缝转人工。Hexabot v3 正是为这类场景而生。
Hexabot 最初由法国软件公司 Hexastack 开发,核心定位是"多渠道对话式 AI 自动化平台"。v3 是其彻底重构版本,于 2024-2025 年间发布,GitHub 累计获得 974 颗星、140 次 fork,并获得了法国 Orange 电信的真实商用案例——在 Orange 的多语言客服场景中,Hexabot 承担了官网和社交渠道的自动化接待。

图1:Hexabot 可视化工作流编辑器界面,左侧为节点面板,中心为 YAML/图形双模式画布。
v3 版本最大的变化是从聊天机器人框架升级为通用 AI 自动化运行时。平台围绕四个核心原语构建:
1. Agentic Workflows(智能体工作流)
这是 Hexabot v3 的灵魂。与传统机器人的线性对话树不同,Hexabot 的工作流是声明式 YAML 配置,支持复杂的控制流——顺序执行(do)、真正并发(parallel 含 wait_all/wait_any)、条件分支(conditional)以及两种循环(for_each 和 while)。工作流定义使用 JSONata 表达式(以 = 开头)实现动态数据转换,运行时由 WorkflowRunner 驱动,支持暂停(suspend)和恢复(resume),断点续跑能力对长流程极为重要。
2. Actions(可复用动作)
每个工作流任务通过 defineAction 注册,输入输出由 Zod schema 强约束,自带超时、重试、错误处理等配置。这套设计让动作可测试、可组合,也方便团队发布 npm 包级别的自定义 Action。
3. Bindings(绑定系统)
Bindings 是 Hexabot 的依赖注入层——将工具(tools)、内存(memory)、MCP 工具等能力以类型安全的方式注入到工作流中,无需修改任务逻辑本身。bindingKinds 配置支持 kind-based 校验(基数、一致性、循环检测),保证了在大规模工作流场景下的可维护性。
4. 多渠道与记忆(RAG + Memory)
支持 Web Chat、Discord、WhatsApp 等多渠道并发接入,内置 Memory 模块用于跨对话的上下文保持,以及 RAG 能力用于知识库增强生成。平台还支持 MCP(Model Context Protocol)集成,可接入第三方 AI 工具生态。
Hexabot 采用 PNPM Monorepo 结构,7 个 workspace 包各司其职:
| 包 | 说明 |
|---|---|
packages/api | NestJS 后端,TypeORM 数据层,支持 SQLite(开发)和 PostgreSQL(生产),自带 OpenAPI 文档 |
packages/frontend | React + Vite 管理后台,包含 Dashboard、Workflow Editor、Inbox 等完整 UI |
packages/widget | 嵌入式 Web Chat Widget,可嵌入任意网站 |
packages/cli | @hexabot-ai/cli 脚手架工具,hexabot create 一键初始化项目 |
packages/agentic | 核心引擎:YAML DSL 解析器、WorkflowRunner、defineAction、Binging 系统 |
packages/graph | 工作流图形化编辑器底层 |
packages/types | 共享 TypeScript 类型定义 |
关键技术栈:TypeScript + Node.js >= 20.19.0,API 层用 NestJS,前端用 React + Vite,数据库支持 SQLite(开箱即用)和 PostgreSQL(生产推荐),Schema 验证全面依赖 Zod。
代码质量方面,monorepo 集成 Husky Git Hooks、Commitlint、ESLint、Turborepo 构建编排,测试框架为 Jest(API/CLI)和 Vitest(Frontend),每个包均有 AGENTS.md 为 AI 编码助手提供上下文指引,工程化水平较高。
方式一:CLI 脚手架(最简单)
npm install -g @hexabot-ai/cli
hexabot create my-project
cd my-project
hexabot dev
访问 http://localhost:3000 打开管理后台,hexabot dev 自动启动完整本地栈(API + Frontend + SQLite)。
方式二:Docker Compose(一键生产部署)
git clone https://github.com/hexabot-ai/Hexabot.git
cd Hexabot/docker
cp .env.example .env
# 编辑 .env 配置数据库凭证
docker compose up -d
Docker Compose 自动编排 API + Frontend + PostgreSQL 三个容器,带健康检查。生产部署支持 Nginx 反向代理(docker-compose.nginx.prod.yml)、Redis 会话缓存(docker-compose.redis.yml)以及 Ollama 本地 LLM(docker-compose.ollama.yml)。
部署难度评估:Node.js 基础环境 + Docker 基础即可,中等难度。无 GPU 依赖,内存 2GB+,磁盘 2GB+。
1. 许可模式变更风险:Hexabot 虽为开源,但许可证为 FCL-1.0-ALv2(Fair Code License),这是一类限制商业云服务的许可证——如果将 Hexabot 作为 SaaS 服务提供,可能存在许可合规风险。购买许可证后方可在云环境中商业使用,这一条值得重视。
2. 商用成熟度:虽然有 Orange 电信的案例背书,但整体生态(第三方插件、社区规模)与 LangChain、Dify 等成熟平台相比仍有差距,企业级支持能力需进一步评估。
3. 复杂工作流的学习成本:YAML DSL + JSONata 表达式 + Zod schema 三件套组合,对无代码/低代码用户而言有一定门槛,初期配置不如 Dify 等可视化平台直观。
Hexabot v3 的定位介于可视化无代码平台(如 Dify)和纯代码级编排库(如 LangGraph)之间。它提供了比 Dify 更强的代码可控性(TypeScript 原生),同时比 LangGraph 更低的上手门槛(YAML + CLI)。对于需要自托管、追求数据自主、同时希望有一定的可视化编辑能力的团队,Hexabot 是一个值得关注的中间选择。
在开源 AI Agent 平台日益竞争激烈的背景下,Hexabot 强调的"多渠道统一"、"suspend/resume 工作流"和"类型安全的 binding 系统",在细分场景中有独特价值。