Hexabot

自动化繁琐事务，保留创造灵活性。 通过 YAML、工具、MCP、记忆（Memory）和 RAG，跨渠道构建并运行智能代理工作流。

官网 · 文档 · 扩展 · Discord

Hexabot v3 是一个具备顶尖 AI 能力的自动化平台，将工作流、操作（Actions）、代理（Agents）和对话渠道整合在同一个运行时中。

快速开始

前置条件

• Node.js ^20.19.0
• 任意包管理器 (npm, pnpm, yarn 或 bun)
• Docker (可选，用于基于 Docker 的服务)

本快速入门指南针对通过 CLI 生成的项目。 如果你想为 Hexabot monorepo 本身做贡献，请使用 PNPM（参见 CONTRIBUTING.md）。

1) 安装 CLI

npm install -g @hexabot-ai/cli

或者不进行全局安装直接运行 CLI：

npx @hexabot-ai/cli --help

2) 创建并运行项目

hexabot create my-project
cd my-project
hexabot dev

未全局安装？请使用 npx 替代命令：

npx @hexabot-ai/cli create my-project
cd my-project
npx @hexabot-ai/cli dev

hexabot create 会自动检测你的包管理器。你可以通过 --pm 参数强制指定，例如：

hexabot create my-project --pm npm

hexabot create 会提示输入初始管理员凭据，因此需要交互式终端 (TTY)。在 CI 或非交互式 shell 中，请先在本地终端运行它。

默认本地端点：

• 管理员 UI: http://localhost:3000
• API: http://localhost:3000/api
• API 文档 (非生产环境): http://localhost:3000/docs

常用 CLI 命令：

• hexabot create
• hexabot dev [--docker --services ]
• hexabot start [--docker --services ]
• hexabot docker
• hexabot env
• hexabot check
• hexabot config
• hexabot migrate [args...]

有关 CLI 的详细信息，请参阅 packages/cli/README.md。

核心能力

• 智能代理工作流： 带有类型化运行时约束的 YAML 工作流定义。
• 基于操作的执行： 操作通过模式（Schema）验证的输入/输出/设置来定义工作流行为。
• 绑定系统： 可复用的功能/配置绑定，与任务逻辑分离。
• 记忆支持： 明确的记忆定义与运行时记忆集成。
• MCP 集成点： 支持 Model Context Protocol，实现工具与上下文的互操作性。
• 多渠道连续性： 渠道和辅助程序依然是核心概念。
• 模式优先架构： 广泛使用 Zod 进行验证和共享契约。

数据层

• TypeORM 是标准后端数据层。
• SQLite 是默认的本地选项。
• Postgres 是生产环境的首选。
• 使用 DB_TYPE 和 DB_* 变量配置数据库运行时。

参与贡献

如果你希望为 Hexabot monorepo（架构、包映射、PNPM 工作区、Turbo 任务、CI 检查）做贡献，请参考 CONTRIBUTING.md。

许可证

Copyright (c) 2025 Hexastack.

采用 FCL-1.0-ALv2 协议授权。详细条款请参见 LICENSE.md。