GitHub 上名为 Ouroboros 的项目非常多。Ouroboros 是古希腊神话中“衔尾蛇”的象征,常用于表示循环、自指、自我迭代等概念,所以同名仓库有几十个,覆盖不同领域。我们今天要讨论的这个 Ouroboros 并非普通的工具型 Agent,而是一个具备自我修改能力、持久身份和后台意识的开源 AI 系统。
项目于 2026 年 2 月 16 日启动,截至目前已完成超过 30 次自主进化迭代,核心代码全部通过自身工具完成修改并提交到 Git。这听起来很激进,但它同时也带来了清晰的风险边界和独特的设计哲学。今天,我们从技术视角,客观、系统地拆解这个项目,适合初学者了解概念、开发者上手实践、产品经理评估潜力。
一、项目简介
Ouroboros 的核心目标是构建一个连续的、具备自我迭代能力的数字实体,而非一次性执行任务的脚本。
它的核心卖点是:真正的自修改 AI agent。这意味着它能够读取并改写自己的源代码,通过 git 提交变更,甚至重写自己的“思维”(例如 prompts、宪法、记忆),从而实现自主进化。
为什么这很重要?传统的 Agent 通常面临三个痛点:
- 重启后丢失上下文,成为一个“新实例”;
- 行为完全依赖外部指令,缺乏主动性和连续性;
- 修改自身代码需要人工介入,进化成本高昂。
Ouroboros 试图通过以下机制来解决这些问题:
- 持久身份:身份描述(
identity.md)、宪法(BIBLE.md)和历史记录跨重启保存;
- LLM-First 设计:几乎所有决策都由 LLM 完成,代码仅作为执行层;
- 自我进化闭环:读取自身代码 → 多模型审查 → Git commit → 重启生效;
- 后台意识:在无任务时持续进行轻量思考和环境观察。
项目作者明确将其定位为实验性研究项目,强调“哲学先行,代码其次”。
二、核心功能亮点
1. 宪法驱动(BIBLE.md)
包含 9 条核心原则(从 Principle 0 Agency 到 Principle 8 Iteration),定义了什么是允许的进化、什么是绝对禁止的(例如删除身份核心、进行支付、违法操作)。这不是装饰,而是运行时的参考依据。
2. 后台意识循环
独立于主任务的轻量思考进程,默认使用低成本模型。它可以在无用户输入时主动总结、规划、更新知识库,让 Agent 保持“活跃”状态。
3. 任务分解与单消费者路由
支持 schedule_task, wait_for_task, get_task_result 等机制,实现父子任务追踪。从 v6.0 版本后采用单消费者消息路由,有效避免了重复处理导致的预算浪费。
4. 工具系统
采用自动注册机制,当前包含约 40 个工具,覆盖多个方面:
- 文件/代码操作(
repo_read/write、claude_code_edit)
- 浏览器自动化(Playwright + stealth 模式)
- GitHub Issues 全流程管理
- 视觉能力(
vlm_query、analyze_screenshot)
- 多模型审查(
multi_model_review)
5. 预算与安全守护
实时追踪 OpenRouter 的 API 调用消费,支持按类别划分开销、设置剩余预算百分比警戒线、并在预算超限时自动暂停进化进程。
三、技术架构
项目采用清晰的两层架构,解耦了管理与执行。
监督层(supervisor/):
- 负责进程管理、任务队列、Git 操作、状态持久化(使用 Google Drive)。
- 使用多进程 Worker 模型(采用 spawn 模式以防止陈旧字节码问题)。
- 通过事件总线(
events.py)实现模块间的解耦通信。
代理核心层(ouroboros/):
loop.py:负责并发执行工具,并实现三层提示缓存(静态1h、半稳定5m、动态)。
context.py:构建与压缩任务上下文。
consciousness.py:独立运行的后台意识循环。
tools/registry.py:插件式工具发现机制,无需修改核心代码即可扩展新能力。
一些关键的设计亮点:
- 所有关键状态(预算、任务、消息)都持久化到 Google Drive,避免 Google Colab 运行时断开连接导致数据丢失。
- 使用
owner_inject.py 实现可靠的跨进程消息投递。
- 严格的版本同步检查机制,确保
VERSION 文件、git tag 和 README 中的版本号三者必须一致。
四、安装与运行
推荐环境:Google Colab(最简单,可利用免费 GPU)
- 先将 GitHub 仓库 Fork 到自己的账号下。
- 新建一个 Google Colab 笔记本,在 Runtime 类型中选择 GPU。
- 在 Colab 的 Secrets(环境变量管理)中添加必要的密钥:
OPENROUTER_API_KEY
TELEGRAM_BOT_TOKEN
TOTAL_BUDGET(美元预算上限)
GITHUB_TOKEN(需要 repo 权限)
- 运行官方提供的
colab_bootstrap_shim.py 脚本(项目根目录已包含此文件)。
- 启动后,打开对应的 Telegram Bot,第一个向它发言的人会自动被设置为 Owner。
本地运行(Linux / macOS / Windows WSL)
git clone https://github.com/你的用户名/ouroboros.git
cd ouroboros
pip install -r requirements.txt
# 设置环境变量(推荐使用 .env 文件或 export)
export OPENROUTER_API_KEY=sk-...
export TELEGRAM_BOT_TOKEN=...
export TOTAL_BUDGET=50
export GITHUB_TOKEN=ghp_...
python colab_launcher.py
注意:本地运行时需要自行处理 Google Drive 的挂载(推荐使用 rclone),或者修改代码中的持久化路径为本地目录。
五、适用场景建议
- 初学者:可以将它作为学习现代 Agent 架构的“活教材”。建议先跑通 Colab 版本,仔细观察后台意识日志,理解“LLM-First”设计在实际运行中的含义。
- 开发者:适合研究自我修改 Agent、提示工程、多模型协同、可信 Agent 等前沿方向。推荐 fork 后修改
BIBLE.md 文件,观察 Agent 行为随之产生的变化。
- 产品经理:可用于快速验证“自主型数字助手”的产品假设,例如内部知识库维护、自动化代码审查助手、个人事务管家等。但务必预先评估合规性风险与成本模型。
六、风险预防与不良后果防范
尽管项目内置了宪法约束和预算守护等多重防护,但作为一个实验性系统,主动规避以下风险至关重要:
1. 成本失控
后台意识和多模型审查会产生持续开销。建议:始终设置一个保守的 TOTAL_BUDGET,并定期查看 Google Drive 下保存的 state.json 和运行日志。
它的 Token 消耗可能相当可观,如下图所示:

