imkofty/Hermuse

这是什么？

核心功能

• 01通过单个脚本在 Ubuntu 上安装 Hermes Agent、9Router 和 Node.js。
• 02将 Telegram 机器人接入 Hermes 网关，并通过数字用户 ID 白名单限制访问。
• 03借助基于 Cloudflare Pages 与 D1 的轮询隧道，将本地 9Router 面板暴露到公网。
• 04通过守护脚本与定时看门狗，在 9Router、隧道客户端或网关退出后自动重启。
• 05利用事件循环心跳和适配器活动检测 Telegram 轮询卡死。
• 06提供 doctor 诊断脚本与隧道数据库迁移检查工具。

适用场景

• 在小型 Linux VPS 上运行私人 Telegram AI 助手。
• 无需开放入站端口，即可通过浏览器访问自建的模型管理面板。
• 运行需要崩溃或重启后自动恢复的长期在线机器人。

快速上手

1. 1

   安装全部依赖（依赖项、Hermes、9Router）

   bash scripts/install.sh
2. 2

   通过 OAuth 登录模型提供商

   hermes setup --portal
3. 3

   连接你的 Telegram 机器人并设置数字 ID 白名单

   hermes gateway setup
4. 4

   安装 Cloudflare 隧道（将占位符替换为你的项目名和 D1 名称）

   bash scripts/setup-tunnel.sh <pages-project-name> <d1-name>

使用前须知

• !设计用于 Linux 服务器或虚拟机；README 未提供 macOS 或 Windows 的安装方法。
• !安装脚本需要免密 sudo 或 root 权限。
• !要使用完整功能需要 Cloudflare 账户和 Telegram 机器人令牌。

收录于专题

标签

常见问题

Hermuse 是什么？

在自己的 Linux 服务器或虚拟机上部署 Hermes Agent、9Router 与 Telegram 机器人网关的脚本和指南。 Hermuse 是一套 Shell 脚本与文档，用于在自己的电脑或 VPS 上搭建个人 AI 助手环境。它把 Hermes Agent 命令行工具、兼容 OpenAI 接口的 9Router 模型代理和 Telegram 网关组合在一起，部署后可以全天候在 Telegram 中与自己的机器人对话，并通过浏览器打开模型管理面板。

Hermuse 可以免费使用吗？用的什么许可证？

Hermuse 以 MIT 许可证开源。用于商业产品前，请先确认许可证条款。

Hermuse 还在维护吗？

活跃维护中。Hermuse 最近一次提交是在 2026年10月23日。

Hermuse 适合用来做什么？

在小型 Linux VPS 上运行私人 Telegram AI 助手。 无需开放入站端口，即可通过浏览器访问自建的模型管理面板。 运行需要崩溃或重启后自动恢复的长期在线机器人。

Hermuse 怎么安装和运行？

安装全部依赖（依赖项、Hermes、9Router）: bash scripts/install.sh 通过 OAuth 登录模型提供商: hermes setup --portal 连接你的 Telegram 机器人并设置数字 ID 白名单: hermes gateway setup 安装 Cloudflare 隧道（将占位符替换为你的项目名和 D1 名称）: bash scripts/setup-tunnel.sh <pages-project-name> <d1-name>

在哪里获取 Hermuse？

源代码和安装说明在 GitHub 上：https://github.com/imkofty/Hermuse