OpenBot：CopilotKit开源自托管AI智能体沙箱运行平台

OpenBot是什么

OpenBot 是 CopilotKit 开源推出、基于 MIT 开源协议的私有化AI智能体运行平台，项目使用 TypeScript 开发，目前处于 Alpha 开发阶段。

OpenBot 的核心目标是为AI智能体提供隔离、可管控的虚拟计算机运行环境，让AI代理可以操作浏览器、读写文件、执行Shell指令，同时具备完整权限控制与全链路审计能力。它不绑定任意单一Agent开发框架，兼容多种主流智能体框架接入，所有业务数据、模型密钥由使用者自行保管，实现完全自托管部署，打造企业可用的私有化AI同事运行环境。

简单理解：OpenBot 相当于给AI智能体配备一台独立虚拟电脑，管理员可以定义规则限制AI能干什么、不能干什么，所有操作全程留痕，还支持人类随时接管AI的操作。

功能特色

1. 隔离式虚拟计算机沙箱
   每一个Bot都分配独立的Chromium浏览器实例、独立文件目录、独立会话环境，支持Shell命令运行；可选gVisor进一步强化容器沙箱安全。全部工具调用都经过网关校验，不存在绕过管控的操作路径。

2. 基于CEL表达式安全访问策略
   默认拒绝全部高危操作，使用CEL表达式编写规则，针对URL访问、文件读写、Shell命令、MCP工具做精细化允许/拒绝策略，一旦触发违规规则直接拦截操作。

3. 人工接管干预机制
   当AI遇到网页登录、二次验证、人机验证码等无法自主处理场景，可主动请求人工接管。用户可直接操作Bot内置浏览器完成操作，全部人工操作同样写入审计日志。

4. 完整审计日志系统
   完整记录每一次工具调用，包含允许、拒绝、执行失败事件，拒绝操作会标注触发的安全规则；密钥明文不会写入日志，仅记录密钥调用行为，满足合规审计需求。

5. MCP服务治理能力
   原生支持MCP协议服务接入，官方示例内置Google Drive连接器，管理员可以管控Bot可调用的MCP工具，区分读写权限。

6. 技能调用系统
   支持个人技能与管理员部署级技能，聊天界面通过/快捷指令调用各类自定义技能。

7. 多模式身份认证
   本地调试支持单用户免登录模式；生产环境支持OIDC、SAML、Google、Microsoft、Okta企业SSO登录，可做细粒度用户访问管控，支持TLS对外部署。

8. 多框架兼容AG‑UI协议
   不锁定Agent实现，LangGraph、CrewAI、Mastra、Pydantic AI等实现AG‑UI协议的智能体都可以接入OpenBot；输出支持文本以及React组件渲染。

9. 内置开箱即用Agent示例
   自带通用助手、知识库问答、风险分析师三类Agent，可通过前端UI或者agents.yaml配置文件快速新增自定义智能体。

技术细节

技术栈

• 主要开发语言：TypeScript

• 前端框架：React

• Web服务框架：Hono

• 包管理器：Bun ≥1.3

• 数据库：PostgreSQL，存储会话、审计记录、加密凭证、Agent配置

• 容器：Docker，用于运行数据库、agent‑computer隔离环境，可选gVisor沙箱

• 协议：AG‑UI、MCP协议

• 授权组件：CopilotKit Intelligence，支持自托管，负责对话线程与记忆持久化

核心服务组件

所有智能体的工具动作全部经过 server 网关层，先执行CEL安全策略校验，通过之后再交由agent‑computer执行动作，执行结果回写审计日志。
项目本身不内置大模型，需要使用者自行配置OpenAI、Anthropic等大模型API密钥，密钥加密存储，不会明文暴露。

应用场景

1. 企业私有化AI办公助手
   企业内部部署，AI代理访问内部文档、网页系统，执行办公自动化任务，通过安全策略阻止高危操作，所有操作留痕审计，数据不出企业内网。

