OpenHermit 用户手册

这是 OpenHermit 的用户手册。它是写给已经拥有一个 OpenHermit 智能体、想把它用起来的人 —— 无论你是一个人独用,还是与小团队共享。

如果你要找的是如何部署、运维或扩展 OpenHermit 本身,这部分内容在 docs/ 的其他文件中,不在本手册范围内。

目录

第一部分 —— 入门

第二部分 —— 日常使用

第三部分 —— 分享你的智能体

第四部分 —— 自定义(仅 owner)

第五部分 —— 参考

如何阅读本手册

第一次使用 OpenHermit —— 按顺序阅读第一部分(大约 15 分钟)。读完后,你的智能体将能跑起来并回复消息。
已经在用,想做特定的事 —— 直接跳到对应章节。每一章末尾都有 How-to 配方,固定结构为:场景 → 前置条件 → 多种做法 → 验证 → 常见问题。
打算与他人共享智能体 —— 第三部分就是写给你的。
遇到卡壳 —— 先看故障排查与常见问题。

约定

加粗的术语在首次出现时标出概念,每一个都在术语表中有一行定义。
角色标记:仅 owner 能做的操作会带 (owner-only) 标签。完整能力对照表见第 5 章 · 用户与身份。
命令前缀:
- hermit … —— CLI 命令
- curl … —— HTTP API 调用
- 管理界面: 路径 → 操作 —— Web 管理操作