Skip to content

About

Self-hosted, always-on AI teammate with its own computer — an open-source Grok Bot alternative. Bring your own model.

Topics

Resources

Contributing

Security policy

Stars

7 stars

Watchers

1 watching

Forks

Repository files navigation

open-super-agent

可以自己部署的常驻 AI 队友:会聊天,会派活,还有一台能看、能接手的电脑。

开源,可替代 Grok Bot。模型自选,按 token 计费。

CI License: MIT Python Status

简体中文 · English

功能一览:对话里的链接卡片和视频、针对一条消息开讨论串、后台任务边做边看、Bot 用自己的电脑填表、关键操作先问你、几个 Bot 拉群分工、Bot 之间私信、一句话画海报、定时任务、连接 40 个应用、教一遍就会的技能、记住你的偏好、每一笔花费

功能一览(无声,已加速):链接卡片 · 讨论串 · 后台任务 · Bot 的电脑 · 先问再做 · 群聊 · Bot 私信 · 画图 · 定时任务 · 应用 · 技能 · 记忆 · 费用 · 看完整宣传片(2 分钟,有配音)

亮点

  • 会聊天,也会派活:每个 Bot 有自己的人设、记忆和对话。耗时的活交给后台任务,你接着聊;几个 Bot 能拉群,一个查完资料,自动交给另一个写总结。
  • 一台能看、能接手的电脑:Bot 在电脑上查资料、填表、下载文件,你能实时看屏幕;遇到验证码、登录这类步骤,它请你来做。几个任务同时做,各开一个浏览器窗口,不用排队。 电脑可以是 Bot 自己的,也可以就是你的 Mac:给了权限,它能用鼠标键盘操作微信、访达、备忘录这些 App,你一动鼠标它就停下。
  • 连上你在用的应用:应用市场收录了 40 个,Notion、Gmail、GitHub、飞书、钉钉、腾讯文档……登录或填 token 就能接,也能接任意 MCP。
  • 先问再做:发邮件、提交表单这类操作先弹卡片问你;密钥加密存在保险库里,不进聊天记录。
  • 模型随便换,花多少看得到:DeepSeek、Kimi、智谱、OpenAI、本机的 Ollama,任何兼容 OpenAI 的接口都行。按任务和天统计费用,有每日预算。
  • 教一遍就会:点“演示一遍”,在电脑上亲手做一次,Bot 把操作整理成技能,以后输入 /名字 就能重做;技能能带脚本和参考资料,也能从技能市场装现成的、导入 Claude 的 SKILL.md;说“每天 9 点帮我……”就建好定时任务。
  • 在国内好用:在飞书、钉钉、企业微信里直接和 Bot 说话;默认配置不需要国外的付费服务;界面有中文和英文。
  • 数据在你手里:跑在你自己的机器上;全部数据(连同密钥)能导出成一个加密文件,换台机器接着用。

完整的功能见 功能一览。

在哪用

用法 说明
💻 macOS 桌面 App 下载 dmg 打开就能用:约 45 MB,自带运行环境,不用装 Docker 和 Python。Bot 默认直接用这台电脑:浏览器,给了权限还有屏幕和鼠标键盘;也能换成 Docker 沙盒或云电脑。关掉窗口后在菜单栏接着跑;也能连到你的服务器,让服务器上的 Bot 用这台 Mac。见 桌面 App
🖥️ 服务器 一条 docker compose up 放到 VPS 或家里的机器上,一直开着;浏览器、桌面 App、手机、聊天软件都能连。见 用 Docker Compose 部署
📱 iPhone App(TestFlight 内测) 用相机扫电脑上的二维码就连上;要你确认的事、做完的任务推送到手机,内容加密,锁屏上就能看。见 iPhone App
💬 聊天软件 在 Telegram、飞书、钉钉、企业微信、Discord 里直接和 Bot 说话,要你确认的操作变成消息里的按钮。见 聊天软件

macOS 桌面 App:左边是 Bot 列表,中间是 Nova 把出游清单写进文本编辑后的回复,右边的电脑面板是“本机”,实时显示这台 Mac 的屏幕

iPhone App:对话 iPhone App:后台任务做完,结果是一张杭州三个景点的对比表 iPhone App:确认卡片,允许一次、总是允许或拒绝 iPhone App:实时看 Bot 电脑的画面,随时接手

上:macOS 桌面 App(看 Bot 操作整台 Mac 的录屏)。下:iPhone App(TestFlight 内测),对话 · 后台任务 · 确认卡片 · 看 Bot 的电脑

同类项目 OpenMausBot 的取舍不一样,见 和 OpenMausBot 比。

系统要求

模型跑在模型服务那边,不需要显卡(用本机的 Ollama 跑模型另算)。要多少资源主要看 Bot 的电脑放在哪:

