OpenBot

OpenBot 是一个专为企业内部设计的自托管代理（Agent）平台。它引入了“AI 同事”的概念：每个 Bot 都拥有自己独立的“计算机”环境——包括专属的浏览器实例、文件系统、登录凭证以及经授权的工具。通过严格的网关控制和实时审计，OpenBot 让企业能够安全地将实际工作委派给 AI，同时保持对数据和操作的绝对掌控。

核心理念：安全、可控、透明

• 每个 Bot 一台计算机：
  • 为每个 Bot 分配独立的容器、工作区卷 (/workspace) 和浏览器配置文件。
  • 支持在 gVisor 下运行以增强隔离性。
  • Bot 不仅可以使用浏览器，还能在其沙盒环境中执行 Shell 命令、安装依赖和处理文件，所有操作均受网关监管。
• 网关即唯一入口：
  • 所有对计算机、文件或 MCP 服务器的操作必须经过网关。
  • 网关基于快照解析目标、评估 CEL 策略、写入审计日志后，才允许执行操作。
  • 默认拒绝策略：缺失或损坏的策略会导致操作被拒绝，确保“零信任”安全模型。
• 全程可观测与接管：
  • 实时屏幕共享：管理员可以看到 Bot 正在浏览的内容。
  • 活动日志：记录所有运行、读取、保存的操作及输出。
  • 人工接管：当 Bot 遇到登录墙、2FA 或复杂决策时，可请求人工帮助。控制权移交过程被完整记录，且在人工操作期间 Bot 动作被暂停。
• 隐私与秘密保护：
  • 敏感信息（如密码、API Key）在转录中仅显示长度，不显示内容。
  • 凭证静态加密存储，从不通过 API 返回。

技术架构与兼容性

• 基于 AG-UI 协议：
  • OpenBot 不绑定特定框架，任何支持 AG-UI 协议的端点均可作为 Bot 接入。
  • 兼容 LangGraph, Mastra, CrewAI, Pydantic AI, Google ADK 等主流框架，甚至手工编写的代理。
• 自托管基础设施：
  • 使用 Docker Compose 部署，数据存储在 PostgreSQL 中。
  • 模型由管理员自行提供密钥（如 OpenAI, Anthropic, Google），密钥静态加密且不记录。
  • 底层依赖 CopilotKit Intelligence 进行线程管理和记忆持久化。

快速开始指南

1. 环境准备

• Docker (用于 PostgreSQL 和 Bot 容器)
• Bun 1.3+ (用于应用和 API 服务器)
• CopilotKit Intelligence 项目许可证

2. 配置与启动

# 克隆并配置环境变量
cp .env.example .env

# 获取 CopilotKit 凭证
npx --yes copilotkit@latest login
npx --yes copilotkit@latest project select
npx --yes copilotkit@latest license --write

# 填写 .env 中的必要字段
# - INTELLIGENCE_API_KEY (从 project select 获取)
# - OPENAI_API_KEY (或其他模型密钥)
# - KEY_ENCRYPTION_KEY (建议使用 openssl rand -base64 32 生成)

# 安装依赖并启动
bun install
bash scripts/start.sh

3. 访问系统

启动完成后，访问 http://localhost:3010。默认情况下 OPENBOT_SINGLE_USER=true 允许免登录测试，生产环境需配置 OAuth/SAML 登录。

功能亮点

• 预置角色：包含 General Assistant, Knowledge, Risk Analyst 等示例 Bot，可通过 agents.yaml 或 UI 轻松扩展。
• 受治理的 MCP：支持 Google Drive 等经过审查的连接器，确保企业数据安全。
• 组件化交互：Bot 可通过编译后的 React 组件而非纯文本与用户交互，提升信息呈现效率。
• 细粒度权限管理：通过 /admin/people 管理用户访问权，通过 CEL 策略定义 Bot 的行为边界。
• 完整审计跟踪：/admin/audit 记录所有允许、拒绝及失败的操作，附带触发规则，便于合规审查。