2. 自动化网页业务智能体
   搭建网页自动化Agent，处理表单填报、信息采集，遇到验证码、登录场景由人工接管，适合业务流程自动化。

3. MCP工具私有化调度平台
   统一管理多个MCP连接器，对不同Bot分配不同MCP工具权限，集中管控AI调用第三方工具行为。

4. 智能体开发测试环境
   Agent开发者用来调试各类基于AG‑UI协议开发的智能体，快速测试浏览器操作、文件读写、Shell执行行为。

5. 合规要求高的AI代理业务
   金融、政务类场景，需要完整操作审计、权限管控，防止AI执行高危操作，满足合规留存日志要求。

使用方法

前置依赖

1. Docker环境，用于运行PostgreSQL以及隔离agent容器

2. Bun版本 ≥1.3

3. CopilotKit Intelligence，提供免费方案，支持自托管部署

4. 可用大模型API密钥（OpenAI、Anthropic等）

本地快速部署步骤

1. 克隆项目仓库到本地

git clone https://github.com/CopilotKit/openbot.git
cd openbot

2. 复制环境变量模板，配置.env文件，填入数据库、模型密钥、CopilotKit Intelligence相关配置；本地调试设置 OPENBOT_SINGLE_USER=true开启单用户模式，跳过登录。

cp .env.example .env

3. 使用Docker启动PostgreSQL数据库服务。

4. 使用Bun安装依赖，执行数据库迁移脚本初始化数据表。

5. 依次启动 supervisor、agent‑computer、后端server、前端app等对应服务。

6. 浏览器访问 http://localhost:3010，进入Web界面，即可使用内置Agent，或者配置新增自定义智能体。

生产部署：关闭单用户模式，配置OIDC/SAML企业SSO，配置TLS证书对外提供访问，配置gVisor强化沙箱安全。

竞品对比

选取AutoGPT、AgentZero两款开源智能体平台做对比

常见问题解答

OpenBot是否内置大模型？

OpenBot项目本身不提供大模型，需要使用者自行配置OpenAI、Anthropic等大模型服务商的API密钥，密钥加密存储在数据库中。

OpenBot可以直接接入LangGraph开发的Agent吗？

可以，只要Agent实现AG‑UI协议端点，就可以接入OpenBot平台运行，不限于LangGraph，CrewAI、Mastra等框架都支持。

单用户模式适合生产环境使用吗？

OPENBOT_SINGLE_USER=true 仅用于本地调试，生产环境需要关闭该配置，配置企业SSO身份认证，实现多用户权限管控。

CEL安全策略是什么，必须配置吗？

CEL是表达式语言，用来编写AI工具调用的黑白名单规则，平台默认拒绝高危操作，可以根据业务场景自定义规则，自定义配置不是强制，但生产环境强烈建议配置。

OpenBot审计日志是否会记录密钥明文？

不会，密钥做加密存储，日志只会记录密钥调用事件，不会输出密钥明文，避免敏感信息泄露。

是否可以不用CopilotKit Intelligence组件？

CopilotKit Intelligence负责对话线程、记忆持久化，支持自托管，是平台运行依赖组件，无法直接移除。

OpenBot的沙箱安全是否可以直接用于公网暴露？

不建议直接公网暴露，公网使用需要开启TLS、配置SSO身份、启用gVisor沙箱，做好网络防护，避免恶意滥用。

相关链接

• 项目GitHub仓库：https://github.com/CopilotKit/openbot

• CopilotKit官方网站：https://copilotkit.ai

总结

OpenBot作为CopilotKit开源推出的AI智能体运行平台，重点解决AI代理执行外部操作时的安全管控、环境隔离与审计合规问题，依托AG‑UI和MCP协议兼容市面上主流智能体开发框架，提供虚拟计算机沙箱、人工接管、CEL权限策略、全链路审计等企业级能力，适合有私有化部署、合规审计需求的团队搭建可控的AI自动化智能体，同时也可供Agent开发者做智能体调试测试。