Daimon

一个面向 Telegram 的多 Provider Agent 框架，支持 Codex、Claude、Lite(OpenAI-compatible) 三种后端，提供消息收发、定时任务、Webhook、记忆检索、TTS 与音频转写等能力。

这个目录是从私有运行仓库中提炼出的开源版：仅保留核心代码、测试、部署脚本与公共文档，不包含本地配置、运行历史、私有提示词或用户画像。

特性

• Telegram Bot 双向通信
• 多 Provider 统一调度：codex / claude / lite
• 定时任务与 Webhook 触发
• SQLite 会话存储与可选记忆检索
• TTS 发送与音频转写
• 本地运行脚本、systemd 部署脚本、测试集

快速开始

1. 安装依赖

推荐使用 uv：

uv sync

也可以使用标准虚拟环境：

python3 -m venv .venv
. .venv/bin/activate
pip install -U pip
pip install -e .

2. 准备配置

cp config.sample.yaml config.yaml
cp .env.example .env

至少需要补齐：

• telegram.token 或 TELEGRAM_TOKEN
• agent.provider
• agent.workspace_dir 或 AGENT_WORKSPACE_DIR

建议把敏感信息放进 .env，把通用结构性配置留在 config.yaml。

3. 启动

python -m daimon --config config.yaml

或使用本地运行脚本：

./scripts/run.sh start
./scripts/run.sh status
./scripts/run.sh stop

常见目录

• daimon/：主代码
• tests/：测试
• scripts/：运行、部署、发送与调试辅助脚本
• docs/：部署与 Lite 配置说明

可选能力

• 你可以在工作目录放置 AGENTS.md，作为运行时附加指令。
• 你可以放置 MEMORY.md，作为长期记忆文件入口。
• 若启用 Lite / 音频转写，需要配置相应 API Key。

Task Intervention

Daimon 支持实时任务干预，允许你：

• 取消任务（优雅停止）：/cancel
• 强制终止任务：/kill、强制停止
• 转向任务（执行中改变方向）：发送任何消息

详见 Intervention Guide。

文档

• 部署：docs/deploy.md
• Lite 配置：docs/LITE_AGENT_CONFIG.md
• Lite 使用指南：docs/LITE_AGENT_GUIDE.md

测试

pytest

或先运行轻量自检：

./scripts/smoke_test.sh