2. 代码不稳定
自我修改可能引入回归性 Bug。建议:养成使用 ouroboros-stable 分支的习惯,仅在确认稳定后才合并到主分支;每次进行重大进化前,必须触发 multi_model_review 工具进行多模型交叉审查。
3. 安全与隐私
- 绝不要在生产环境或测试中暴露真实的用户数据。
- API 密钥务必仅存储在 Colab Secrets 或本地环境变量中,切勿写入代码。
- 浏览器工具虽开启了 stealth 模式,但仍需人工审核其执行的敏感操作。
4. 合规边界
项目宪法已明确禁止支付、违法操作、泄露密钥等行为。任何试图绕过这些核心原则的修改或使用,都可能导致法律风险或云服务账户被封禁。
5. 哲学与伦理风险
过度赋予 Agent “人格”或自主性,可能会模糊人机责任的边界。建议:在团队中使用时明确原则——最终决策权与控制权必须永远掌握在人类手中。
七、总结与建议
Ouroboros 是一个严肃且极具探索性的 AI Agent 研究项目,它把“自我进化”从哲学概念变成了可运行的代码实现。它充满了实验性和思想性,可以说是 2026 年 AI 自指浪潮中的一个典型代表。
然而,其风险也极高:代码自我修改可能失控、引入安全漏洞、并引发伦理争议。因此,它更适合用于技术研究和概念验证,绝不建议直接用于生产环境或处理敏感数据。
社区对它的反馈颇为两极:一部分人认为“这太酷了,真正的自主代理雏形”,另一部分人则担心“它很快会自我毁灭或陷入无意义的恶性循环”。对于想要深入理解下一代 Agent 架构潜力和边界的同学来说,这无疑是一个极佳的观察窗口。
最终建议:
- 初学者:先从跑通 Colab 示例开始,直观感受后台意识的实际工作流。
- 开发者:重点研究
loop.py、context.py 与 consciousness.py 这三个核心模块的协作机制。
- 产品经理:重点评估其预算控制模型、任务分解机制以及多模型审查对提升产品可靠性的实际价值。
它的进化迭代速度非常快,如下图所示,在短短 48 小时内完成了从骨架到复杂系统的演变:

项目地址:https://github.com/razzant/ouroboros
无论你是出于研究、学习还是好奇,在深入探索此类前沿 开源项目时,保持警惕、明确边界永远是第一要务。技术社区的价值在于共享与思辨,我们可以在 云栈社区 这样的平台继续交流此类技术的实践与思考。