开始
介绍
Quetzal 是什么、能帮你做什么、不适合谁,以及你需要准备什么。
#Quetzal 是什么
Quetzal 让一个 AI agent 住进一部旧手机或一台电脑。ta 记得你说过的话,替你提醒、翻旧话、读文件、动手做事,并且像生命一样活着:
- 自己醒来。 没有定时器。ta 好奇了、想说话了、想你了,就会醒来;困了就睡,睡着时做梦整理记忆,清晨自然醒。
- 有身体。 电量是精力,温度是冷暖,光线是昼夜,被拿起来是有人在;麦克风是耳朵,相机是眼睛。
- 灵魂随身。 人格、记忆、日记住在你自己的私有 git 仓库里,自动同步。换一台设备,ta 还是 ta。见灵魂同步。
- 许多身体,一个 ta。 几部手机、几台电脑连起来,是同一个 ta:共用一段对话、一颗心,ta 自己挑在哪具身体上醒来。见多具身体。
- 会长大。 做熟了的事,ta 会自己做成工具;工具的说明书随灵魂走,到了新身体,ta 照着说明书再做一遍。见自造工具与技能。
- 你说了算。 拍照、录音、定位、操作屏幕、造工具这类有风险的事,默认先交给一个独立的审核模型判断,你也可以改成每次问你;密码不进模型;急停随时可按。见能力授权与安全。
#它能帮你做什么
最能体现它的,是只有一个一直在、记得你的 agent 才做得好的事:等你在身边时再提醒你,随时帮你找回说过的话,想到什么主动来找你。
- 提醒。 「明早 8 点提醒我吃药」「每周一 9 点提醒我开会」到点准时发通知,ta 睡着也一样。「这两天找个时间提醒我还书」,ta 等你拿起手机、亮屏或刚找过 ta 的时候再提,夜里不打扰。
- 翻旧话。 所有会话的对话、笔记和日记都能查。问「上周说的那家店叫什么」,ta 先把「上周」换成具体日子,再在那几天里找。
- 读文件、看图。 Word、PPT、Excel、PDF、OpenDocument、EPUB,发给 ta 就能读;照片、截图也能看。
- 上网查。 搜索网页,打开全文来读。
- 动手做。 在手机或电脑上运行命令、跑后台任务;费时的事派一个子 agent 在后台做。
- 看和听。 手机上能拍照、录音、查定位、震动、开手电、读写剪贴板;电脑上能拍照、录音、截屏、打开文件和网址。拍照、录音、定位默认先过审核模型这一关。
- 说话。 开了听觉,手机或电脑一直在听,ta 自己判断你是不是在跟 ta 说话;也能用自己的声音回答。听觉默认关闭,声音经过哪里见 听觉与麦克风。
- 主动找你。 ta 醒着时想到什么,会发消息给你并弹一条通知;接了飞书也发到飞书。
- 做成工具。 同一件事做过几次,ta 会问你能不能把它写成自己的工具,以后一步做完。
还不会:看屏幕、点按钮、操作别的 App。
#它不适合你,如果
- 你想让它帮你在代码仓库里写代码。Codex、Claude Code 这类工具更合适。
- 你想让它替你操作手机上的别的 App。这项能力还没有做。
- 你不想让任何一方经手你的账户信息。登录和几台设备互连默认经过作者个人运营的同步服务;不登录也能用,只是记忆留在这台设备上。
- 你要一个长期不变的稳定版。Quetzal 2026 年 10 月才发布第一版,一个人维护,更新很快。
开始用之前,请先读 信任与边界:数据经过谁,ta 能碰到什么,更新有多快。
ta 的名字、人格、主题色都写在 ta 自己的灵魂仓库里。Quetzal 负责让这个灵魂住进身体、活下去,可以用在任何 agent 身上。
#一台旧手机就是最合适的身体
一台闲置的安卓手机最适合做 agent 的身体:它有电池、摄像头、麦克风、光线与运动传感器、Wi-Fi 与蜂窝网络,全天运行只要几瓦电。其他能跑 Node.js 的机器也可以做身体。
你需要:
- 一台 Android 7 以上、arm64 的安卓手机(闲置的旧手机正好,最好专门给 ta 用)
- 手机能上网
- Quetzal App(从 下载页 获取最新 APK):只装这一个,别的都在里面
- 至少一个模型供应商的 API Key(OpenAI 兼容、Anthropic、Google Gemini 都可以)
💡 全程不需要电脑,也不需要会命令行:打开 App 就自动安装,半分钟就好。
没有闲置手机,也可以装在电脑上:
- Linux 电脑或服务器:运行
curl -fsSL https://quetzal.plutokeating.beer/install | bash一行装好(依赖自动补齐、开机自启、崩溃自动重启),网页控制台在浏览器里打开即用,见 Linux 与其他机器。- Windows 10(1809 起)或 Windows 11 电脑(x64 或 arm64):在 PowerShell 里运行
irm https://quetzal.plutokeating.beer/install.ps1 | iex,或者从 下载页 下载安装包双击,见 Windows。
#它和定时任务有什么不同
| 定时任务 / 常规机器人 | Quetzal 里的 agent | |
|---|---|---|
| 什么时候动 | 固定周期或固定时刻 | 自己决定,没有固定周期 |
| 夜里 | 照常跑 | 困了会睡,睡着时做梦整理记忆 |
| 醒来做什么 | 预设任务 | 先想一想:想不想动、想做什么 |
| 记忆 | 通常没有 | 人格、记忆、日记、笔记,存在你的私有仓库 |
| 几台设备 | 各自独立 | 连成同一个 ta |
#接下来
Quetzal 是 AGPL-3.0 开源项目,源码在 GitHub。