hedda-telegram-bot

> 进化版 Claude Telegram Bot - 基于 Claude Agent SDK 的智能个人助手

将 Claude Code 的强大能力带到你的 Telegram，随时随地使用 AI 助手！

• ✅ 完整的 Claude Code 集成 - 所有工具和能力
• ✅ 多媒体支持 - 文本、语音、图片、PDF、文档
• ✅ 流式响应 - 实时查看 Claude 的思考和工具使用
• ✅ 会话管理 - 持久化对话，支持多 Topic
• ✅ 记忆系统 - 自动加载和管理记忆文件
• ✅ 273+ Skills - 预装所有 Claude Code skills

• 🔒 用户白名单 - 只有授权用户可使用
• 🔒 路径验证 - 防止访问敏感文件
• 🔒 命令安全检查 - 阻止危险命令
• 🔒 速率限制 - 防止滥用
• 📝 完整审计日志 - 所有操作可追溯

相比原版 claude-telegram-bot：

• ✅ 修复工具并发调用 - 解决 API Error 400
• ✅ 指数退避重启 - 更稳定的运行
• ✅ Topics 支持 - 每个话题独立会话
• ✅ 记忆系统集成 - 自动加载核心记忆
• ✅ 优化错误处理 - 更好的错误恢复
• ✅ 中断支持 - ! 前缀立即停止
• ✅ 流式状态 - 工具使用实时反馈

• macOS (专为 Mac 优化)
• Bun 1.0+ (JavaScript 运行时)
• Claude CLI (推荐) 或 Anthropic API Key
• macOS 权限 - 完整磁盘访问、开发者工具 (详细说明)

> ⭐ 重要：安装时会自动检测并引导你完成 macOS 权限设置 > > 💡 快速测试：运行 ./test-permissions.sh 验证权限配置

# 1. Clone 仓库
git clone https://github.com/YOUR_USERNAME/hedda-telegram-bot.git
cd hedda-telegram-bot

# 2. 运行互动式安装
bun run setup.ts

# 3. 启动 bot
./start.sh
# 或者直接用 bun
bun run src/index.ts

互动式安装会引导你完成：

1. ✅ 检查系统要求（Bun、Claude CLI）
2. 🔐 检查 macOS 权限（自动引导授权）
3. 🔑 配置 Telegram Bot Token
4. 👤 设置授权用户 ID
5. 🎙️ 配置 OpenAI API Key（可选，用于语音）
6. 📦 安装依赖
7. 🛠️ 配置 MCP 服务器
8. 🧠 设置记忆系统
9. 🚀 配置开机自启动（可选）

| 命令 | 功能 | |------|------| | /start | 开始对话，显示欢迎信息 | | /new | 开始新会话（清除历史）| | /stop | 停止当前正在运行的查询 | | /status | 查看 bot 状态 | | /resume | 恢复之前的会话 | | /stats | 查看 token 使用统计 | | /id | 获取你的 Telegram User ID |

在消息中包含关键词触发深度思考：

think: 为什么天空是蓝色的？
ultrathink: 解释量子力学的核心概念

在消息前加 ! 立即停止当前查询：

! 停止

直接发送语音消息，自动转文字后处理（需要 OpenAI API Key）

• 发送单张图片或相册
• 支持带标题的图片
• Claude 可以分析图片内容

支持的文件类型：

• PDF（自动提取文本）
• 文本文件（.md, .txt, .json, .yaml等）
• 压缩包（.zip, .tar, .tar.gz