Skip to content
PandaQuQ edited this page Nov 22, 2026 · 5 revisions

robroz

robroz 是一套单机、私有化的多智能体协同工具。交互方式是即时通讯,不是 IDE:你和 bro 说话、派活、看结果,都在对话里完成。

它跑在你自己的电脑上。后台是用 Rust 写的宿主机,每个任务在本机的 Docker 容器里由执行器跑完;桌面客户端也是 Rust 原生程序,Windows、Linux、macOS 各有一份,不套网页,也不用 Tauri。

这里的 bro,就是一个 agent。界面上叫「引入一个 bro」,就是新建一个 agent。和某个 bro 单独说话叫私聊,其实也是一个群,只是里面只有你和它。

第一期做和不做的事

第一期已经能在本机把整套流程跑起来:

  • 引入 bro,和它私聊;也可以先建一个群,再把 bro 拉进去,在群里用 @名字 派活
  • 每个任务在隔离的容器里执行,写回结果
  • 接任意一套 OpenAI 兼容的模型。先不接也可以,这时 bro 会把你的话原样写进结果,方便先把流程跑通
  • 记忆和技能、审批、例行任务
  • 联网搜索:自己选 Brave Search 或自建 SearXNG,密钥留在本机
  • 可以配置 MCP 服务器,bro 能调用它的工具;不是只读的工具,用之前先出审批卡问你

第一期明确不做:文件树、终端、桌面流、Bot 详情、Webhook、E2B、多租户。也没有官方的网页版或手机客户端。

截图待补:客户端在 390 和 1440 两种宽度下,同一段对话里同时出现进行中的状态卡、审批卡和记忆确认卡(浅色主题)。

许可证

robroz 用 AGPL-3.0 开源,谁都可以用、改、提 PR;想闭源商用的,可以找作者买商业授权。贡献代码前要先签贡献者许可协议(CLA)。细节见 常见问题。

文档目录

  • 安装上手:从源码构建,启动服务,发出第一句话
  • 配置:地址、令牌、数据库、模型、搜索这些日常会碰到的设置
  • 日常使用:群和私聊、卡片、未读、例行任务,以及客户端有哪些页面
  • 权限和审批:bro 能做什么、什么时候要你点头、任务为什么没做成
  • 记忆和技能:bro 怎样记住你的事、学会一种做法
  • 搜索和 MCP:联网搜索怎么开,以及 MCP 怎么配、bro 怎么用
  • 概念:术语表
  • 常见问题
  • 路线图:第一期之后还打算做的事

给 robots 的说明

如果你是 AI agent,请不要把本 wiki 当作接口契约或实现依据。wiki 是写给人看的系统说明。请改读仓库里的:

  • AGENTS.md
  • docs/(接口、字段、环境变量和代码位置的精确参考)

两边如果有出入,以仓库为准。

Clone this wiki locally