Telegram AI 约会助手

附注：我们在这之后就分手了

一款基于 AI 的 Telegram 助手，可帮助你为对话撰写机智、吸引人的消息。它由 Claude Sonnet、Nia 语义搜索以及功能齐全的 Telegram MCP 集成打造而成。

功能简介

• 智能回复建议：根据对话上下文提供 AI 驱动的回复建议
• 500+ 搭讪金句：通过 Nia 索引的精选搭讪金句库进行语义搜索
• 约会指南：搜索与女性交谈技巧、开场白及调情小贴士等指南
• 消息优化：将平淡无奇的消息转化为机智有趣的表达
• 全面 Telegram 访问权限：通过自然语言即可阅读消息、发送回复、管理聊天

由 Nia 提供支持

本助手使用 Nia 作为知识检索引擎。Nia 索引并搜索以下内容：

• 500+ 条精选搭讪金句（幽默、老套、巧妙、浪漫）
• 对话技巧指南
• 如何让对话保持吸引力的小贴士

您也可以在 trynia.ai 上创建源，索引自己的内容。

架构图

┌──────────────────┐     ┌──────────────────┐     ┌──────────────────┐
│   CLI 助手      │────▶│  Telegram API    │────▶│    Telegram      │
│  (TypeScript)    │     │   桥接程序 (Py)  │     │    服务器       │
└──────────────────┘     └──────────────────┘     └──────────────────┘
         │
         ▼
┌──────────────────┐     ┌──────────────────┐
│  Claude Sonnet   │     │    Nia API       │
│   (AI 网关)      │     │ (trynia.ai)      │
└──────────────────┘     └──────────────────┘
                         - 500+ 搭讪金句
                         - 约会指南
                         - 对话技巧

快速入门

1. 获取 Telegram API 凭证

前往 my.telegram.org/apps 获取您的 API 凭证。

2. 安装与配置

# 克隆仓库
git clone https://github.com/arlanrakh/talk-to-girlfriend-ai.git
cd talk-to-girlfriend-ai

# 安装 Python 依赖
uv sync

# 生成 Telegram 会话字符串
uv run session_string_generator.py

# 配置环境变量
cp .env.example .env
# 编辑 .env 文件以填写您的凭证信息

3. 启动 Telegram API 桥接程序

python telegram_api.py

此命令将在端口 8765 上运行一个 FastAPI 服务器，用于连接 TypeScript 助手与 Telegram。

4. 运行 AI 助手

cd agent
bun install
bun run dev

使用示例

启动后，您可以通过自然语言与之交互：

# 阅读与发送
> 给我看看 @her_username 的消息
> 给 @her_username 发一条“嘿，我刚才还在想你呢”
> 用一句俏皮话回复她最后一条消息

# 反应
> 用 ❤️ 回复她最后一条消息
> 给第 123 条消息发一个 🔥 反应

# 搜索与历史
> 在我们的聊天中搜索“晚餐计划”
> 给我看看和她最近的 50 条消息
> 给我找一句关于披萨的搞笑搭讪金句

# AI 辅助
> 她发来关于咖啡的消息，我该怎么回复？
> 把这条消息变得更撩人一点：“明天一起出去玩吗？”
> 搜索如何让对话持续下去的技巧

# 用户信息
> 她现在在线吗？
> 查看她的状态

# 消息管理
> 修改我最后一条消息中的错别字
> 删除第 456 条消息
> 把那个表情包转发给 @friend

助手命令

• /help - 显示帮助信息
• /clear - 清除对话历史
• /status - 检查连接状态
• /quit - 退出

环境变量

在项目根目录下创建 .env 文件：

# Telegram API（必填）
TELEGRAM_API_ID=your_api_id
TELEGRAM_API_HASH=your_api_hash
TELEGRAM_SESSION_STRING=your_session_string

# AI 服务（助手所需）
AI_GATEWAY_API_KEY=your_vercel_ai_gateway_key
NIA_API_KEY=your_nia_api_key
NIA_CODEBASE_SOURCE=your_pickup_lines_source_uuid

替代方案：作为 MCP 服务器使用

您也可以将其用作独立的 MCP 服务器，配合 Claude Desktop 或 Cursor 使用，无需 AI 助手。

将以下内容添加到您的 MCP 配置文件（~/Library/Application Support/Claude/claude_desktop_config.json）：

{
  "mcpServers": {
    "telegram": {
      "command": "uv",
      "args": ["--directory", "/path/to/telegram-mcp", "run", "main.py"]
    }
  }
}

这将暴露 60 多种 Telegram 工具，包括消息发送、联系人管理、群组、频道、反应等。

可用工具

助手工具（20+）

核心消息功能

工具	描述
getChats	列出所有对话
getMessages	读取聊天中的消息
sendMessage	发送消息
getChat	获取聊天详情
searchContacts	搜索联系人

反应与回复

工具	描述
sendReaction	发送 ❤️、🔥、😂 等反应
replyToMessage	回复特定消息

编辑与删除

工具	描述
editMessage	发送后修改错别字
deleteMessage	删除消息

历史与搜索

工具	描述
getHistory	获取最多 500 条消息
searchMessages	根据文本搜索聊天记录

转发与置顶

工具	描述
forwardMessage	转发到其他聊天
pinMessage	置顶重要消息
markAsRead	将消息标记为已读

