telegram-search

一键导出Telegram聊天，用AI语义搜索找回任何记忆

telegram-search 是一个开源工具，用于导出 Telegram 聊天记录并进行模糊搜索。它解决的是 Telegram 内置搜索功能弱、无法跨聊天统一检索的问题。核心能力包括：将 Telegram 历史消息导出为本地文件，利用 embedding 技术将消息向量化，支持基于语义的模糊搜索，而不仅仅是关键词匹配。项目集成了 AI 智能体（ai-agent）和 MCP（模型上下文协议），可让 AI 助手直接访问和查询聊天记录，实现智能问答。技术栈基于 TypeScript，提供命令行工具和可能的 API 接口，方便用户自动化处理。该项目适合需要深度挖掘聊天数据、构建个人知识库或进行数据分析的用户。

开源 unknown 智能体

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 4107

维护状态较活跃

是否开源是

定价模式 unknown

项目数据

分类智能体

开发团队groupultra

所属国家

官网地址https://search.lingogram.app

GitHubhttps://github.com/groupultra/telegram-search

定价模式unknown

价格说明定价信息待确认

访问状态

是否开源是

开源协议AGPL-3.0

主要语言TypeScript

技术栈/模型ai,ai-agent,embedding,mcp,telegram,telegram-bot

GitHub 星标★ 4107

30天Star增速

HF 下载量

上线时间2025-02-08 00:00:00

最近更新2026-09-22 00:00:00

维护状态较活跃

中文支持

访问方式

移动端支持

综合评分

收录时间2026-08-09

浏览次数1

使用教程

难度：入门约 10 分钟部署方式：Docker 6 步

环境要求

已安装 Docker 与 Docker Compose
可访问外网下载镜像与配置文件
本机 3333 端口未被占用

安装与启动步骤

1创建项目目录

新建一个空目录，用来存放 Telegram Search 的配置和数据，然后进入该目录。
```
mkdir telegram-search
cd telegram-search
```

2下载配置文件

下载官方 Compose 文件、环境变量示例与初始化 SQL，并把示例保存为 .env。

curl -L https://raw.githubusercontent.com/groupultra/telegram-search/refs/heads/main/docker/docker-compose.yml -o docker-compose.yml
curl -L https://raw.githubusercontent.com/groupultra/telegram-search/refs/heads/main/docker/.env.example -o .env
curl -L https://raw.githubusercontent.com/groupultra/telegram-search/refs/heads/main/docker/init.sql -o init.sql

3按需改环境变量

打开 .env 根据自己的需要修改环境变量，不改则沿用默认配置即可。
4启动全部服务

用 Docker Compose 后台启动应用以及数据库、MinIO 等依赖服务。
```
docker compose -f docker-compose.yml up -d
```
5单镜像快速运行

不想用 Compose 时可直接运行官方镜像，未配置 MinIO 时媒体存到本地 data/media。
```
docker run -d --name telegram-search -p 3333:3333 ghcr.io/groupultra/telegram-search:latest
```
6打开页面使用

在浏览器访问本机 3333 端口，即可开始导出并检索 Telegram 聊天记录。

关键配置

配置项	必填	说明	示例
`DATABASE_TYPE`	否	指定使用的数据库类型，README 示例为 postgres。	`postgres`
`DATABASE_URL`	否	数据库连接地址，按示例格式填写账号密码与端口。	`postgresql://postgres:123456@localhost:5432/postgres`

如何确认成功

浏览器打开 http://localhost:3333 能正常显示页面，即表示服务已启动成功。

常见问题

Q：不想自己部署可以吗？

A：可以，官方提供在线体验版 https://search.lingogram.app，无需自行部署即可体验全部功能。

Q：媒体文件默认保存在哪里？

A：若未配置 MinIO 相关参数，媒体文件默认保存至本地的 data/media 目录。

Q：怎么换成自己的数据库？

A：启动时通过环境变量设置 DATABASE_TYPE 与 DATABASE_URL，例如改为 postgres 并填入自己的连接串。

注意事项

本软件仅供导出和检索个人聊天记录使用，切勿用于任何违法用途。
项目未发行任何虚拟货币，请警惕相关诈骗风险。
配置了 MinIO 时媒体会备份到对象存储，不配置则落到本地 data/media。

核心亮点

支持语义级模糊搜索，告别关键词死板匹配
集成AI智能体，可直接用自然语言查询聊天记录
基于TypeScript，代码结构清晰，易于二次开发

不足之处

需要用户自行配置Telegram API凭证，有一定门槛
文档/社区待观察

适用场景

个人知识管理：快速查找历史聊天中的关键信息
团队协作复盘：检索项目讨论记录，提取决策依据
数据备份与分析：导出聊天数据用于本地归档或统计

替代项目

telegrab、telegram-history-dump、Telethon

项目介绍

telegram-search 是搜索知识领域的开源项目，由 groupultra 开发，2025 年首次发布。

在全站 13,014 个收录项目中，它的 GitHub 星标数（4,107）位列前 30%，在搜索知识分类的 581 个项目里位列前 12%。

近 45 天，它的 GitHub 星标从 4,063 增加到 4,107，净增 44。

项目保持着较活跃的维护节奏，最近一次代码更新于 2026-09-22。从国内网络环境看，可直接访问。

它主要面向的使用场景是：个人知识管理：快速查找历史聊天中的关键信息。同类可对比的替代方案包括 telegrab、telegram-history-dump、Telethon。

上一篇：awesome-ai-tools

下一篇：wechat-download-api