nickvasilescu/grokbot-clone

项目介绍

Grokbot Clone 是一个可自行部署的常驻 AI 助手运行时，用你自己的 Grok、Orgo 和 Composio 账号跑起来。每个 Bot 有名字、外观、指令、技能和持久记忆，并拥有一台云电脑，可以浏览网页、执行 shell 命令、使用 Linux 桌面，你能实时观看或接管。Bot 之间可以委派任务、创建子代理、用 @ 提及加入群聊，还能定时执行任务、响应应用事件，并通过实时语音通话把任务交给同一个运行时。

服务端负责整个智能体循环：构建上下文、流式调用 Grok Responses API、执行工具、在 Composio 写操作前暂停等待审批，然后继续直到任务完成。云电脑来自 Orgo VM（每个账号共享一台 VM，最多同时四台 Bot 桌面），应用目录、认证和触发器由 Composio 提供。对话、设置和智能体状态保存在本地 SQLite。项目是独立实现，与 xAI、Cursor/Anysphere 无隶属关系 README。

快速使用

1. 安装 Node.js 22.22 或更高版本，然后拉取并安装依赖：

git clone https://github.com/nickvasilescu/grokbot-clone.git
cd grokbot-clone
npm ci
cp .env.example .env

2. 在 .env 中填写 XAI_API_KEY、COMPOSIO_API_KEY、ORGO_API_KEY、ORGO_WORKSPACE_ID 和 SESSION_SECRET。会话密钥可用 openssl rand -hex 32 生成。默认文本模型是 grok-4.7，可通过 XAI_MODEL 换成你账号可用的兼容模型。示例环境文件还包括本地地址、电脑规格和可选的语音配置 .env.example。

3. 在两个终端分开启动 API 和前端：

npm run dev -w server
npm run dev -w web

打开 localhost:5173，前端会把 API 请求代理到 8787 端口。可用 Google 登录，或在 DEV_LOGIN=1 时使用本地邮箱表单。账号自带一个主 Bot，可以再建一个、设定角色并派任务；首次电脑任务会创建 Orgo VM。

部署构建版本时先 npm run build 再 npm start，应用在 localhost:8787 提供。把 APP_URL 和 SERVER_URL 设为该地址或公网 HTTPS 地址，保证登录跳转回到正确位置，对外开放前关闭 DEV_LOGIN。

使用约束

项目处于实验阶段，未经安全审计。同一账号下的 Bot 共享一台 Orgo VM，隔离有限；Composio 的写操作审批无法覆盖 Bot 通过浏览器或 shell 的所有行为。模型调用、应用操作和云电脑都走你自己的服务商账号，可能产生费用。集成测试 node tests/e2e.mjs 会调用真实服务商，且要求 /usr/bin/google-chrome；语音测试脚本含机器相关路径，换机器需先修改。代码采用 MIT 许可，第三方素材和商标归各自所有者 许可 第三方声明。架构和集成细节见 架构文档、Orgo 集成指南 和 Grok/Composio 指南。

HotRepo 点评

仓库在 2026-11-11 的 TypeScript 新项目快照中记录为 104 stars、63 forks，约 96 分钟窗口内新增 4 stars 和 2 forks。Fork 与 Star 的比例偏高，说明不少人是在复制或改造这套运行时，而不只是点星，这和「自托管、可拆改的克隆」定位相符。但样本只有一个短窗口，不足以判断趋势；真正稳定的信号是架构文档和 MIT 许可。