Hexabot — 支持多渠道接入的开源 AI 聊天机器人平台

官网 · 文档 · 扩展 · Discord

Hexabot v3 是一个具备一流 AI 能力的自动化平台，将工作流、动作与对话渠道整合到同一运行时中。

快速开始

前置条件

• Node.js ^24.17.0
• 任意一种包管理器（npm、pnpm、yarn 或 bun）
• Docker（可选，用于基于 Docker 的服务）

本快速开始面向通过 CLI 生成的项目。
如果你是为 Hexabot 单体仓库本身做贡献，请使用 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 中，请先在本地终端运行一次。

默认本地端点：

• 管理界面：http://localhost:3000
• API：http://localhost:3000/api
• API 文档（非生产环境）：http://localhost:3000/docs

常用 CLI 命令：

• hexabot create <project-name>
• hexabot dev [--docker] [--services <list>] [-d]
• hexabot start [--docker] [--services <list>] [--build] [-d]
• hexabot stop --docker [--services <list>] [-v] [--remove-orphans]
• hexabot env <init|list>
• hexabot check
• hexabot config <show|set>
• hexabot migrate [args...]

完整的 CLI 细节请参见 packages/cli/README.md。

核心能力

• 智能体工作流： 使用 YAML 定义工作流，并具备类型化的运行时契约。
• 基于动作的执行： 动作通过经 schema 校验的输入/输出/设置来定义工作流行为。
• 绑定系统： 将可复用的能力/配置绑定与任务逻辑分离。
• 记忆支持： 支持显式记忆定义及运行时记忆集成。
• MCP 集成点： 支持 Model Context Protocol，用于工具/上下文互操作。
• 多渠道连续性： 渠道与辅助器仍是核心概念。
• Schema 优先架构： 广泛使用 Zod 进行校验并共享契约。

数据层

• TypeORM 是标准后端数据层。
• SQLite 是默认本地选项。
• Postgres 在生产环境中是一等支持。
• 通过 DB_TYPE 和 DB_* 变量配置数据库运行时。

贡献

如果你想为 Hexabot 单体仓库做贡献（架构、包地图、PNPM 工作区、Turbo 任务、CI 检查），请阅读 CONTRIBUTING.md。

许可证

Copyright (c) 2025 Hexastack.

依据 FCL-1.0-ALv2 授权。完整条款参见 LICENSE.md。