Repolode
nalgeon

nalgeon/pokitoki

一个可自部署的 Telegram AI 聊天机器人,支持 OpenAI、Claude、Gemini 及兼容接口的模型。

Star
341
Fork
60
未关闭 Issue
0
最近提交
14天前

这是什么?

Humble AI Telegram Bot 是一个运行在 Telegram 中的 AI 聊天机器人,可将问题转发给 OpenAI、Claude、Gemini 或 OpenRouter 等兼容 OpenAI 接口的服务商的大模型。它既支持私聊,也支持群组,在群组中可通过提及机器人或回复问题来获得回答。

机器人会在可配置的时间内保留对话上下文,支持为每个聊天单独设置提示词和模型,管理员还可以通过 /config 命令在不重启的情况下修改大多数设置。内置的 proofread、translate、summarize 等快捷指令可用于润色、翻译和总结,也可以在配置文件中自定义。

使用 OpenAI、Claude 或 Gemini 时,模型可借助服务商的服务端工具自行联网搜索并打开链接;其他接口则由机器人抓取链接中的文本内容交给模型。群组可设置每用户的消息频率限制以控制 API 开销,项目通过 Docker Compose 部署。

核心功能

  • 01支持私聊和群组,可回答直接提问和 @ 提及。
  • 02兼容 OpenAI、Claude、Gemini 以及 OpenAI 兼容接口的服务商。
  • 03在设定的超时时间内保留上下文,支持连续追问。
  • 04每个聊天可单独设置提示词和模型。
  • 05内置 proofread、translate、summarize 等快捷指令,并支持自定义。
  • 06管理员可通过 /config 命令在运行时修改大多数配置。

适用场景

  • 在 Telegram 上为自己或几位好友搭建私人 AI 助手。
  • 在团队的 Telegram 群组中提供共享的 AI 助手,并设置使用频率限制。
  • 在聊天中直接润色、翻译或总结文本。
  • 在 Telegram 内针对文本文件或网页链接提问。

快速上手

  1. 1

    获取 AI API 密钥和 BotFather 提供的 Telegram 机器人令牌

  2. 2

    克隆代码仓库

    git clone https://github.com/nalgeon/pokitoki.git
  3. 3

    将示例配置复制为 config.yml 并填入你的令牌

    cp config.example.yml config.yml
  4. 4

    使用 Docker Compose 启动机器人

    docker compose up --build --detach

使用前须知

  • 你需要自备 AI 服务商的 API 密钥和 Telegram 机器人令牌,服务商用量可能产生费用。
  • 网页搜索和链接工具可能会产生服务商的额外费用。
  • 该项目只接受错误修复类的贡献,不接受新功能贡献。

收录于专题

标签

常见问题

pokitoki 是什么?
一个可自部署的 Telegram AI 聊天机器人,支持 OpenAI、Claude、Gemini 及兼容接口的模型。 Humble AI Telegram Bot 是一个运行在 Telegram 中的 AI 聊天机器人,可将问题转发给 OpenAI、Claude、Gemini 或 OpenRouter 等兼容 OpenAI 接口的服务商的大模型。它既支持私聊,也支持群组,在群组中可通过提及机器人或回复问题来获得回答。
pokitoki 可以免费使用吗?用的什么许可证?
pokitoki 以 MIT 许可证开源。用于商业产品前,请先确认许可证条款。
pokitoki 还在维护吗?
活跃维护中。pokitoki 最近一次提交是在 2026年10月24日。
pokitoki 适合用来做什么?
在 Telegram 上为自己或几位好友搭建私人 AI 助手。 在团队的 Telegram 群组中提供共享的 AI 助手,并设置使用频率限制。 在聊天中直接润色、翻译或总结文本。 在 Telegram 内针对文本文件或网页链接提问。
pokitoki 怎么安装和运行?
获取 AI API 密钥和 BotFather 提供的 Telegram 机器人令牌 克隆代码仓库: git clone https://github.com/nalgeon/pokitoki.git 将示例配置复制为 config.yml 并填入你的令牌: cp config.example.yml config.yml 使用 Docker Compose 启动机器人: docker compose up --build --detach
在哪里获取 pokitoki?
源代码和安装说明在 GitHub 上:https://github.com/nalgeon/pokitoki

概要由 AI 根据项目 README 生成;GitHub 数据每日更新。

相关项目