Iva 个人助理
在 Telegram 中整理消息、长期记忆并执行个人与办公任务。
- Star 数
- ★ 285
- 最近更新
- 3 天前
- License
- MIT
- 主语言
- TypeScript
- FA 评分
- 85/100 · 表现良好
30 秒速览
- 运行形态
- 可在哪里用
- 通用 · 跨平台ChatGPT · Codex
- 费用
- 软件免费，模型调用费用自付
- 上手难度
- 中 · 需要几步配置
- 开始前需要
- 典型场景
- 需要维护客户关系的经营者，把会谈结论和联系人偏好保存为卡片，数月后询问某位客户的约定和跟进方式。
- 不适合
- 不愿维护 Linux 服务器、systemd 服务与升级的个人用户
- 想用个人账号自动化又怕封号的人：userbot 违反 Telegram 条款，可能被限制或封禁
- 源码审查
- 85/100 · 表现良好
这个 Agent 能做什么，适合哪些场景？
Iva 是一个自托管的 Telegram 助理，通过长轮询接收文字、语音、照片、转发内容和决定，无需公网 HTTPS、域名或 webhook。它把对话逐字写入兼容 Obsidian 的 Markdown 仓库，并通过每日、每周、每月和每年摘要以及 CORE.md 和类型化卡片形成分层记忆。系统由两个 systemd 用户服务、两个 watchdog 定时器和五个 eve 内部计划任务运行，搜索索引使用 Node.js 24 内置的 SQLite。它能够调用网页搜索、Google Workspace、提醒、文件和自定义技能，也能连接 MCP 服务器。数据与密钥保存在用户自己的服务器上，但模型推理和语音转写仍依赖用户选择的云服务。适合希望以 Telegram 为入口、接受自行运维，并重视可检查 Markdown 记忆的个人或小型团队。
Telegram bridge 通过长轮询接收消息，将每天的用户内容和 Iva 回复逐字追加到 daily/YYYY-MM-DD.md。语音、音频和视频留言可由 Deepgram nova-3 转写，照片交给所选模型提供商的视觉模型描述；转发文本、网页、搜索结果、语音转写、图片说明等部分输入会经过提示注入检查。每天 04:00 的 nightly rollup 把日记逐层提炼为 daily、weekly、monthly 和 yearly 摘要，并更新 contacts、projects、decisions、ideas、notes 等卡片；不超过 1,200 字符的 CORE.md 会进入每次提示。检索默认结合 BM25 和链接图重排，也可用一个密钥启用向量模式。助理可以创建和管理一次性或重复提醒，通过 gws CLI 操作 Gmail、Calendar、Drive、Sheets、Docs 和 Tasks，并使用 Tavily、Exa、Parallel 或 Brave 搜索网页。它还支持以技能文件扩展流程、连接 MCP 服务，以及通过测试版 userbot 读取、搜索或代表个人 Telegram 账户发送内容；所有 Outbox 输出都经过秘密信息脱敏。
- 需要维护客户关系的经营者，把会谈结论和联系人偏好保存为卡片，数月后询问某位客户的约定和跟进方式。
- 经常在路上的管理者，将五分钟语音留言交给 Iva 转写，并整理为任务清单、邮件草稿和会议卡片。
- 使用 Google Workspace 的小团队，在 Telegram 中根据价格表制作报价、调整折扣并生成可分享的 Google Doc。
- 知识工作者把照片、长篇转发和日常想法归档到兼容 Obsidian 的 Markdown 仓库，再按含义检索。
- 消息繁多的 Telegram 用户选择启用测试版 userbot，汇总群聊、查找未读信息，并在理解封号风险后受控地代发回复。
如何安装或部署这个 Agent？
准备一台 Ubuntu 或 Debian 服务器，并以普通用户而非 root 安装。先从 @BotFather 获取 Telegram bot token，然后运行：
curl -fsSL https://raw.githubusercontent.com/smixs/iva-agent/main/install.sh | bash按照向导填写 bot token，并选择 OpenCode Go、Ollama Cloud、OpenRouter 或 OpenAI（ChatGPT 订阅）作为模型提供商；如需语音转写，再提供 Deepgram 密钥。向机器人发送一条消息，向导会从该消息识别 Telegram ID、完成配置并在聊天中确认启动。全新 VPS 若仍以 root 登录，可先运行：
bash <(curl -fsSL https://raw.githubusercontent.com/smixs/iva-agent/main/bootstrap.sh)该脚本创建启用 lingering 的 sudo 用户、更新系统并配置防火墙、fail2ban 和 SSH 加固；随后用新用户登录并运行正式安装命令。源码安装可执行：
git clone https://github.com/smixs/iva-agent.git ~/iva
cd ~/iva && bash install.sh如何使用这个 Agent？
安装完成后，先给机器人发送一条文字或语音消息；当天的逐字记录会出现在仓库的 daily/ 目录。随后发送一条值得长期记忆的信息，例如“Marina at Acme wants the revised quote by Friday — she never picks up the phone.”，再询问“how should I follow up with Marina?”以验证卡片记忆和检索。发送照片或转发长文可请求说明或摘要；使用 /menu 配置模型、回复样式、语音和维护选项，使用 /usage 查看模型步骤的用量。Google Workspace 通过已安装的 gws CLI 和聊天内引导完成密钥配置。自定义流程可放入技能文件，MCP 服务的密钥保存在 .env；个人账户 userbot 必须显式启用，并可通过环境变量设置为只能读取。
这个 Agent 有哪些优点和局限？
- 记忆以用户拥有的普通 Markdown 文件保存，包含逐字日记、分层摘要、CORE.md 和类型化卡片，可直接用于 Obsidian并接受审查。
- 自托管且通过 Telegram 长轮询工作，不需要域名、公网 HTTPS 或 webhook；安装器提供一条命令的部署路径。
- 明确支持四种模型提供商，并可插接四种网页搜索服务、Google Workspace、技能和 MCP，降低单一模型提供商锁定。
- 提醒采用原子状态迁移和独立投递检查，计划任务会留下诊断事实，升级采用构建、探测、切换和回滚流程。
- 对多类外部输入提供提示注入检查，Outbox 提供秘密信息脱敏，用户白名单为空时默认不回复任何人。
- 需要自行维护 Ubuntu/Debian 主机、Node.js 24、systemd 服务、环境变量、模型凭据和更新流程，不是免运维的托管产品。
- 隐私边界并非完全本地：模型推理和 Deepgram 转写是用户选择并付费的云 API；Deepgram 缺失时不能转写语音。
- 安全过滤并不覆盖所有输入：文档正文、userbot 读取的聊天和 agent-browser 输出未筛查，媒体标题的风险标签也尚未传递给模型。
- 个人 Telegram userbot 仍是粗糙的测试版，自动化个人账户违反 Telegram 服务条款，发送操作可能导致限流或封号。
- 默认运行费用约为每月 14–15 美元的表述只对应特定 Go 模型和 VPS 组合；其他提供商、模型与搜索服务可能产生不同费用。
这个 Agent 与同类方案有什么区别？
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| Iva 个人助理 当前 | 85 · 表现良好 | 聊天机器人免费 + 模型费 | ★ 285 | 3 天前 | TypeScript | ChatGPT · Codex |
| Sapphire Blue AI | 53 · 缺口较多 | 网页应用免费 + 模型费 | ★ 328 | 1 天前 | Python | OpenAI API · Claude API |
| MIRA OS | 51 · 缺口较多 | 自托管服务免费版 + 付费版 | ★ 482 | 4 天前 | Python | Claude API |
| Octop 自托管 AI 助手 | 67 · 存在缺口 | 命令行工具免费 + 模型费 | ★ 12k | 1 天前 | Python | Codex · Claude Code · OpenAI API |
FollowAgents 如何评估这个 Agent？
查看各维度的扣分理由
证据清楚说明普通用户安装、默认拒绝的 Telegram 白名单、userbot 只读开关、插件仅限所有者从终端安装、入站注入筛查、出站密钥脱敏以及云端模型/转录、GitHub 镜像等数据流，因此数据流透明度可给满分。更新采用构建、探测、切换和回滚，破坏性 CRM 去重测试还验证先备份、故障恢复与防符号链接逃逸，回滚证据充分。扣分点是代理 shell 继承完整进程环境并以安装用户权限运行，文档正文、userbot 聊天和浏览器输出存在未筛查路径；部分 userbot 写操作只受提示词约束，外部发送也未显示统一的逐次确认机制。依赖有精确版本、审计修复声明和安全测试脚本，但所给材料没有锁文件、供应链校验或持续漏洞处置证据。来源归于 smixs，并说明项目沿革和私密漏洞渠道，但发布者身份仍未知。
README、SECURITY、package 元数据和测试材料对版本、运行环境、安全边界及恢复行为基本一致；固定随机种子、属性测试、故障注入和大量回归用例进一步支撑内部一致性。错误处理描述具体，包括工具模式降级、提醒失败回退、诊断包、明确配置错误和更新中断恢复，因此失败消息给满分。依赖可用性仅能由声明的 Node 24、eve、云服务及安装流程静态推断；对 Telegram、模型、Deepgram、搜索和 Google 服务的运行时不可用情形没有完整的统一降级证据，故扣分。
材料明确覆盖企业主、专业人士、管理者和日常生活，并列出语音、CRM、文档、提醒、搜索等具体场景；提供多模型、多搜索提供商、可选向量、技能、MCP、插件、读写模式及自定义规则，受众与环境适配较强。安全文档坦率划定筛查盲区、插件信任边界、云 API 边界和 userbot 风险，能力边界充分。扣分在于触发与确认主要依赖自然语言、技能提示和模式配置，且 joins、invites、联系人导入、reactions 等 userbot 操作未被服务器 guardrail 包裹；环境主要承诺 Ubuntu/Debian、systemd 和 Node 24，跨平台适配有限。
README 具有清晰导航、架构、功能、安装、成本、文档、版本历史和许可入口，并提供英文/俄文文档、首分钟示例、FAQ、故障排除和大量使用场景。包名、CLI、版本号及发布记录一致，MIT 正文完整；已知限制包括 userbot beta/封禁风险、筛查缺口、只支持最新版本和云端数据暴露，均明确披露，故大部分项目满分。维护责任仅给二分：提供漏洞邮箱、GitHub 私密报告、响应预期、issue/PR 路径和最新版本支持策略，但没有经验证的组织身份、多人维护结构或正式长期维护承诺。
输出面向 Telegram 原生富文本、清单、表格、文档链接、提醒和 Obsidian 兼容 Markdown，且记忆文件可直接查看和迁移，静态设计上的可用性强。相较普通聊天机器人，分层长期记忆、个人 CRM、可操作提醒、Google Workspace 和本地可控资料库构成明确增量价值。成本披露包含模型、VPS、语音及多提供商选择，但月费数字、实际节省和端到端效果仅为项目方声明，未有独立运行或比较数据，因此成本收益不满分。
主要主张能追溯到明确的文档章节、版本记录、包版本、安全政策及针对前置元数据、恢复和故障注入的测试代码；测试还使用固定 seed 并明确断言恢复性质，所以可追溯性充分。材料能区分事实边界、已知缺口、beta 风险和营销用例，没有把静态证据说成已执行结果，事实与推断分离较好。扣分在于交叉佐证主要来自同一仓库自身，且许多核心产品主张只由 README/变更记录描述，所给代码片段并未覆盖 Telegram 桥、脱敏器、安装器、更新器或完整端到端行为。
- 代理 shell 继承进程环境，遭注入的回合可能直接读取模型、Telegram、Google 等密钥；应使用独立低权限账户、最小化环境变量并限制主机文件权限。
- PDF/DOCX 正文、userbot 读取的聊天和 agent-browser 输出未经过统一注入筛查；不要把这些来源视为可信指令。
- 个人 Telegram userbot 违反 Telegram 服务条款并可能导致限流或封号；优先启用只读模式，且避免高价值主账号。
- 插件代码与插件中的 bash 可访问安装环境的全部密钥；只安装已审阅的插件，并把插件视为与主代理同等信任。
- 一键安装示例从 main 分支直接通过 curl 管道执行；部署前应下载审阅并固定到明确版本或提交。
- 本评估仅依据所给静态文件，未执行安装、测试、代理流程或依赖审计。
最近版本
来自该项目 GitHub Releases 的最新发布记录，说明为上游原文摘录，未经本站改写或测试。
-
发布说明摘录
- 🔧 Сводки и напоминания снова читают Telegram: плановый ход и сработавшее напоминание читают чаты через юзербот; отправку, ответ, пересылку, правку, удаление, реакции и отметку о прочтении Ива сама не делает, текст отправляет код. Scheduled turns and fired reminders may read Telegram through the userbot read tools; every Telegram write stays forbidden and the code delivers the final text. …在 GitHub 查看 ↗ -
v0.5.8 Iva 0.5.8
发布说明摘录
- 🔧 Model context window in Telegram: /new and status use the same context window as the runtime. Claude shows 1M when no override is configured, and model selection saves the selected Claude model's window. Helpers respect their own model's window. - 🔧 Окно модели в Telegram: /new и статус используют то же окно контекста, что и рантайм. Claude показывает 1M при отсутствии явной настройки; выбор модели сохраняет её окно. Помощники учитывают окно своей модели.在 GitHub 查看 ↗