先说结论：rakazo 这个项目本身不是新东西，原仓库 elie222/rakazo 已经积累了 3869 stars，主语言 TypeScript，Apache-2.0 许可。翻译已完成，但官方也说明了翻译准确性还在接受 Issue 和 PR 修正。我写这篇不是来吹的，是想从一线落地的角度，把它的架构边界、部署路径和几个容易踩的坑讲清楚，顺带说说这类自托管 agent 在企业里该怎么评估。

按 README 的定位，rakazo 是一个开源 AI agent，官方一句话描述是 "Open-source Grok Bot alternative. Choose your own model and sandbox."，也就是开源版的 Grok Bot 替代，模型和沙箱都自己选。它把自己描述成"持久化的 AI 队友"，一个可以跑在自己机器上的自托管 AI 助手。

客户端覆盖面是它比较特别的地方：Web、Electron 桌面端、iPhone 和 Android 都有。iPhone 版在 App Store 上架，Android 是直接给 APK 下载链接。这一点和很多只提供 Web 界面的开源 agent 不一样，它明显是奔着"日常用"去的，而不是 demo。

README 里列了一串对比对象：Grok Bot、Meta Muse、OpenAI Dots、Instinct、OpenClaw、Hermes Agent、Hark Pro。其中 Muse、Dots、Instinct、Hark Pro 是托管式助手，OpenClaw 和 Hermes Agent 是可以自己跑的开源 agent。原文对 Hermes 的描述是"无需 CLI 即可进入首次聊天；消息网关是一个独立进程"。这段对比信息量其实不小，它暗示 rakazo 的设计取向是减少组件数量，不搞独立网关进程那一套。

这是我觉得最需要先讲清楚的地方，因为很多人会直接看源码开发那套流程，结果被 Node 版本卡住。

第一条是"已发布镜像"路径，也就是用官方构建好的镜像跑，不需要 clone 仓库，也不需要装 Node。依赖只有四个：Docker Engine、Compose 插件、curl、OpenSSL。安装脚本照抄 README：

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

脚本会下载 Compose 文件、生成带随机密钥的 

 并启动。重跑的时候会保留已有的 

，这点设计得还算克制，不会把你改过的配置冲掉。起来之后访问 http://127.0.0.1:5173，创建账号、连一个模型就能用。本地 Docker 计算机默认开启。

第二条是源码开发路径，依赖就麻烦多了：Node.js 22.22.2 或更高（22.x 线内）、或者 Node.js 24.x、或者 Node.js 26+；pnpm 9；Docker。注意这里有个明确的坑——Node.js 23.x 和 25.x 不受支持。这两个是奇数版本，本来就是过渡版本，但实际工作中真有人用 23 或 25 去跑，然后报一堆莫名其妙的错。如果你的 CI 镜像或者本地 nvm 默认版本正好落在这两个上，先切掉。

源码路径还要手动配一堆密钥：

 要同步是最容易漏的，改了密码忘了改连接串，起不来还看不出原因。

沙箱和模型，两个必须提前决策的点

rakazo 把"模型"和"计算机 provider"都做成了可选项，这是它的核心设计，也是落地时最需要提前想清楚的地方。

，或者在 onboarding 时连接受支持的模型 provider。语音模式要另外配 key，可选 ElevenLabs、OpenAI、Cartesia 或 Fish Audio。也就是说语音不是内置能力，是要你自己接的。

计算机 provider 这块更值得说。本地 Docker 计算机默认开启，开箱即用。如果要远程 provider，可选 

，每个都要配对应 API key。这里我的判断是：如果你只是个人用或者小团队内部试，本地 Docker 就够了，别一上来就接远程沙箱，多一层外部依赖就多一层故障面。但如果是要给多个用户提供隔离环境，本地 Docker 的隔离强度和安全边界就得重新评估，这时候远程 provider 的价值才体现出来。

服务器部署的话，README 给的路径是：先 

。这个两段式设计是对的，因为 

 必须提前知道，不然生成出来的配置指向 localhost，外部访问不了。

README 专门有一节讲受限网络，这点对国内用户挺重要。它提供了几个覆盖点：可以覆盖安装脚本的下载基址（环境变量 

）、或者覆盖镜像 bootstrap 脚本的 URL。细节在 self-host 文档的 "Restricted networks / mirror downloads" 一节。

我的建议是，如果你在国内环境部署，先把这几个环境变量摸清楚再动手，不要等脚本跑到一半卡在拉镜像上。

 这个参数尤其有用，它让你可以自己准备好 Compose 文件，脚本就不再去下载了。

