📚 文档
每个功能，每个设置。
应用能做的一切、它拥有的每一个设置 —— 针对您正在运行的版本编写。从菜单栏到技能库，这是完整的使用手册。
快速上手
- 安装。下载 .dmg，把 Telebot AI 拖入「应用程序」。由于构建尚未公证，如果 macOS 弹出警告，请右键（Control-点击）应用并选择打开 —— 一次即可。
- 创建机器人。在 Telegram 上给 @BotFather 发消息，运行 /newbot，复制令牌。每个机器人一个令牌 —— 您可以运行多个。
- 添加令牌。从菜单栏打开 Telebot AI，打开设置，把令牌粘贴到机器人页面的令牌字段。输入即保存 —— 没有保存按钮。
- 连接大脑。在模型标签页设置服务器 URL（mlx-serve 用 http://localhost:11234，Ollama 用 http://localhost:11434）和模型名称，或使用任意 OpenAI 兼容云端 API。点击测试检查连接。
- 启动机器人。回到菜单栏，选择启动机器人。在 Telegram 上给您的机器人发消息 —— 从那一刻起它就会回答。
本地模型新手？ 阅读指南 — 它涵盖 mlx-serve、Ollama 和 LM Studio，以及每个模型需要多少内存。
菜单栏应用
Telebot AI 常驻您的菜单栏（⌘ 图标）。菜单提供：
- 启动 / 停止 / 重启 —— 可按单个机器人或全部操作。机器人以 LaunchAgent 方式运行：常驻后台，不打扰您。
- 打开设置 —— 设置窗口。
- 日志 —— 实时查看机器人日志，了解它在做什么或排查问题。
- 退出 —— 停止一切（并禁用 LaunchAgent，直到您再次启动）。
设置详解
设置窗口的侧边栏包含两类页面：
- 默认设置 —— 模型、Telegram、应用、技能与功能、技能库、关于、更新。所有机器人继承的值。
- 机器人 —— 每个机器人一个页面。每个字段都会显示该机器人实际使用的值：有值则覆盖默认值，留空则继承（每行下方的说明会注明）。这就是为什么没有「使用全局」复选框 —— 留空就是「使用全局」。
输入或切换时自动保存。设置存放在 ~/.mlx-serve/config.json。
默认设置 → 模型
| 设置 | 作用 |
|---|---|
| 服务器 URL | OpenAI 兼容端点。本地服务器无需密钥。 |
| API 密钥 | 本地服务器（mlx-serve、Ollama、LM Studio）留空即可。眼睛按钮可显示或隐藏。 |
| 模型名称 | 该服务器上的模型，例如 deepseek-v4-flash-free。 |
| 测试 | 用当前值检查连接 —— 保存前验证很有用。 |
| 备用模型 | 主模型失败或限流时按顺序尝试。每个都有独立的昵称、URL、密钥和模型，以及测试、排序和删除。最后一行填完才能添加。 |
默认设置 → Telegram
| 设置 | 作用 |
|---|---|
| 允许的聊天 ID | 允许与机器人对话的用户/群组 ID（逗号分隔）。留空 = 任何人。 |
| 每日简报时间 | 机器人发送每日简报的时间 —— 24 小时制小时/分钟下拉（例如 08:00）。 |
| 简报提示词 | 简报应涵盖的内容 —— 例如「天气、我今天的提醒，以及任何价格提醒」。 |
| 最大回复令牌数 | 回复的安全上限；超长回答会自动拆成多条消息。 |
| 每聊天下文 | 机器人每个聊天保留多少条最近消息作为上下文。 |
| 每用户记忆数 | 机器人每回答一条消息时为每个用户回忆的长期记忆条数。 |
| 记忆库大小（每用户） | 每个用户最多存储的记忆条数；超出时淘汰最旧的。 |
| 研究报告令牌数 | 「/research」与「/insiders」报告的预算。 |
| API 超时（秒） | 慢服务商被放弃前的等待秒数 —— 免费队列可能卡顿一分钟以上。 |
| 人格文件 | 机器人使用的人格。此文件夹中的 .md 文件（soul*.md、*persona*.md）会出现在每个机器人的「人格」下拉菜单中。 |
| 机器人触发词 | 让机器人在群组中回答的逗号分隔词（除 @提及、回复或命令外）—— 例如「momo、jarvis、hey bot」。 |
| 视频/音频剪辑触发词 | 让机器人把附带的视频或音频存为剪辑的词 —— 例如「clip this、save this」。 |
机器人页面
侧边栏中的每个机器人都有自己的页面。留空的字段继承默认值；每行下方的说明会注明它继承了什么。
| 设置 | 作用 |
|---|---|
| 令牌 | 机器人的 @BotFather 令牌（眼睛按钮可显示）。修改它会重命名侧边栏中的机器人条目。 |
| 昵称 | 用于状态、日志和侧边栏 —— 例如「交易」。 |
| 允许的聊天 ID / 触发词 / 剪辑词 | 该机器人对相应默认值的覆盖。 |
| 服务器 URL、API 密钥、模型 | 下拉菜单提供「默认设置 → 模型」中配置的服务商，以及任意自定义值。也可以为每个机器人添加自己的备用模型。 |
| 每日简报时间 / 简报提示词 | 机器人专属简报，带有清除覆盖的「使用全局」按钮。 |
| 模式 | 研究员、助手、程序员、厨师或无 —— 留空使用默认模式。 |
| 人格文件 | 该机器人的人格覆盖，从磁盘上找到的 soul/persona 文件中选择。 |
| 技能 | 打开该机器人的技能面板 —— 在默认设置之上为此机器人禁用技能，或恢复默认。 |
默认设置 → 应用
| 设置 | 作用 |
|---|---|
| 在程序坞中显示 | 菜单栏应用是否也出现在程序坞中。 |
| 登录时启动 | 登录时启动 Telebot AI。 |
| 数据目录 | 配置、记忆、提醒和日志的存放位置（默认 ~/.mlx-serve）。 |
| 打开日志 / 打开数据文件夹 | 在访达中直接跳转到日志文件或数据文件夹。 |
| 导出设置 | 将完整配置（包括 API 密钥）保存到文件 —— 用于备份或迁移 Mac。 |
| 导入设置 | 加载配置文件并立即应用。 |
技能与功能
机器人的能力是模型驱动的技能 —— 模型配合工具遵循的简明指令，因此您可以用自然语言描述需求，而无需记忆命令。每个分组都有总开关；单个技能可单独开关。
| 分组 | 技能 | 试试这样说 |
|---|---|---|
| 研究 | stock-research, stocks-crypto, insider-trading, currency | 「研究 TSLA」、「BTC 价格」、「AAPL 内幕交易」、「50 美元等于多少加元？」 |
| 日常 | briefing, digest, reminders, habits, review, pomodoro, bookmarks, expenses | 「/briefing」、「总结这个聊天」、「下午 5 点提醒我」、「今天习惯完成」、「每周回顾」、「/pomodoro 25」、「记一笔 25 元的午餐」 |
| 媒体 | media, voice, translation, feeds | 「分析这个视频」、「朗读这段」、「翻译成中文」、「我的订阅里有什么新内容？」 |
| 工具 | memory | 「我们昨天聊了什么？」 |
| 来自技能库 | 您从技能库安装的技能 | — |
技能库
技能库标签页让您从公开的 anthropics/skills 目录安装现成技能 —— PDF 与文档处理、电子表格、演示文稿、Web 应用测试、MCP 服务器搭建、艺术等。加载目录，挑选技能，它就会像其他技能一样出现在「技能与功能」标签页。
更新
「更新」标签页会将落地页的清单与您安装的版本对比，显示最新版本并提供下载链接。检查是静默的 —— 离线或无法访问只会显示「已是最新版本」。更新方式：下载新的 .dmg 并拖到「应用程序」覆盖旧应用。设置、机器人和记忆都保存在应用之外，更新后原样保留。
数据与隐私
- 数据存放位置：配置、聊天记忆、提醒、技能和日志都保存在您的数据目录中（默认 ~/.mlx-serve）。
- 离开您 Mac 的数据：Telegram API 本身、您指定的模型服务器，以及匿名使用统计（应用启动和菜单操作）。不含任何聊天内容、令牌或个人数据。
故障排查
- 「Apple 无法检查它是否存在恶意软件」 —— 正常现象：右键（Control-点击）「应用程序」中的应用 → 打开 → 再打开一次。只需一次，之后即可正常运行。
- 机器人不回答。打开设置 → 该机器人的页面：令牌正确吗？然后「默认设置 → 模型」→ 测试服务商。最后查看日志（菜单栏 → 日志，或应用标签页 → 打开日志）。
- 回复很慢或机器人沉默。免费服务商可能卡顿一分钟以上 —— 调高 API 超时，并添加备用模型，主服务限流时机器人可自动切换。
- 本地服务器无响应。先在「模型」标签页测试前确认服务器确实在运行（mlx-serve、Ollama…）。
- 更新显示「已是最新版本」很反常。检查是刻意静默的 —— 如果清单无法访问，它就会显示已是最新版本。
- 其他问题？ 发送反馈 — 每条消息都会送达开发者的 Telegram 并得到真实回复。
下载 Telebot AI · 喜欢它？ 请我喝杯咖啡 ☕