源码系统概览
文章正文
Rakazo 是一款开源的 AI 智能体机器人平台，定位是 Grok Bot 的开源替代品，可以自行选择模型与沙箱运行环境。
项目采用 TypeScript 全栈技术栈，提供 Web、桌面与移动三端客户端，支持自托管部署，机器人拥有独立的线程、记忆、例行任务与历史记录。
源码简介
Rakazo 的核心思路是让用户真正拥有自己的 AI 队友，而不是被绑定在单一厂商的托管服务上。
每个机器人都有自己的线程、记忆、例行任务与历史记录，工作区机器人默认共享一台团队电脑，也可以为单个机器人分配私有电脑。
机器人可以再生成机器人，新机器人以普通成员身份拥有独立线程，也可以在当前回合内运行短生命周期的子智能体。
沙箱层面支持 Docker、E2B、Daytona 等多种提供方，模型层面可通过 OpenRouter API 密钥接入，也可用 ChatGPT Plus、GitHub Copilot、SuperGrok 账号直接授权。
项目当前处于 beta 阶段，采用 Apache-2.0 协议开源，项目作者与维护者为 elie222，GitHub 已有 826 颗星。
适用场景
适合希望自托管 AI 机器人工作台的个人开发者和团队，例如搭建私有代码助手、自动化办公机器人或浏览器操作智能体。
适合需要把多个 AI 模型统一在一个界面内管理的场景，OpenRouter 密钥或 ChatGPT、Copilot、xAI 账号都能作为模型来源。
适合对沙箱隔离有要求的部署，Docker 本地沙箱适合单机自托管，E2B 与 Daytona 远程沙箱适合公开或多人部署。
与 ChatGPT 网页版和 Grok 等托管服务相比，Rakazo 的机器人数据与执行环境由部署方自己掌控。
功能亮点
机器人拥有独立线程、记忆与例行任务，长时间任务可以按计划自动运行，历史记录按线程持久保存。
机器人可以生成子机器人或子智能体，复杂任务在会话内拆分并行处理，子智能体结果汇总回当前线程。
图形化电脑面板基于 noVNC，模型可以观察并操作 Linux 桌面、浏览器与图形应用，用户也可以与同一桌面实时交互。
Web、Electron 桌面端与 Expo 移动端共享同一套 API，多端消息与状态实时同步。
与 ChatGPT 托管聊天相比，Rakazo 的模型与沙箱均可自选，数据留在自己的服务器上。
与 Dify 这类低代码智能体平台相比，Rakazo 更侧重机器人自治执行与桌面沙箱，而不是可视化工作流编排。
| 维度 | Rakazo | ChatGPT 托管服务 |
|---|---|---|
| 技术栈 | TypeScript、React 19、Hono、Prisma | 闭源云端服务 |
| 部署复杂度 | 需 Node.js、Docker、Postgres 自托管 | 注册即用 |
| 功能侧重 | 机器人自治、桌面沙箱、数据自持 | 通用对话与生态 |
技术架构与部署指南
技术栈与运行环境
前端：React 19 + Vite + Tailwind，桌面端 Electron，移动端 Expo（React Native）。
后端：Hono + oRPC 服务端，Graphile Worker 任务队列。
数据库：PostgreSQL，Prisma 7 ORM，共 30 余张表覆盖用户、会话、机器人、线程、消息、任务与记忆文档。
运行环境：Node.js 22 以上、pnpm 9、Docker Desktop（Postgres 与图形机器人电脑）。
其他依赖：Better Auth 认证、OpenRouter 模型网关、E2B 或 Daytona 沙箱、Composio 插件桥接。
安装与部署提示
本地运行先复制 .env.example 为 .env，把 BETTER_AUTH_SECRET 与 ENCRYPTION_KEY 设置为长随机字符串。
用 docker compose 启动 Postgres，再依次执行 pnpm install、pnpm db:generate、pnpm db:migrate 与 pnpm sandbox:build。
pnpm dev 会同时启动 API（3100 端口）、Graphile Worker、Vite 前端（5173 端口）与沙箱管理服务（7091 端口）。
健康检查访问 127.0.0.1:3100/health，返回 runtime、sandbox、jobs、realtime 四项状态即表示服务正常。
公开或多人部署建议使用 E2B 或 Daytona 远程沙箱，并妥善保管沙箱提供方 API 密钥。
截图与演示说明
安装完成后打开 5173 端口前端，注册账号后进入机器人创建流程，可粘贴 API 密钥或选择账号授权模型。
主界面左侧是机器人列表，每个机器人可展开独立线程，消息区支持多轮对话与任务状态展示。
右侧电脑面板是实时 Linux 桌面，模型可以打开浏览器、操作文件与终端，用户可切换为可编辑模式接管桌面。
设置页提供模型选择、插件管理、例行任务计划与主机电脑接管选项，对应 ModelSettingsOverlay、PluginsOverlay 与 RoutineSchedule 页面。
移动端与桌面端入口位于 apps/mobile 与 apps/desktop 目录，界面与 Web 端保持一致。
常见问题
问：Rakazo 是免费开源的吗？
是，项目以 Apache-2.0 协议开源，源码免费下载，模型与沙箱按部署方自己的配置付费。
问：机器人的执行环境安全吗？
默认在 Docker 沙箱中运行，公开部署建议改用 E2B 或 Daytona 远程沙箱，本地沙箱不要把管理端口暴露到公网。
问：和 ChatGPT 或 Grok 有什么区别？
Rakazo 是自托管开源平台，机器人、线程与记忆数据由自己保存，模型来源也由自己选择，而不是绑定单一厂商。
问：需要什么运行环境？
Node.js 22 以上与 pnpm 9，Postgres 由 Docker 提供，沙箱需要 Docker Desktop 或 E2B、Daytona 账号。
安全风险提示
本次检查未发现明显恶意文件，源码中涉及沙箱执行、浏览器代理与模型密钥等敏感能力。
路径：infra/sandboxes/supervisor；类型：本地 Docker 控制；证据：supervisor 通过 Docker API 管理沙箱容器；建议：保持管理端口仅监听本机。
路径：packages/adapters/src/desktop-sandbox.ts；类型：本机进程执行；证据：desktop 沙箱直接以进程用户权限运行 shell 命令；建议：仅限可信单用户环境使用。
路径：packages/db/prisma；类型：数据加密依赖；证据：ENCRYPTION_KEY 用于敏感字段加密；建议：部署前务必替换为随机长密钥。
特别提示：本源码未检测安全风险文件，下载后请务必进行安全审计，删除恶意代码后再部署使用！
下载说明
源码仅供学习研究、测试部署和二次开发参考，商用前请自行确认授权、版权和安全风险。
机器人可访问本地与远程沙箱执行命令，生产环境请遵循最小权限原则，严格控制模型可操作范围。
最后更新：2026-08-18。
GitHub项目开源地址：https://github.com/elie222/rakazo