1. 什么是 OpenHermit

OpenHermit 是一个运行 AI 智能体的平台。你为它提供一个模型(Claude、GPT、Gemini……),把它接入你日常使用的入口 —— Telegram、Discord、Slack、Web、命令行 —— 然后你的智能体就以”长期运行的服务”形态住在云端。你给它发消息,它回复;让它执行命令,它执行;让它每个工作日早上写一份报告,它每个工作日早上都会写。

它和 Claude Code、Cursor 这类本地智能体最大的区别在于:OpenHermit 并不被绑定在某一台机器上。它在云端拥有持久的身份 —— 记忆、会话、技能、配置、定时任务 —— 无论你从哪个入口进来,看到的都是同一个智能体。

本手册是写给已经拥有 OpenHermit 智能体的人。如何搭建一个全新的 OpenHermit 实例,属于另一个话题,在运维文档中说明。

它解决什么问题

如果你用过 Claude Code 或类似的本地工具,你大概遇到过这些事:

  • 你在工作笔记本上教会了智能体你的偏好,回到家里那台笔记本上,它什么都不记得。
  • 你想让智能体跑一个隔夜任务,但你的笔记本会睡眠。
  • 你想让朋友用你的智能体,但它的记忆和历史绑在你的机器上。
  • 你想从 Telegram 或 Slack 而不是终端去使用智能体,结果搭桥本身变成了一个副项目。

OpenHermit 的设计就是从这些问题出发的。智能体在云端拥有持久化状态,多个入口看到的是同一个智能体,多人可以在彼此隔离的前提下共享一个智能体,而且在你离线时智能体仍在工作。

适合做什么

  • 个人助手 —— 记住你的偏好和任务,可从手机或笔记本访问,按时给你发送提醒或摘要。
  • 共享的团队助手 —— 几个人共用一个智能体:共享知识库、每日站会摘要、客服分流。
  • 垂直聊天机器人 —— 把它丢进一个 Telegram 或 Discord 群,围绕某个主题服务一个社群。
  • 后台 worker —— 定时任务用于拉取数据、抓取、撰写日报、巡检服务。
  • MCP 驱动的自动化 —— 把 GitHub、Linear、Slack 或你自己的内部 API 接入为 MCP 工具,然后用自然语言操作它们。

不擅长什么

  • 完全离线的工作。 OpenHermit 假定网关可访问。对于物理隔离的环境,纯本地工具更合适。
  • 大规模终端 SaaS。 你可以基于它构建,但限流、计费、滥用处理 —— 这些仍是你的事。
  • 替代 IDE。 它可以写代码、改文件、跑命令,但它不是 VS Code。在 IDE 里编辑代码依然更顺手。
  • 不受限的 root 操作。 默认情况下,它能访问自己的工作区并在沙箱中执行命令;访问外部世界需要 MCP 服务或你提供的密钥。它不能为所欲为。

贯穿全书的两个词

即便你是智能体的唯一使用者,有两个词值得先记住:

  • 智能体(Agent) —— 就是回复你的那个”它”。一个 OpenHermit 实例可以托管多个智能体(比如一个叫 work、一个叫 home),它们之间什么都不共享 —— 记忆、配置、访问列表都各自独立。
  • 作为 owner 的你 —— 你创建了智能体,你就是它的 owner。owner 可以修改设置、添加成员、查看所有会话、使用所有工具。你邀请进来的其他人会拿到更受限的角色:user 或 guest。详情见 第 5 章 · 用户与身份。

下一步去哪