帮助中心

文档、教程、API 参考与常见问题

🚀

快速入门

5 分钟安装 ROLEOS CLI，安装你的第一个 Bundle 并启动运行。

开始 →
📋

RKT 协议规范

四大对象模型、Manifest 结构、6 层 Validator 完整技术细节。

查看协议 →
💻

GitHub 源码

ROLEOS 引擎、CLI、Studio 和协议包的完整源代码。

GitHub →
API 参考

ROLEOS Cloud API

端点方法功能
/api/v1/auth/registerPOST用户注册
/api/v1/auth/loginPOST用户登录
/api/v1/user/profileGET获取个人信息
/api/v1/user/profilePUT更新个人信息
/api/v1/bundlesGETBundle 市场列表
/api/v1/bundles/:idGETBundle 详情
/api/v1/bundles/:id/downloadPOST下载 Bundle 包
/api/v1/bundles/submitPOST提交 Bundle 审核
/api/v1/user/favorites/:idPOST收藏 Bundle
/api/v1/user/favorites/:idDEL取消收藏
CLI 命令

ROLEOS CLI 参考

命令说明
roleos init初始化 ROLEOS 工作区
roleos start启动 ROLEOS 全栈服务
roleos install <bundle>从市场安装 Bundle
roleos list列出已安装的 Bundle
roleos status查看系统运行状态
roleos update <bundle>更新 Bundle 到最新版
roleos remove <bundle>卸载 Bundle
roleos login登录 roleos.ai 账号
常见问题

FAQ

ROLEOS 和 OpenClaw 是什么关系？
OpenClaw 是 AI Runtime（类似操作系统），ROLEOS 是基于 RKT 协议的 Bundle 管理工具（类似 App Store + 包管理器）。ROLEOS 将 Bundle 安装到 OpenClaw 上运行。
RKT 协议是开源的吗？
是的。RKT 协议规范（@rkt/protocol）完全开源，任何人都可以基于 RKT 协议创建 Bundle。ROLEOS 工具链也是开源的。
Bundle 安装会修改我的系统文件吗？
不会。ROLEOS 使用「非侵入式投影」机制 —— Bundle 内容投影到 OpenClaw 的 workspace 中，不修改宿主系统。卸载时完全回滚，零残留。
如何发布自己的 Bundle？
1. 编写 manifest.json（参考 RKT 协议规范）
2. 使用 ROLEOS Studio 或 CLI 打包
3. 提交到 Bundle 市场审核
4. 审核通过后自动上架
算力包是什么？
算力包为没有本地 GPU 的用户提供云端 LLM 调用能力。购买算力包后，Bundle 中的 Kit 可以直接调用 GPT-4o、Claude、Gemini 等主流模型。
ROLEOS 支持哪些 AI Runtime？
目前主要支持 OpenClaw。未来将支持 Cursor、Continue 等更多 AI Runtime。Bundle 通过协议标准化，可以跨 Runtime 安装。