Rakazo 是一个开源的 Grok Bot 替代方案，主打“可自托管、可自选模型、可自选沙箱”的 AI Agent/AI 队友产品。它支持 Web、Electron 桌面端和移动端，核心能力包括每个 Bot 拥有独立线程、记忆、例程、历史记录和一台可视化 Linux 电脑；Bot 还可以生成其他 Bot 或在当前回合中运行短生命周期 subagent。项目使用 TypeScript、React 19、Vite、Tailwind、Electron、Expo、Hono、oRPC、Postgres、Prisma、Better Auth、Graphile Worker 等技术栈，默认通过 Pi + Docker + Graphile 运行，也支持 E2B 远程沙箱和直接桌面执行模式。目前项目处于 beta 阶段，适合对自托管 AI Agent、企业内部 AI 自动化、模型可控和沙箱隔离有需求的开发者或团队。
适用领域
AI Agent / LLM 应用 / 自托管 AI 平台 / 多端应用开发 / Electron 桌面应用 / React/Vite Web 应用 / Expo 移动端 / Docker 沙箱 / Postgres/Prisma 后端 / AI 自动化工作流 / 开发者工具 / 企业内部 AI 助手
配置难度
中高。对于熟悉 TypeScript、Node.js、Docker、Postgres 和前端开发的工程师，本地启动难度中等；但若要用于生产、自托管公网、多用户隔离、模型接入、插件集成和安全加固，难度会明显提高。AI Agent 的沙箱策略、权限边界、模型成本控制和任务审计都需要认真设计。
商业价值
未知
01
技术亮点
- 完整开源，Apache-2.0 许可证，便于企业和个人二次开发。
- 不依赖 Rakazo 官方控制平面，仓库包含完整核心产品，可自托管运行。
- 支持 Web、桌面和移动端，多端共享同一 API。
- Bring your own model：支持自带模型/API Key 或通过 ChatGPT、GitHub Copilot、xAI 等方式登录连接。
- Bring your own sandbox：默认 Docker，也支持 E2B、desktop 和 fake 测试模式。
- 每个 Bot 拥有独立线程、电脑、记忆、例程和历史，有利于长期任务和角色化 Agent。
- 支持 Bot 生成其他 Bot，以及在当前回合内运行 subagent，具备多 Agent 协作潜力。
- 提供可视化 Linux 桌面和浏览器，用户可接管登录，释放后 Bot 能继续使用会话。
- 技术栈现代，TypeScript + React 19 + Vite + Hono + Prisma + Graphile Worker，适合前后端开发者参与。
- 有较完整的测试命令，包括快速验证、完整验证和 provider canary 测试。
- 默认测试使用模拟器，不会意外调用真实模型或 Composio。
02
目标用户
- 希望自托管 AI Agent 平台的开发者
- 需要替代 Grok Bot、ChatGPT Agent 类产品的个人或团队
- 希望控制模型供应商、API Key 和运行环境的技术团队
- 需要在本地或私有服务器上运行 AI 助手的企业
- 关注数据隐私和模型执行隔离的开发者
- 想研究多 Agent、subagent、Bot 电脑环境和记忆机制的 AI 工程师
- TypeScript/React/Electron/Node.js 全栈开发者
- 希望构建企业插件、自动化办公、网页操作或代码执行助手的团队
03
配置要求
- Node.js 22+。
- pnpm 9。
- Docker Desktop，用于 Postgres 和默认 Docker 沙箱/图形化 Bot 电脑环境。
- Postgres 数据库，默认通过 docker compose 启动。
- BETTER_AUTH_SECRET：生产或联网环境必须设置为长随机字符串。
- ENCRYPTION_KEY：生产或联网环境必须设置为长随机字符串。
- OPENROUTER_API_KEY：可选，用于通过 OpenRouter 调用模型。
- COMPOSIO_API_KEY：可选，用于插件访问真实应用。
- E2B_API_KEY：当 SANDBOX_PROVIDER=e2b 时必需。
- SANDBOX_PROVIDER：可选，默认 docker；可选值包括 docker、e2b、desktop、fake。
- RAKAZO_WEB_URL：桌面端可选配置，默认 http://127.0.0.1:5173。
- 需要根据部署场景保护 API、sandbox supervisor 和 Docker daemon 相关端口，避免暴露到公网。
- 如果是公共或多用户部署，建议使用 E2B 作为更安全的沙箱边界。
- 如果使用 desktop 模式，AI 发起的命令会以 Rakazo 进程用户权限直接在宿主机执行，只适合可信单用户本地环境。
04
适用场景
- 搭建一个自托管的 AI Agent 平台，让团队成员创建和使用专属 Bot
- 运行具备浏览器和 Linux 桌面环境的 AI 助手，用于网页操作、账号登录后的自动化任务、信息收集等
- 通过 OpenRouter、ChatGPT、GitHub Copilot、SuperGrok/xAI 等方式连接不同模型
- 在 Docker 或 E2B 沙箱中安全执行 AI 发起的 shell 命令和浏览器操作
- 开发内部 AI teammate，用于研发、运营、数据整理、客服辅助或办公自动化
- 研究多 Agent 协作，让一个 Bot 生成其他 Bot 分工完成任务
- 使用 Composio 接入真实应用插件，实现对外部 SaaS 工具的操作
- 构建桌面版 AI 助手，并可选择让 Bot 使用 Docker 或直接在本机执行任务
- 作为 AI Agent 产品原型，二次开发为面向特定行业的智能助手平台
05
部署与配置
- 确保环境满足要求：Node.js 22+、pnpm 9、Docker Desktop。
- 克隆仓库后进入项目根目录。
- 执行：cp .env.example .env。
- 编辑 .env 文件，至少设置 BETTER_AUTH_SECRET 和 ENCRYPTION_KEY 为足够长的随机字符串；如果需要部署或联网访问，不要使用默认占位值。
- 可选：设置 OPENROUTER_API_KEY；如果不设置，也可以在产品 onboarding 阶段手动粘贴 API Key，或使用 ChatGPT Plus/Pro、GitHub Copilot、SuperGrok/xAI 登录连接模型。
- 可选：设置 COMPOSIO_API_KEY 以启用插件访问真实应用。
- 启动 Postgres：docker compose -f infra/compose/docker-compose.yml up postgres -d。
- 安装依赖：pnpm install。
- 生成数据库客户端：pnpm db:generate。
- 执行数据库迁移：pnpm db:migrate。
- 构建沙箱：pnpm sandbox:build。
- 启动开发环境：pnpm dev。
- 访问 Web 应用：http://127.0.0.1:5173。
- 注册账号，连接模型，创建 Bot 并发送消息。
- 验证运行状态：curl -s http://127.0.0.1:3100/health，期望看到 runtime 为 pi、sandbox 为 docker、wakeup 为 graphile。
- 如需运行桌面端，在保持 pnpm dev 运行的同时执行：pnpm --filter @rakazo/desktop dev。
- 如需打包桌面安装包，执行：pnpm --filter @rakazo/desktop pack，产物位于 apps/desktop/out/。
06
风险与注意事项
- 项目仍处于 beta 阶段，API、产品体验和部署方式可能频繁变化。
- AI Agent 具备执行 shell 命令和操作浏览器的能力，若沙箱配置不当可能带来安全风险。
- desktop 模式隔离最弱，不适合公共服务器或多人共享环境。
- Docker supervisor、API 端口和本地 Docker daemon 相关能力必须保持私有，否则存在被滥用风险。
- 公共或多用户部署需要更强隔离，推荐 E2B，但会增加额外成本和依赖。
- 依赖多种外部服务或模型入口，如 OpenRouter、ChatGPT、GitHub Copilot、xAI、Composio、E2B，实际可用性和成本受第三方影响。
- Claude Pro 目前未在 Rakazo UI 中直接支持，Pi 的 Claude 登录 localhost callback 不适合 Web app 场景。
- 运行环境要求较高，需要 Node.js 22、pnpm、Docker、Postgres，对初级用户有一定门槛。
- 桌面打包产物仍然需要运行中的 API 和 Web origin，不是完全独立的单机应用。
- AI 自动化真实应用可能涉及账号安全、权限滥用、合规和审计问题。
2026-08-15
第30名
新收录 · github_search
