§ 基础概念
Hermes Agent 是什么？
Hermes Agent 是由 Nous Research 打造的开源自进化 AI 智能体框架。它不是一个简单的聊天机器人，而是一个能持久运行、自动学习、跨平台对话的智能体。它会记住你的项目、自动创建技能、并通过经验不断变强。
Hermes Agent 和 ChatGPT / Claude 有什么区别？
ChatGPT 和 Claude 是「聊天界面 + 大模型」，每次对话从零开始。Hermes Agent 是一个持久的「智能体」—— 它运行在你自己的服务器上，有持久记忆、40+ 内置工具（终端、浏览器、文件系统等）、自动创建的技能系统、定时任务调度，并且可以同时通过微信、钉钉、Telegram 等多平台与你交流。
Hermes Agent 收费吗？
Hermes Agent 本身完全免费开源（MIT License）。你只需要为使用的 LLM API 付费（比如智谱AI、Kimi 的 API 调用费用）。如果使用本地模型（如 Ollama），则完全零成本。
Hermes Agent 支持哪些大模型？
支持几乎所有主流大模型：智谱AI (GLM)、Kimi (Moonshot)、MiniMax、小米 MiMo、OpenAI (GPT-4)、Anthropic (Claude)、Google (Gemini)、Meta (Llama)，以及通过 OpenRouter 访问 200+ 模型。也支持本地模型（Ollama、vLLM 等）。
§ 安装问题
安装脚本无法下载，提示网络错误
这通常是因为无法访问 GitHub。解决方案：
1. 设置代理：export https_proxy=http://127.0.0.1:7890
2. 使用 GitHub 镜像：将 github.com 替换为 ghproxy.com/github.com
3. 使用手动安装方式（参考快速开始页面）
4. 如果在公司网络，联系 IT 部门开通 GitHub 访问
Windows 能用吗？
Hermes Agent 不支持原生 Windows。请安装 WSL2（Windows Subsystem for Linux），这是微软官方的 Linux 兼容层。安装方法：以管理员权限运行 PowerShell，执行 wsl --install，重启后即可在 Ubuntu 终端中安装 Hermes Agent。
Python 版本不对怎么办？
Hermes Agent 需要 Python 3.11+。安装脚本会通过 uv 自动安装正确版本。如果手动安装，可以用 uv venv venv --python 3.11 指定版本。不建议修改系统 Python 版本。
pip install 时报错缺少编译依赖
某些 Python 包需要编译 C 扩展。在 Ubuntu/Debian 上运行：
sudo apt install build-essential python3-dev libffi-dev
在 macOS 上确保安装了 Xcode Command Line Tools：
xcode-select --install
§ 模型配置
国内用哪个模型最好？
推荐智谱AI的 glm-4-plus，中文能力强、价格合理、国内直连。如果需要处理长文档，推荐 Kimi 的 moonshot-v1-128k。如果追求极致性价比，可以用 glm-4-flash（免费额度多）。
可以用本地模型吗？
当然可以。安装 Ollama 后，在 config.yaml 中设置 base_url 为 http://localhost:11434/v1，api_key 设为 ollama 即可。推荐使用 qwen2.5、llama3.1 等开源模型。注意本地模型对工具调用的支持可能不如 API 模型好。
如何在对话中切换模型？
在对话中输入 /model 即可交互式切换，或直接输入 /model glm-4-plus 指定模型。切换即时生效，无需重启。
§ 平台接入
微信接入需要什么条件？
微信没有官方开放 API，需要通过第三方桥接服务（如 WeChatFerry）实现。Hermes Agent 提供了 WEIXIN_ 系列环境变量来配置微信接入。注意这种方式存在一定合规风险，建议仅用于个人用途。
企业微信接入有哪些方式？
两种方式：
1. WebSocket 模式：配置简单，只需 WECOM_BOT_ID 和 WECOM_SECRET
2. 回调模式：需要公网服务器，功能更全，配置 WECOM_CALLBACK_* 系列变量
推荐先用 WebSocket 模式快速上手。
飞书接入推荐哪种连接方式？
推荐 WebSocket 模式（FEISHU_CONNECTION_MODE=websocket），无需公网服务器即可使用。Webhook 模式需要你的服务器有公网可访问的地址。国际版 Lark 将 FEISHU_DOMAIN 设为 lark 即可。
Gateway 启动后平台没有连接上
排查步骤：
1. 检查 ~/.hermes/.env 中的环境变量是否正确
2. 运行 hermes gateway status --deep 查看详细状态
3. 查看日志：hermes logs -f
4. 运行 hermes doctor 进行诊断
5. 确认 API Key / Token 没有过期
§ 使用技巧
如何让 Agent 记住特定信息？
Hermes Agent 有内置的记忆系统，会自动记住重要信息。你也可以直接告诉它「请记住 XXX」来主动写入记忆。记忆存储在 ~/.hermes/memory/MEMORY.md 文件中。
如何设置定时任务？
使用自然语言即可：
• CLI: hermes cron create "0 9 * * *" "生成每日工作报告"
• 对话中直接说：「每天早上 9 点给我发一份项目进度总结」
• 支持投递到任意平台：--deliver telegram:12345
上下文太长会影响效果吗？
Hermes Agent 有内置的上下文压缩机制。当对话过长时，它会自动压缩历史内容，保留关键信息。你也可以手动输入 /compress 来压缩，或 /usage 查看当前 token 使用情况。
如何安装社区技能？
运行 hermes skills browse 浏览可用技能，hermes skills install <名称> 安装。Agent 也会在使用过程中自动创建新技能，并在后续使用中不断优化它们。
§ 安全与隐私
我的数据安全吗？
Hermes Agent 运行在你自己的服务器上，数据完全自主可控。对话内容、记忆、技能都存储在本地 ~/.hermes/ 目录。唯一的外部通信是调用 LLM API —— 你选择什么提供商，数据就发往哪里。使用本地模型则数据完全不出本地。
如何限制谁能跟 Agent 对话？
通过各平台的 ALLOWED_USERS 环境变量控制。例如 TELEGRAM_ALLOWED_USERS=12345,67890 只允许指定用户 ID。还有 DM 配对机制 (hermes pairing) 提供更细粒度的权限控制。
还有问题？
加入社区，与其他用户和开发者交流