项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
数据来源:GitHub API 逐日快照 · 收录于 2026-08-22 · 当前星标 ★ 12997
使用教程
环境要求
- 已安装 Bun(用于 bun install 与运行)
- 已安装 Docker(start.sh 会拉起 Docker 服务)
- 可执行 bash 脚本的类 Unix 环境
- 已安装 Node.js/npx(用于 copilotkit CLI 登录)
- 一个 OpenAI API Key 和 CopilotKit 账号(获取 cpk- 运行时密钥)
安装与启动步骤
-
1复制环境变量模板
在仓库根目录把 .env.example 复制成 .env,后续所有密钥都填在这个文件里。
cp .env.example .env -
2登录并选择项目
用 CopilotKit CLI 登录并选择项目,从输出里取得 cpk- 开头的运行时密钥。
npx --yes copilotkit@latest login npx --yes copilotkit@latest project select -
3填写必填密钥
把上一步的 cpk- 运行时密钥填到 INTELLIGENCE_API_KEY,再填好 OPENAI_API_KEY。
-
4生成加密密钥
示例 KEY_ENCRYPTION_KEY 是公开值,本地可用;生产环境请自行生成一个替换。
openssl rand -base64 32 -
5安装依赖
用 Bun 安装仓库依赖,仓库内每个 workspace 都是私有的,不走包发布。
bun install -
6一键启动服务
启动 Docker 服务、执行数据库迁移、拉起 3001 API 与 3010 应用并做健康检查。
bash scripts/start.sh -
7打开应用界面
浏览器访问本地地址,进入 OpenBot 界面查看 AI 同事的工作屏幕。
关键配置
| 配置项 | 必填 | 说明 | 示例 |
|---|---|---|---|
INTELLIGENCE_API_KEY | 是 | CopilotKit Intelligence 运行时密钥,来自 project select 输出。 | cpk-xxxxxxxxxxxx |
OPENAI_API_KEY | 是 | 模型调用所需的 OpenAI API Key。 | sk-xxxxxxxx |
DATABASE_URL | 是 | 数据库连接串,API 服务器缺此项拒绝启动。 | postgres://postgres:postgres@localhost:5432/openbot |
KEY_ENCRYPTION_KEY | 是 | 密钥加密用的对称密钥,示例值仅适合本地。 | openssl rand -base64 32 的输出 |
INTELLIGENCE_API_URL | 是 | Intelligence API 地址,自托管时才需改,否则保留示例值。 | (保留 .env.example 中的托管地址) |
INTELLIGENCE_GATEWAY_WS_URL | 是 | Intelligence 网关 WebSocket 地址,同样缺此项拒绝启动。 | (保留 .env.example 中的托管地址) |
如何确认成功
脚本跑完后访问 http://localhost:3010 能打开界面;start.sh 会先确认各项服务健康路由有响应再打印后续步骤。
常见问题
Q:API 服务器启动就退出怎么办?
A:多半是 .env 缺必填项。API 至少需要 DATABASE_URL、KEY_ENCRYPTION_KEY、INTELLIGENCE_API_URL、INTELLIGENCE_GATEWAY_WS_URL、INTELLIGENCE_API_KEY 五项。
Q:有官方托管版可以直接注册吗?
A:没有。README 明确说明 OpenBot 是要 clone 下来自己改造的模板,不作为包发布,所有 workspace 都是私有的。
Q:还需要单独申请 CopilotKit 许可令牌吗?
A:不需要。托管 Intelligence 从项目密钥推导授权,COPILOTKIT_LICENSE_TOKEN 是可选,仅自托管且自带许可时才设置。
Q:怎么把服务全部停掉?
A:执行 bash scripts/stop.sh。它会停掉同样的服务,包括 compose 不管的每个 Bot 自己的电脑容器,但数据库和文件、浏览器配置卷不会被删除。
Q:可以把数据库放进部署容器吗?
A:可以,把 EMBEDDED_POSTGRES 设为 on,即在部署容器内自带一个数据库;否则需要自行提供 DATABASE_URL。
注意事项
- 项目处于 Alpha 且活跃开发中,属于模板而非成品,需把 examples/ 下的示例租户包换成自己的同事、渠道和技能。
- 启动脚本会自动生成 COMPUTER_TOKEN、SUPERVISOR_TOKEN、AGENT_TOOL_TOKEN;没有 AGENT_TOOL_TOKEN 时 Bot 不允许调用工具。
- 端口固定为 API 3001、应用 3010,若被占用需先释放。
- 仓库提供 prompt.txt,可先粘贴给 AI 助手,它包含同样的步骤和容易出错的说明。
核心亮点
- 每个智能体拥有独立浏览器和文件系统,环境隔离性强
- 基于 AG-UI 标准,可接入任意符合协议的智能体,互操作性好
- 动作决策前置+事后记录,审计追踪能力突出,适合合规场景
不足之处
- 项目较新,文档和社区生态待观察
- 依赖 AG-UI 等协议,生态未成熟时集成成本可能偏高
适用场景
- 需要高审计要求的自动化业务流程(如金融、政务)
- 多智能体协同完成复杂任务(如市场调研、竞品分析)
- 开发可解释、可回放的 AI 助手工具
替代项目
AutoGPT、BabyAGI、OpenAI Assistants API
上一篇:GEOHub
下一篇:open-index
同类项目推荐
Octopus-SI-OS
开源
用操作系统思路调度智能体,让 AI 稳定执行桌面任务
A self-evolving agentic OS. A new architecture for agent execution, built on operati···
mfs
开源
把散落各处的上下文,变成 AI 随手可查的文件系统
A context harness for AI agents: all your scattered context — code, memory, docs, d···
whoop-mcp
开源
让 AI 直接读你的 WHOOP 恢复与睡眠数据
Read-only WHOOP MCP server for recovery, sleep, HRV, strain, workouts, and personal ···
awesome-llm-powered-agent
开源
一站式收藏LLM智能体资源,快速上手
Awesome things about LLM-powered agents. Papers / Repos / Blogs / ...
xiaohongshu-mcp
开源
让 AI 客户端直接搜索和发布小红书内容
MCP for xiaohongshu.com
AgentLab
开源
给网页智能体搭统一考场,跑分对比一键复现
AgentLab: An open-source framework for developing, testing, and benchmarking web age···
AIAgentWorkshop
开源
手把手玩转 CrewAI 和 SmolAgent,快速上手 AI Agent 开发
AI Agent Work shop include Agent from Corepython, using CrewAI and Using SmolAgent
agent-smith
开源
让 AI 代理自动完成渗透测试,省时省力
"Never send a human to do a machine's job" - Open Source AI hacking agent
cognee
开源
给 AI 装上长期记忆,跨会话不忘事,知识图谱驱动。
Cognee is the open-source AI memory platform for agents. Give your AI agents persist···
