P056 CopilotKit/OpenBot

信息卡

项目	内容
仓库	CopilotKit/OpenBot
语言 / 许可证	TypeScript / MIT
总星标	⭐ 2993（截至 2026-08-26）
创建时间	2026-08-17
榜单	近30天新星榜第6名

一句话定位

CopilotKit 出品的开源自托管 Agent 平台："可以交托真实工作、且真正放心给权限的 AI 同事"。每个 Bot 拥有一台自己的电脑——带独立登录态的真实浏览器和独立文件区，只拥有你明确授予的工具；全部运行在你自己的基础设施里（Docker Compose、你的 PostgreSQL、你的模型密钥），不捆绑模型。

走红原因分析

其一，CopilotKit 团队背书 + "Hand the bot a computer of its own"的具象叙事易记易传；其二，企业级治理设计（网关裁决一切工具/浏览器/文件/MCP 动作、CEL 策略 fail-closed、全量审计）正中自主 Agent 最大的落地恐惧点；其三，基于开放的 AG-UI 协议、框架无关（LangGraph/Mastra/CrewAI/Pydantic AI/Google ADK 均可接入），生态兼容性讨喜；其四，坦承 Alpha 状态的诚实姿态降低了期望落差争议。

核心功能拆解

每 Bot 一台电脑：隔离容器 + /workspace 卷 + 独立浏览器配置，可选 gVisor（COMPUTER_RUNTIME=runsc）加固；
网关独占执行：解析目标 → 评估策略 → 写审计行 → 再执行动作，无旁路；
CEL 策略、默认拒绝：可检查工具名、意图、Bot/操作者 ID、页面 URL/host、文件与 MCP 字段，deny 先于 allow 求值；
实时监控：观看 Bot 屏幕、Activity 页展示运行输出，保存的文件只显示路径与大小；
人工接管：登录墙/双因素验证时 Bot 发出 help_requested 请求人类协助；
密钥不进对话记录——只记请求元数据；托管 MCP 中 Drive/Notion 经审核，未知工具按写操作对待。

架构与技术栈浅析

多服务布局：app(3010, React/Vite UI)、server(3001, Hono API——鉴权/策略/审计/插件/组件)、agent-computer(4100, Chromium+工作区)、agent-bot(4200)/agent-langgraph(4201) 为 AG-UI Bot 示例、supervisor(4500/4300，持 Docker socket 因此只绑 loopback)、PostgreSQL(pgvector, 5432)。持久层 Drizzle ORM 迁移，身份用 better-auth，线程与记忆依赖外部 CopilotKit Intelligence 服务。三个示例如 General Assistant/Knowledge/Risk Analyst 以纯 config 形态交付，改行为不用写代码。

安装与环境要求

需 Docker、Bun 1.3+、一个 CopilotKit Intelligence 项目/许可（有免费档）及模型密钥：

cp .env.example .env
npx --yes copilotkit@latest login
npx --yes copilotkit@latest project select
npx --yes copilotkit@latest license --write
bun install && bash scripts/start.sh   # 打开 http://localhost:3010

单镜像部署：`docker build -t openbot . && docker run -p 3001:3001 --env-file .env -e EMBEDDED_POSTGRES=on -v openbot-data:/var/lib/postgresql/data openbot`。必填环境变量缺失时服务器拒绝启动。

快速上手示例

在 /bot 输入：`Open news.ycombinator.com and tell me the top story.`；再到 `/admin/audit` 复盘审计记录，`/admin/boundaries` 加 deny 规则体验治理闭环。

进阶使用要点

私网 Agent 端点须经 AGENT_ENDPOINT_ALLOWED_HOSTS 白名单放行，凭据以只写头形式下发；
`.env.example` 默认开启单管理员模式（OPENBOT_SINGLE_USER=true），多用户需删掉它并配 IdP 与 INITIAL_ADMIN_EMAILS；
凭据静态加密存储，组件发布走 /admin/playground 沙箱无需重新部署。

典型应用场景

企业内部部署可审计的网页自动化与数据采集 Bot；
需要审批与边界管控的敏感账号代运营；
基于 AG-UI 的自有框架接入验证场；
面向合规要求的 AI 同事试点项目。

资源导航

仓库 README（端口表与必填变量清单）、scripts/start.sh、scripts/db:migrate 迁移流程、AG-UI 协议文档。

CopilotKit/OpenBot

信息卡