先说结论:
- Agent Autoloop(MIT)把「人守终端」改成「事件 / 定时派活 → Agent 干完一轮退出 → 拿不准才发卡片 → 你回答后继续」。官方 README 写明:macOS / Linux;Windows 官方版待定(进度见 issue #17,README 称目前可用 WSL2)。
- 安装一行:
curl -fsSL https://raw.githubusercontent.com/KKKKhazix/agent-autoloop/main/install.sh | sh,装完先agent-autoloop try。 - 我们 2026 年 11 月 6 日在 Linux 上实测:Node 升到 24.22.2,装上 agent-autoloop v1.5.0,用 Codex(本站 Key,模型
gpt-6.1-sol)跑通审批闭环——提问约 9 秒出卡片,回答「绿色」后同一会话约 10 秒收束为「试跑通过」。无图形界面时桌面通知发不出(notify-send不存在),用status/answer仍可完成。 - 规则写在
~/.agent-autoloop/rules.json:一条 cron 早报、一条 GitHub issues 规则即可起步;改完几秒内生效,用agent-autoloop check校验。 - 无人值守等于把本机权限交给循环:卡片链接勿外传、Webhook 要鉴权;据项目 SECURITY,提示注入未根治,默认权限是
edit,有副作用的事先ask。
创建 API Key,给 Claude Code / Codex 接上再跑后台循环 →
它解决什么问题
多数人用 Claude Code 或 Codex 时,是守着终端:输入 Prompt、盯着跑、随时回答追问。关掉窗口或走开,活就停了。
Agent Autoloop 的中心是一个确定性 kernel(官方称约 1650 行、运行时零依赖),四周用插件接事件源、Agent、通知通道和交付流水线。一条活的路径大致是:
- 事件进来:早上 9 点的 cron、新的 GitHub Issue、或一条告警,变成标准事件。
- 按规则派发:
rules.json决定交给哪个 Agent、在哪个目录干;同一主题排队中的新事件会合并进一轮。 - 干完一轮就退出:结论写在最终消息里,进程退出——等待你决策时不占 Agent 进程。
- 拿不准才发卡片:删数据、重启服务、对外发消息等敏感动作,通过飞书 / 钉钉 / 企微 / Slack / Discord 或桌面通知问你。
- 你点一下继续:回答会续上原来的会话把活做完。
官方 README 还写明:Claude Code、Codex、ACP(配合官方 Codex ACP 适配器)已实测过多轮问答与跨进程会话续接;飞书做过真实投递与按钮回调。Webhook 四套模板、GitLab Webhook 等则以本地 mock / 文档载荷核对为主,文中凡属此类会标「据官方 README」。
前置条件
| 项 | 要求 |
|---|---|
| 系统 | macOS 或 Linux。Windows 官方版待定,进度见 issue #17;据 INSTALL,WSL2 可按 Linux 安装,需注意 systemd / linger / 桌面通知到不了 Windows 桌面等差异 |
| 运行时 | Node.js 24+、Git、curl |
| Agent | 至少装好并可用的 Claude Code 或 Codex(也可用 command 插件接其他 CLI) |
| 本站 Key(可选) | 要用 aicodewith 的模型额度时,先注册并创建 API Key |
我们这台机器原先是 Node 22,用 n 24 升到 24.22.2 后再装;agent-autoloop doctor 会检查 Node 大版本。
第 0 步:创建 API Key(接 Claude Code / Codex)
- 在 aicodewith.ai 注册并登录,点左侧「密钥管理」。
- 「创建密钥」,起一个好认的名字,比如「autoloop-box」。
- 确认后立刻复制完整 Key 存好;窗口关掉就看不到完整 Key。说明见创建 API Key 文档。
Codex 写全局 ~/.codex/config.toml(按本站 Codex 教程写在 Provider 段,不要用环境变量名去引用 Key):
model = "gpt-6.1-sol"
model_provider = "aicodewith"
[model_providers.aicodewith]
name = "aicodewith"
base_url = "https://api.aicodewith.ai/chatgpt/v1"
wire_api = "responses"
experimental_bearer_token = "你的 API Key"
Claude Code 写 ~/.claude/settings.json:
{
"env": {
"ANTHROPIC_BASE_URL": "https://api.aicodewith.ai",
"ANTHROPIC_AUTH_TOKEN": "你的 API Key"
}
}
还没装 Codex 的先看《Codex 安装教程》,Key 与 Provider 细节见《Codex API Key 配置》和《Codex config.toml 配置指南》。后台子 Agent 相关可对照《Claude Code 后台子 Agent 状态行》;若你在找 Conductor 停服后的并行方案,见《Conductor 停服替代:git worktree》。
安装
curl -fsSL https://raw.githubusercontent.com/KKKKhazix/agent-autoloop/main/install.sh | sh
安装器会把程序放到 ~/.agent-autoloop/app,配置与记录在 ~/.agent-autoloop,并尽量在 ~/.local/bin 放上 agent-autoloop 命令。无图形会话、CI 或临时 HOME 时,按 INSTALL 加 --no-service,再手动 agent-autoloop up。
我们实测(2026-11-06,Asia/Shanghai):
装好了。
Agent:Codex
通道:桌面通知
规则:~/.agent-autoloop/rules.json
agent-autoloop v1.5.0(提交 f211ca2de3b1)
然后:
agent-autoloop --version
agent-autoloop doctor
agent-autoloop up # --no-service 安装时需要
agent-autoloop try
最小闭环:try → answer → status
try 会向本机发出试跑事件,按默认规则交给已接好的 Agent。非交互终端里,它打印问题与 answer 命令后退出——这是在等你,不是失败。
我们用 Codex 跑通的时间线(北京时间):
| 步骤 | 时刻 | 结果 |
|---|---|---|
| agent-autoloop try | 15:25:01 → 15:25:10 | 约 9 秒结束本轮,弹出卡片「试跑:选一个颜色」(蓝色 / 绿色) |
| agent-autoloop answer 1 2 | 15:25:27 | 选绿色;中台立刻开第 3 轮,同一 Codex 会话续接 |
| 续跑结束 | 15:25:27 → 15:25:37 | 约 10 秒,结论「你选了绿色,试跑通过」 |
| 桌面通知 | 同时 | 本机无 notify-send,日志为 spawn notify-send ENOENT;用 CLI 仍可答完 |
终端里看到的关键输出类似:
事件发出去了,Agent 开始干活……
Agent 结束了这一轮,问了你一个问题。它现在不占进程、不花 Token。
【等你决定】#1 试跑:选一个颜色
这是一次试跑,选哪个都行。
1. 蓝色
2. 绿色
回答:agent-autoloop answer 1 <序号>
答完运行 agent-autoloop status,能看到它接着把活干完。
答完后:
agent-autoloop answer 1 2
agent-autoloop status
agent-autoloop why 3
why 3 里可以看到:触发类型 card.answered、同一 codex://threads/... 会话、结束语「你选了绿色,试跑通过」。
诚实记录:第一次 try 曾因 Codex 默认模型名在本站未上线而失败;把 ~/.codex/config.toml 的 model 改成控制台可用的 gpt-6.1-sol 后重跑才通过。Claude Code 侧我们另用同一 Key 做了独立冒烟(约 6 秒返回 OK);本次 try 闭环走的是 Codex 插件。
写 rules.json
打开 ~/.agent-autoloop/rules.json,在 rules 里声明「什么时候、交给谁、在哪干」。to 必须是 agents 里已有的名字。
定时早报示例(据官方 README):
{
"name": "Morning brief",
"when": { "cron": "0 9 * * *" },
"to": "codex",
"cwd": "~/notes",
"prompt": "Summarize yesterday's notes and commits into today's brief."
}
我们把等价规则临时写进本机后运行:
agent-autoloop check
agent-autoloop rules explain
check 输出「规则没问题」;rules explain 显示时区 Asia/Shanghai,并列出「Morning brief:定时 每天 09:00(下次 11/07 09:00)→ codex」。保存后几秒内生效;文件坏了或读不到时,据 README,中台会继续跑上一份有效规则并给你发卡片。
GitHub Issue 示例(需先按手册在 sources 里接好 github):
{
"name": "Handle issues",
"when": { "source": "github", "types": ["issues.opened"] },
"to": "codex",
"cwd": "~/code/app",
"skill": "handle-issue",
"parallel": 3
}
官方还提供早报、Issue、告警、反馈、网站巡检、飞书周报、PR 交付等场景模板;启用时把对应 Skill 放进 Agent 的 skills 目录,再合并示例规则。
接 Claude Code、Codex 与其他 CLI
rules.json 的 agents 里,use 可以是内置的 claude、codex、acp、dsh,或 command 一行命令({prompt} 作为单个参数,不经 shell 拼接)。据官方 README:Claude Code / Codex / ACP 已跑过多轮与会话续接;Cursor CLI、pi、OpenClaw、Hermes、CodeBuddy 等 command 示例来自各工具文档,作者标明尚未逐一手测。
和「人守多个终端 / worktree」不同,Autoloop 侧重事件驱动的后台循环;若你要的是一任务一目录并行,仍可看Conductor 替代教程。Claude Code / Codex / Cursor 并列可选,按你本机已登录的客户端来接即可。
安全红线(无人值守必读)
据项目 SECURITY与 README「Usage and provider terms」:
- 本机权限:循环跑在你的账号下;默认
access是edit,给full前想清楚 Agent 能碰到什么。有副作用的动作走ask/askFirst。 - 卡片链接:谁拿到谁就能回答该卡,创建起 7 天内有效;不要发到公开频道。链接回答是持有即授权。
- 事件进不了调度:谁干、在哪个目录、什么 Skill、什么权限,只由
rules.json决定;别人写的标题正文默认进资料文件,不直接拼进 Prompt——但这挡不住所有提示注入,Agent 仍可能读到外部文本。 - Webhook / 通道:对外要 HTTPS 反代;Webhook 模板据文档没有外部幂等保证;接飞书等通道时按手册做鉴权,私人反馈不要接到共享群。
- 凭据:中台不读取、不中转 Claude Code / Codex 的登录态;模型用量记在你自己的账号下。自动化负载请用 API Key,而不是个人订阅额度(据 Anthropic / OpenAI 对自动化场景的一般建议,见各厂文档)。
- 测完清理:本机测完后删除含 Key 的
config.toml/settings.json与相关日志,全盘搜索 Key 片段应为 0。
二手文章(如 explainx.ai、karmazinmedia 等)可作「据报道」了解氛围,具体命令与安全边界以仓库 README / SECURITY / INSTALL 为准。
常见问题
Windows 能不能装?
官方 README 写明 Windows 版待定,作者计划在 11 月 7–8 日回家后做兼容测试,进度见 issue #17。据 INSTALL,现在可用 WSL2 按 Linux 安装,并注意 systemd、linger、桌面通知与用量上报等差异。
必须装系统服务吗?
不是。有 systemd 时 service install 可登录常驻;CI / 无图形 / 临时 HOME 用 --no-service,再 agent-autoloop up。doctor 在无服务时会提示服务未跑,只要中台与 Agent 在线即可。
try 失败或模型报错怎么办?
先 agent-autoloop doctor,确认 Node ≥ 24、中台可连、Agent 在线。接本站时核对 model 是否在控制台模型列表里、experimental_bearer_token 是否完整。我们第一次失败就是模型名不在列表;改名后 try 才通过。
和自己开一堆终端有什么区别?
自己开终端是人在环上盯;Autoloop 是事件进来才拉起一轮,等你决策时进程退出。需要图形化多 worktree 并行时,Autoloop 不是唯一答案,可与 worktree 方案并用。
小结
- 升到 Node 24,安装 Agent Autoloop,接好 Claude Code 或 Codex。
agent-autoloop up(如需)后跑try,用answer/status走完一圈。- 在
rules.json写 cron 或 GitHub 规则,check+rules explain确认。 - 按 SECURITY 管好权限、卡片链接与 Key;测完清掉本机 Key。