怎么用 最低 建议 硬盘
macOS 桌面 App,电脑用本机 macOS 12,Apple 芯片或 Intel,8 GB 内存 16 GB 内存 App 约 130 MB
服务器,电脑用云电脑(Instabox) 1 核 1 GB 2 核 2 GB 5 GB
服务器,电脑用本地 Docker 2 核 4 GB 4 核 8 GB 10 GB
  • 服务本身约占 110–170 MB 内存,每个用 npx / uvx 跑的应用另占 20–60 MB;应用的 npm、uv 缓存会长到 1 GB 左右。
  • Docker 电脑:空桌面约 30 MB,开一个网页约 250 MB;三个窗口同时开着 B 站、淘宝这类页面约 0.9 GB 内存、半个 CPU 核;镜像约 1.2 GB。 机器小就把 设置 → 限制与预算 →“同时用电脑的任务”调成 1 或 2。
  • 云电脑跑在 Instabox 上,不占你的机器。作为参考:一台 2 核 2 GB 的 VPS 上,正式服务、演示服务和另外几个服务加起来用了约 1 GB 内存。
  • 桌面 App:Bot 的 Chrome 每个窗口 200–400 MB。在 App 里选“Docker 沙盒”还要装 Docker Desktop,这时建议 16 GB 内存。

以上是 2026 年 11 月在 v0.12 上实测的数字。

快速开始

在 Mac 上最快的办法是装桌面 App:到 发布页 下载对应芯片的 dmg,或者 brew install --cask kadaliao/tap/open-super-agent,打开后选“在这台电脑上运行”。

放到服务器上一直开着,用 Docker Compose,只需要装 Docker:

git clone https://github.com/kadaliao/open-super-agent.git && cd open-super-agent
cp .env.example .env     # 可以先填上 DEEPSEEK_API_KEY,也可以打开后在 设置 → 模型 里填
docker compose up -d     # 第一次要构建镜像,大约 5–10 分钟;打开 http://127.0.0.1:8765

第一次打开会有引导:接上一个模型服务、认识你的 Bot(或从模板装一个)、连一个常用应用,三步就能开始用。 自动 HTTPS、电脑改用 Instabox、国内镜像源、备份,见 用 Docker Compose 部署。

不用 Docker 运行

需要 Python ≥ 3.11 和 uv、Node ≥ 20;本地 Docker 电脑仍要 Docker(用 Instabox 或本机时不需要,见 配置 → 电脑)。

export DEEPSEEK_API_KEY=sk-...              # 可选,也可以打开后在 设置 → 模型 里填;环境变量一览见 .env.example
(cd web && npm ci && npm run build)         # 构建前端
uv run uvicorn osa.server:app --port 8765   # 打开 http://127.0.0.1:8765

第一次用电脑时会自动构建本地镜像,需要几分钟。国内网络可以先手动构建,用镜像源加速:

docker build --build-arg APT_MIRROR=mirrors.ustc.edu.cn -t osa-computer:1 osa/computer/image

Warning

默认不用登录,只能在本机或内网(例如 Tailscale)使用。要部署到公网,先设置 OSA_PASSWORD 打开登录,再用 HTTPS 访问,见 配置 → 部署到公网服务器 和 SECURITY.md。

文档

文档 内容
功能一览 全部功能,按主题分组
用 Docker Compose 部署 一条命令跑起来、自动 HTTPS、数据和备份、国内网络
配置 模型服务和各项工作用的模型、限额与单价、电脑、应用、确认规则与保险库、定时任务、推送、远程访问
事件 某件事发生时让 Bot 处理:webhook、GitHub、订阅源、网页变化、邮件、日程、天气、地震、价格、公网 IP……;地址和安全、写一个新来源
桌面 App 在这台电脑上运行或连接服务器、让服务器上的 Bot 用这台 Mac、系统通知、菜单栏、自动更新
iPhone App(内测) 扫码连接、推送怎么送到手机、推送中转看得到什么、开发
聊天软件 连接 Telegram、飞书、钉钉、企业微信、Discord,配对,权限和常见问题
给应用市场加应用 应用清单的格式、图标、在本机试、提 PR
写一个 Bot 模板 模板的格式、从现有 Bot 导出、加进内置
技能 技能的写法、带脚本和参考资料的技能包、导入导出和分享、技能市场、和 Claude SKILL.md 的兼容
架构 各组件如何协作、代码目录、设计约定
开发 本地开发、测试方法、调试技巧
和 OpenMausBot 比 两个开源 Grok Bot 替代品的取舍
路线图 接下来的方向和先后顺序;做完的计划在 docs/plans
更新日志 各版本的变化
安全说明 现在的安全边界、怎么报告漏洞

路线图

  • 客户端:iPhone App 公开测试、上架 App Store;之后是 Windows 和 Android;在聊天软件的群里使用机器人。
  • 电脑:Windows 上控制整个桌面;快照与回滚。
  • 应用生态:应用和 Bot 模板主要靠社区提 PR 收录,项目补齐清单格式和连接方式上缺的能力。
  • Bot 能力:语音对话。

每个方向的考虑和先后顺序见 路线图。想要的功能欢迎提 issue。

参与贡献

欢迎提 issue 和 PR,开始前请先读 CONTRIBUTING.md。

致谢

许可证

MIT © Kada Liao

About

Self-hosted, always-on AI teammate with its own computer — an open-source Grok Bot alternative. Bring your own model.

Topics

Resources

Contributing

Security policy

Stars

7 stars

Watchers

1 watching

Forks

Releases

Packages

Contributors

Languages