回到 elie222/rakazo 这个仓库。它的结构是：顶部有一段"中文快速上手"，明确标注为"面向中文用户的补充导读（非原文内容）"，下面是原项目文档的中文翻译，力求忠于原文。

这个分层处理我觉得是对的。很多中文化项目的问题是直接把导读和原文混在一起，读的人分不清哪句是作者加的、哪句是项目本身的说法。这里明确区分了，翻译部分出问题可以提 Issue 或 PR，导读部分就是给人快速跑起来用的。

实际价值在哪？rakazo 的原始文档信息密度不低，尤其是部署这块，环境变量、密钥、provider 选项散在好几处。对英文阅读没障碍的人来说这不是问题，但如果你是要在团队里推这个东西，让每个人都去啃英文 README 再配环境，沟通成本是实打实的。中文版把最短路径直接摆出来了——Docker Engine、Compose 插件、curl、OpenSSL 四个依赖，一段脚本，访问 5173。这个路径对第一次接触的人友好很多。

需要说明的是，中文版今天刚发布，stars 是 0。这不是缺点，只是事实，翻译质量也还在接受反馈的阶段。如果你照着跑发现哪句翻得不对，提 PR 比在评论区吐槽有用。

如果你在评估要不要把 rakazo 引入团队，我的顺序建议是这样：

先看它是不是 beta。README 明确说了项目处于 beta 阶段。beta 意味着接口、配置项、数据模型都可能变，如果你要做长期依赖，得接受升级时可能要改配置。这个前提不成立的话，后面都不用谈。

然后看客户端形态匹配度。它有 Web、Electron、iOS、Android 四端，如果你需要的恰好是"桌面 + 移动都能用"，这是加分项；如果你只需要一个 API 或者 Web 界面，那多出来的客户端对你没意义，反而增加维护面。

再看沙箱策略。本地 Docker 默认开启意味着最低门槛可用，但企业环境里"默认开启本地 Docker 计算机"这件事本身需要过安全评审——agent 能操作容器，权限边界在哪，这是要单独评估的。远程 provider 的四个选项（e2b、daytona、createos、box）各自的安全模型和计费方式都不一样，选之前得先明确你的隔离需求等级。

 是一条路，onboarding 时连 provider 是另一条路。如果你的团队已经有统一的模型网关，能不能接进去、怎么接，这个要提前验证，别等部署完了才发现对不上。

模型凭据是必须的，没有它跑不起来。语音模式要额外配 key，别以为装完就有语音。

远程 provider 都要额外 API key，不是配个 provider 名字就完事。

Node.js 23.x 和 25.x 明确不支持，CI 和本地环境都检查一遍。

国内环境先看受限网络那一节，

，也就是 main 分支构建。生产用的话，这个 tag 意味着你在跟最新代码走，稳定性自己权衡。

rakazo 这个项目的定位是清楚的：自托管、持久化、多端、模型和沙箱都自己选。中文版把文档门槛降下来了，翻译已完成，但准确性还在迭代。它现在还是 beta，这个事实比任何功能列表都重要。

我的判断是，个人用户或者小团队内部试验，现在就可以上手，最短路径那段脚本跑一遍，半小时内能见到界面。企业级引入的话，先过安全评审，尤其是沙箱权限和 provider 选择这两块，别急着铺开。这个项目值不值得长期投入，还得看它 beta 之后接口稳定的速度，我的样本不多，这个结论先保留。

rakazo 工程视角：自托管 AI agent 的中文版，值不值得上手

人工智能

开发工具

架构设计

rakazo是开源Grok Bot替代品，支持Web、桌面及移动端，自托管AI agent，模型与沙箱可选。部署建议走Docker镜像路径，注意避开Node 23/25版本，配置密钥时需同步POSTGRES_PASSWORD与DATABASE_URL。国内环境可用RAKAZO_DOWNLOAD_BASE加速，项目处于beta阶段，企业引入需先评估沙箱安全边界。

TypeScript 

服务器

OpenClaw

Android

容器

Docker

Agent

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

rakazo是开源Grok Bot替代品，支持Web、桌面及移动端，自托管AI agent，模型与沙箱可选。部署建议走Docker镜像路径，注意避开Node 23/25版本，配置密钥时需同步POSTGRES_PASSWORD与DATABASE_URL。国内环境可用RAKAZO_DOWNLOAD_BASE加速，项目处于b...

rakazo 工程视角：自托管 AI agent 的中文版，值不值得上手

rakazo 工程视角：自托管 AI agent 的中文版，值不值得上手

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