开源永远在线的AI助手:事件收件箱、定时器、权限、发件箱
Anthropic 发布 always-on agents 文章后,作者为 waku-agent 加了 always-on 层。18 分钟视频拆解设计,核心循环 95 行 Python,本地优先,代码可读。开源,支持多模型。
Anthropic 发布了一篇“Building always-on agents”的文章。Shen Sean Chen 读完,对自己的开源项目 waku-agent 做了一次大升级。这个项目是一个本地优先的个人 AI 助手,核心循环只有约 95 行 Python,你一个下午就能读完。
之前它已经有 loop engineering、memory 和 evals。现在多了一个 always-on 层:事件收件箱、定时器、权限、发件箱,全部是真实代码。
为什么需要 always-on agent?
ChatGPT 或 Claude 不会知道你有任务要来了,除非你输入到对话框里。Muse、Grok Bot、OpenAI Dots、Claude Duet 都在做个人 agent,原因就是它们 always-on。一个 always-on agent 会在事情发生时醒来,而不是等你问。
系统设计
在 18 分钟的视频里,作者拆解了四个核心组件:
- Event inbox:一个简单的数据库,一行就是一个事件。这是 agent 的待办清单。
- Timers:告诉 inbox 未来某个时刻要触发什么,比如每周一的简报。
- Permissions:每次工具调用都检查,需要你的时候先问你。
- Outbox:告诉你它做了什么,或者需要你做什么。
然后他现场在 Slack 里跑了一遍。@它,它就醒来。它拒绝在共享频道里读收件箱。设置的一个定时器一分钟后触发。
团队 agent 的路由器还在白板上,没写进代码。

为什么开源
作者认为开源会帮到很多企业主和创业团队,因为你不一定想把所有数据分享给科技巨头。这个 repo 的代码是 MIT 许可(hosted 部分除外)。
有网友问定时器触发时,权限是检查当前状态还是设置时的状态?作者说正在做,直觉是需要先检查再干活。还有网友提醒给每个 inbox 行加幂等键,避免同一事件被处理两次。作者表示赞同。另一个人说 outbox 是被低估的部分:副作用排队后,去重、重试、人工检查点基本免费。
快速上手
想直接跑:
pip install waku-agent
waku
waku dashboard
想读代码或贡献:
git clone https://github.com/ShenSeanChen/waku-agent && cd waku-agent
uv venv && uv pip install -e .
cp .env.example .env
uv run waku
内存是一个 SQLite 文件:~/.waku/state.db。支持 Anthropic、OpenAI、Gemini、DeepSeek、OpenRouter 等。
完整 18 分钟视频在第一条回复里。GitHub repo 已 2.2k star。
GitHub Repo · 托管版本 · 社区
发布时间: 2026-11-23 05:54