aurelia (Lordymine)

Aurelia操作系统

Go中的自主代理操作系统。

Telegram原生。克劳德代码供电。为保持轻盈而建造。

一个持久守护进程，许多项目，许多代理。

     

为什么选择Aurelia OS

Aurelia是一个可通过Telegram访问的自主代理操作系统。自然地说话——Aurelia决定是直接响应、委托给专业代理还是安排自动执行。

它围绕一个实用的执行模型构建：

• Go守护进程（24/7，轻量级，跨平台）
• TypeScript桥封装了Claude代理SDK
• Claude Code CLI作为大脑（工具、MCP、技能、子代理）
• 具有令牌跟踪和自动重置功能的会话管理
• 具有自动提取功能的持久性三层存储系统
• markdown中带有cron调度的可配置代理
• 多供应商：Anthropic、Kimi、OpenRouter（实时模型目录）、Z.ai、阿里巴巴
• 桥恢复，崩溃时自动重试

我们的目标不是重新实现Claude Code已经做的事情。 目标是编排它——在上面添加持久性、内存、调度、多项目支持和自然的Telegram界面。

核心能力

• 自然对话 通过Telegram发送文本、照片、语音和文档
• 自主编码 --读取、写入、编辑文件、运行命令、搜索代码
• 多项目 --在孤立的环境中同时处理不同的项目
• 持久内存 --跨会话生存的3层内存系统（全局、项目专用、项目团队）
• 学习助推 --会话重置时从对话中自动提取内存
• 梦想巩固 --组织和消除重复记忆的定期背景审查
• 多供应商 --Anthropic、Kimi、OpenRouter（带实时模型目录）、Z.ai、阿里巴巴
• 会话连续性 --会话上下文通过会话恢复在消息中持续存在，并在令牌阈值上自动重置
• 智能路由 --基于LLM的分类将消息路由到正确的代理
• 持续调度 --通过自然对话创建cron作业，结果发送到Telegram
• 桥梁恢复 --当网桥进程崩溃时，自动重试并恢复会话
• 工具进度 --查看Claude Code实时执行的操作（读取文件、运行命令……）
• 答覆 --响应引用原始消息以提高异步对话的清晰度
• 照片分析 --下载图像并将其传递给Claude Code进行可视化分析
• 语音转录 --Groq STT将语音信息转换为文本
• 继承您的设置 --从您的Claude Code帐户中获取MCP、技能、插件和挂钩

运行时模型

Aurelia分为三个范围：

1. 仓库 --产品源代码
2. 本地实例 --用户运行时状态(~/.aurelia/)
3. 目标项目 --代理所处理的外部代码库

高水位流量：

flowchart LR
    U[User] --> T[Telegram]
    T --> P[Pipeline]
    P --> R[Agent Router]
    R --> B[Bridge TS]
    B --> SDK[Claude Code SDK]
    SDK --> TOOLS[Tools + MCPs + Skills]
    P --> SESS[Session Manager]
    P --> CRON[Cron Scheduler]
    B --> RES[Response]
    RES --> T

消息流

1. Message arrives on Telegram
2. Pipeline extracts text/photo/voice/document
3. Agent router classifies → specialist agent or general
4. System prompt assembled: persona + agent + cron instructions
5. Request sent to Bridge (long-lived TypeScript process)
6. Bridge calls Claude Code SDK → Claude Code CLI executes
7. Events streamed back: tool_use → progress, assistant → text, result → response
8. Response delivered to Telegram (reply-to original message)
9. Session token usage tracked, auto-reset if threshold exceeded

Cron流

1. Scheduler polls every 15 seconds
2. Due job found → load agent config + persona
3. Execute via Bridge (Telegram plugin blocked to prevent wrong bot)
4. Result delivered to Telegram via TelegramDelivery

建筑

cmd/aurelia/              CLI entry point, onboarding, cron CLI, telegram CLI
internal/bridge/          Go <> Bridge client (long-lived, multiplexed, bundle embedded via go:embed)
internal/telegram/        Telegram I/O, async pipeline, progress, reactions, commands
internal/session/         Session store, token tracking, nudge buffer
internal/agents/          Agent registry (markdown definitions, LLM classification)
internal/persona/         Persona loader (IDENTITY / SOUL / USER)
internal/dream/           Memory consolidation (dream) and extraction (nudge)
internal/cron/            Persistent cron scheduler with Telegram delivery
internal/config/          App configuration (providers, Telegram, sessions)
internal/runtime/         Path resolver + instance bootstrap + project memory dirs
internal/orchestrator/    Git operations, worktree management, PR creation
pkg/stt/                  Speech-to-text (Groq Whisper)
bridge/                   TypeScript Bridge source (compiled to bundle.js via esbuild, embedded in binary)