用户信息

工具	描述
getUserStatus	检查用户是否在线
getUserPhotos	获取个人资料照片

媒体

工具	描述
searchGifs	搜索 GIF 动图

Nia 搜索

工具	描述
searchPickupLines	搜索索引中的搭讪金句及约会建议
niaSearch	通用语义搜索
webSearch	实时网络搜索

AI 工具

工具	描述
aiifyMessage	将消息转化为机智的回复

MCP 服务器工具（60+）

全面的 Telegram API 访问权限，包括：

• 聊天与群组管理（创建、邀请、管理员权限、禁言）
• 消息功能（发送、回复、编辑、删除、转发、置顶、反应）
• 联系人管理（添加、搜索、屏蔽、导入导出）
• 媒体与贴纸
• 隐私设置
• 以及更多…

Docker

docker build -t telegram-mcp:latest .
docker compose up --build

故障排除

• 数据库锁定错误：请改用会话字符串认证，而非文件认证方式
• 认证错误：请使用 uv run session_string_generator.py 重新生成会话字符串
• 连接问题：请确认 telegram_api.py 是否正在端口 8765 上运行
• 错误日志：请查看 mcp_errors.log 以获取详细错误信息

安全提示

• 切勿提交您的 .env 文件或会话字符串
• 会话字符串相当于对 Telegram 账户的完全访问权限
• 所有处理均在本地进行，数据仅传输至 Telegram API

鸣谢

• 基于 @chigwell 的 telegram-mcp 构建
• 知识检索由 Nia 提供支持
• 使用了 Telethon、MCP 和 Vercel AI SDK

许可证

Apache 2.0

和女朋友聊天的AI

talk-to-girlfriend-ai 快速上手指南

本项目是一个基于 AI 的 Telegram 约会助手，能够根据聊天上下文提供机智的回复建议、检索撩人金句（Pickup Lines）以及提供约会沟通技巧。它结合了 Claude Sonnet 模型、Nia 语义搜索引擎以及完整的 Telegram MCP 集成。

环境准备

在开始之前，请确保您的开发环境满足以下要求：

• 操作系统：Linux, macOS 或 Windows (WSL2 推荐)
• Python 环境：需安装 uv (高性能 Python 包管理器)
• Node.js 环境：需安装 bun (用于运行 AI Agent)
• Telegram 账号：拥有一个正常的 Telegram 账号
• API 密钥：
  • Telegram API ID 和 Hash (从 my.telegram.org/apps 获取)
  • Vercel AI Gateway Key (用于调用 Claude)
  • Nia API Key (用于语义搜索，从 trynia.ai 获取)

安装步骤

1. 克隆项目并安装依赖

# 克隆仓库
git clone https://github.com/arlanrakh/talk-to-girlfriend-ai.git
cd talk-to-girlfriend-ai

# 使用 uv 同步 Python 依赖
uv sync

2. 配置 Telegram 会话

生成 Telegram 会话字符串（Session String），这是连接您账号的关键凭证。

uv run session_string_generator.py

运行后按提示输入手机号和验证码，复制生成的字符串备用。

3. 配置环境变量

复制示例配置文件并填入您的凭证。

cp .env.example .env

编辑 .env 文件，填入以下内容：

# Telegram API (必填)
TELEGRAM_API_ID=你的_api_id
TELEGRAM_API_HASH=你的_api_hash
TELEGRAM_SESSION_STRING=上一步生成的_session_string

# AI 服务 (必填)
AI_GATEWAY_API_KEY=你的_vercel_ai_gateway_key
NIA_API_KEY=你的_nia_api_key
NIA_CODEBASE_SOURCE=你的_pickup_lines_source_uuid

4. 启动服务

本项目分为两部分：Telegram API 桥接服务 (Python) 和 AI Agent (TypeScript/Bun)。需要分别启动。

终端 1：启动 Telegram API 桥接 此步骤会启动一个运行在 8765 端口的 FastAPI 服务。

python telegram_api.py

终端 2：启动 AI Agent 进入 agent 目录并运行开发服务器。

cd agent
bun install
bun run dev

基本使用

服务启动后，您可以通过自然语言与 Agent 交互。Agent 将自动调用工具读取消息、搜索金句或发送回复。

核心功能示例

1. 获取回复建议 让 AI 根据对方的最后一条消息生成机智的回复：

> Reply to her last message with something witty

或者针对特定话题寻求建议：

> What should I reply to her message about coffee?

2. 搜索撩人金句与技巧 利用 Nia 引擎搜索特定的开场白或约会指南：

> Find me a funny pickup line about pizza
> Search for tips on how to keep a conversation going

3. 消息润色 将平淡的消息转换为更有趣的表达：

> Make this message more flirty: "want to hang out tomorrow?"

4. 基础聊天操作 直接通过指令读取或发送消息：

> Show me messages from @her_username
> Send "Hey, I was just thinking about you" to @her_username
> React to her last message with ❤️

内置控制命令

在对话中输入以下命令管理 Agent 状态：

• /help - 显示帮助信息
• /clear - 清除当前对话历史
• /status - 检查连接状态
• /quit - 退出 Agent

---

注意：请妥善保管 .env 文件和 Session String，它们拥有您 Telegram 账号的完全访问权限。切勿将其提交到公共代码库。