README

Rakazo

English | 简体中文 | 日本語






!Rakazo：由你掌控的 AI 队友

Rakazo 是 Grok Bot 的开源、自托管替代方案。

长期在线的 AI 队友，各自拥有记忆、例行任务、应用和计算机。在自己的机器上运行，使用自己的模型。

可在网页、桌面端、iPhone 和
Android 上使用。

它也是 Meta Muse、OpenAI Dots、Instinct、OpenClaw、Hermes Agent、Claude Duet 和 Hark Pro 的替代方案。

详情见 rakazo.com。

本文是 英文 README 的简体中文译文。自托管指南已提供中文。

 功能

- 例行任务
- 记忆
- 使用计算机和浏览器
- 私有或共享的团队计算机
- 在 Docker、云端或自己的机器上运行沙箱
- 群聊
- 任务委派与子智能体
- 构建可通过链接分享的仪表盘和文档
- 语音聊天和通话
- 任意模型，使用自己的密钥
- 数千个应用集成，并支持 MCP





 每个机器人都有一台计算机

浏览器、终端、文件和完整桌面。看着它工作，需要登录时接管，再交还给它。






 协同工作的机器人

把机器人拉进群聊并 @ 它们。它们分工合作、互相检查，再向你汇报。








 例行任务

按计划、收到邮件或 Webhook 时运行机器人，并查看每一次运行。






 页面

机器人构建实时仪表盘和文档，可全屏打开、分享，并就其提问。








 连接应用

Gmail、Slack、GitHub、Notion、Linear 等数千个应用，以及你自己的 MCP 服务器和 OpenAPI 工具。






 全平台可用

网页、桌面端、iPhone 和 Android，连接同一台服务器。







 部署到 Railway



部署包含 PostgreSQL、持久化存储和 Railway 计算机的私有 Rakazo 实例。
填写邮箱和 Railway API 令牌，登录后再连接模型。
参见安装、安全默认设置与备份。

 快速开始（已发布镜像）

需要 Docker Engine、Compose 插件、curl 和 OpenSSL。无需克隆仓库或安装 Node.js。

bash
mkdir -p rakazo && cd rakazo &&
curl -fsSLO https://raw.githubusercontent.com/elie222/rakazo/main/infra/compose/install-images.sh &&
bash install-images.sh


安装脚本会下载 Compose 文件，生成包含随机密钥的 .env，并启动 Rakazo。
再次运行时会保留已有的 .env。

打开 http://127.0.0.1:5173，创建账号并连接模型。
默认启用本地 Docker 计算机。远程计算机所需的凭据、模板和准备步骤见计算机提供商（英文）。

默认镜像标签为 edge，由主分支构建，支持 linux/amd64 和 linux/arm64。
镜像详情与标签见自托管指南。

在受限网络中，可以覆盖安装器的下载地址前缀（RAKAZO_DOWNLOAD_BASE），跳过已有的 Compose 文件
（--local / RAKAZO_DOWNLOAD_SKIP_EXISTING），或使用引导脚本的镜像地址。
参见受限网络与镜像下载。

如需让智能体协助安装，请使用 SETUP_PROMPT.md。

 在服务器上运行

后端在服务器上运行时，机器人可以持续在线。在 VPS 上使用同一个安装脚本，
然后通过桌面应用、移动应用或浏览器连接。

bash
bash install-images.sh --prepare-only
 edit .env: SANDBOX_PROVIDER=boat (or e2b / daytona / createos) with its API key, RAKAZO_HOST=your.domain
bash install-images.sh


为 5173 端口配置 HTTPS 入口。docs/self-host-production.md
介绍了 Caddy 配置和主机加固方法。在桌面应用中选择 Existing instance（已有实例），填写 https:// 地址。

 本地开发（从源码运行）

需要 Node.js 24.x（至少 24.15.0）或 Node.js 26 及以上版本，以及 pnpm 12 和 Docker。
不支持 Node.js 25.x。

bash
git clone https://github.com/elie222/rakazo.git
cd rakazo
cp .env.example .env


将 POSTGRES_PASSWORD 和 POSTGRES_APP_PASSWORD 分别设置为由 openssl rand -hex 16 生成的两个值，再把它们填入 DATABASE_MIGRATION_URL 和 DATABASE_URL。
应用以自己的 rakazo_app 登录身份连接数据库，并受行级安全策略约束；迁移则以所有者身份运行（参见 数据库角色）。
为 BETTER_AUTH_SECRET、ENCRYPTION_KEY 和 SCREEN_PROXY_SECRET 分别设置独立的长随机值。
Docker 沙箱还需要专用的 SANDBOX_SUPERVISOR_TOKEN。
你也可以设置 OPENROUTER_API_KEY，或在首次设置时连接支持的模型提供商。

使用 Docker Desktop 在宿主机上开发时，在 .env 中设置 SANDBOX_CONTROL_VIA_LOOPBACK=true。
沙箱监督服务会自动发现 Docker Desktop 的用户套接字；使用其他 Docker 运行环境时，
可以通过 DOCKER_HOST 或 DOCKER_SOCKET 覆盖该设置。

托管应用目录是可选功能。使用 Composio 时设置 COMPOSIO_API_KEY；
使用 Pipedream Connect 时设置 PIPEDREAM_CLIENT_ID、PIPEDREAM_CLIENT_SECRET 和 PIPEDREAM_PROJECT_ID。
即使不启用这两个托管目录，用户也可以在 Integrations（集成）中添加 HTTPS MCP 服务器或
OpenAPI JSON 文档。连接器凭据在服务器上加密存储，API 不会返回这些凭据。

付费数据服务（地图地点、搜索结果、工作邮箱、个人资料、SEO 数据）同样是可选的。
设置 PAID_SERVICES_PROVIDER=treg，并在 PAID_SERVICES_API_KEY 中填入组织级 Treg 令牌，
机器人即可使用部署方的账户查找并调用这些服务。启用模型额度时，每次调用按服务商成本加 20%
从组织的额度中

Top issues

Latest release

Added

- On iPhone and iPad, an image pasted into a chat's message field is added as an attachment, as on web. Text copied with it still goes into the field. This needs the new app build.
- On iPhone and iPad, Rakazo appears in the share sheet. Share a link, text, photos or files from any app, pick a bot, and it lands in that bot's message field as a draft. This needs the new app build.
- More keyboard shortcuts on web and desktop: start a group chat, connect apps, open the chat's details panel, jump to the message box and dictate. Cmd/Ctrl+/ lists every shortcut, as do Keyboard shortcuts in t