桥接协议

这座桥是 长寿的 封装的TypeScript进程 @anthropic-ai/claude-agent-sdk.通信是通过stdin/stdout NDJSON进行的，具有请求多路复用功能：

Go → 桥（标准输入）：

{"command":"query","request_id":"req-1","prompt":"...","options":{"model":"k2.5","system_prompt":"...","cwd":"/path","permission_mode":"bypassPermissions"}}

桥→ Go（stdout）：

{"event":"system","request_id":"req-1","session_id":"abc-123","tools":["Read","Write"]}
{"event":"tool_use","request_id":"req-1","name":"Read","input":{"file_path":"src/main.go"}}
{"event":"assistant","request_id":"req-1","text":"The project has..."}
{"event":"result","request_id":"req-1","content":"...","cost_usd":0.12,"session_id":"abc-123"}

多个请求同时运行，每个请求都有自己的请求 request_id.

代理

markdown中定义的可配置专家(~/.aurelia/agents/):

---
name: prospector
description: Busca leads e entra em contato
model: kimi-k2-thinking
schedule: "0 9 * * 1"
cwd: D:\projetos\crm
mcp_servers:
  google-places: { command: "npx google-places-mcp" }
allowed_tools: ["WebSearch", "WebFetch", "Bash"]
---

Voce eh um agente de prospeccao comercial.
Busque empresas no Google Places na regiao configurada.

领域： name, description, model, schedule, cwd, mcp_servers, allowed_tools.

代理商与 schedule 在cron调度程序中自动注册。

角色

中有三个markdown文件 ~/.aurelia/memory/personas/:

• IDENTITY.md --姓名、角色、规则、性格
• SOUL.md --语气、风格、行为
• USER.md --用户信息、偏好

通过自动创建 /start 在Telegram上（选择“编码器”或“助理”预设）。

记忆系统

Aurelia有一个3层持久内存，可以在会话中生存：

内存会自动填充：

• 助推 --会话重置时从对话中提取事实(/new 或自动重置）
• 梦 --定期的后台整合，用于组织、消除重复和修剪内存文件

该模型在其系统提示中看到所有内存层，并可以在对话期间读取/写入它们。

电报命令

命令行界面

# Run the bot
go run ./cmd/aurelia/

# Interactive onboarding
go run ./cmd/aurelia/ onboard

# Cron management
aurelia cron add "30 8 * * *" "pesquise noticias de tech" --chat-id 123456
aurelia cron once "2026-03-22T09:00:00Z" "gere relatorio" --chat-id 123456
aurelia cron list
aurelia cron del 

# Telegram interaction (used by the agent via Bash)
aurelia telegram react   
aurelia telegram send  
aurelia telegram reply   

设置

要求：

• 去 1.25+
• Node.js 18+
• Telegram机器人令牌
• 一位法学硕士提供者：

- Anthropic → 安thropic（音译）或 人类中心（意译） -API密钥或Max订阅（通过 claude login) - 基米 -API密钥（人类相容性终点） - 开放路由 -API密钥（多模型代理） - Z.ai -API密钥（GLM编码计划） - 阿里巴巴 -API密钥（Qwen编码计划）

• 用于语音转录的Groq API密钥（可选）

快速开始

1. 运行入职培训：

   go run ./cmd/aurelia/ onboard

1. 开始：

   go run ./cmd/aurelia/

1. 发送 /start 在Telegram上发送给你的机器人。

热重载（开发）

go install github.com/air-verse/air@latest
air

配置

主配置位于 ~/.aurelia/config/app.json:

{
  "default_provider": "anthropic",
  "default_model": "claude-sonnet-4-6",
  "providers": {
    "anthropic": { "auth_mode": "subscription" },
    "kimi": { "api_key": "sk-kimi-..." }
  },
  "telegram_bot_token": "your-token",
  "telegram_allowed_user_ids": [123456789],
  "stt_provider": "groq",
  "max_iterations": 500,
  "max_session_tokens": 100000
}

提供程序基本URL是自动配置的。对于Anthropic订阅模式，运行 claude login 第一。

发行的组建

go build -trimpath -ldflags "-s -w" -o ./build/aurelia.exe ./cmd/aurelia

文档

发展

go build ./...        # Build
go test ./... -short  # Test
go vet ./...          # Lint
air                   # Hot reload

修改后重建Bridge捆绑包 bridge/index.ts:

cd bridge && npx esbuild index.ts --bundle --platform=node --target=node18 --outfile=bundle.js --format=esm
cp bundle.js ../internal/bridge/bundle.js

当前状态

• v0.4.0 --看 更改日志.md
• Go测试套件为绿色
• TypeScript桥编译干净
• 跨平台：Windows和Linux
• 积极发展 main 分支