HoRain 云小助手个人主页⛺️生活的理想就是为了理想的生活!⛳️ 推荐前些天发现了一个超棒的服务器购买网站性价比超高大内存超划算忍不住分享一下给大家。点击跳转到网站。目录⛳️ 推荐选择模型提供商推荐路径Nous Portal最省事常用提供商一览切换提供商三种 Setup 模式模式一Quick SetupNous Portal模式二Full Setup模式三Blank Slate空白起点开启第一次对话验证一切正常验证会话恢复TUI 界面基本操作核心斜杠命令终端执行后端配置切换到 Docker 后端推荐用于生产工具集管理主要工具集配置管理常用命令常见问题排查问题一hermes: command not found问题二API key not set / 模型无响应问题三回复为空或乱码问题四上下文窗口不足报错问题五hermes --continue 找不到旧会话万能恢复工具包进阶配置预览接入消息平台启用语音模式接入 MCP 服务器编辑器集成ACP快速命令参考安装完成后所有配置和数据都保存在~/.hermes/下~/.hermes/ ├── config.yaml # 主配置文件模型、工具、终端后端等 ├── .env # API 密钥和 Secret不提交到版本库 ├── auth.json # OAuth 凭据Nous Portal 等 ├── SOUL.md # Agent 人格设定文件 ├── memories/ # 持久记忆MEMORY.md、USER.md ├── skills/ # 技能文件Agent 自动创建和管理 ├── cron/ # 定时任务配置 ├── sessions/ # 网关会话记录 └── logs/ # 日志API 密钥自动脱敏重要原则SecretsAPI 密钥、Token、密码→ 存入.env普通配置模型、工具、终端后端等→ 存入config.yaml使用hermes config set KEY VALUE命令会自动路由到正确的文件选择模型提供商运行以下命令进入交互式选择hermes model推荐路径Nous Portal最省事一个订阅覆盖 300 模型 Tool Gateway网页搜索、图片生成、TTS、云端浏览器无需分别申请多个 API Keyhermes setup执行后通过 OAuth 登录自动完成提供商配置和工具网关的开启。常用提供商一览提供商特点配置方式Nous Portal订阅制300 模型Tool Gatewayhermes setup --portalOAuth 登录AnthropicClaude 系列Max 订阅可 OAuthANTHROPIC_API_KEY或 OAuthOpenAI CodexChatGPT OAuthCodex 模型hermes model→ OAuth 设备码OpenRouter多提供商路由200 模型OPENROUTER_API_KEYxAI Grok OAuthSuperGrok / Premium 订阅无需 API Keyhermes model→ xAI Grok OAuthGitHub CopilotCopilot 订阅GPT、Claude、Geminihermes model→ OAuthGoogle AI StudioGemini 系列GOOGLE_API_KEYDeepSeekDeepSeek 系列DEEPSEEK_API_KEY本地模型Ollama完全本地无费用设置自定义 Base URL模型上下文窗口要求Hermes 要求模型至少支持64,000 tokens的上下文。使用本地模型时确保启动参数中设置了足够的上下文大小如--ctx-size 65536。切换提供商随时可以切换无需修改任何代码hermes model三种 Setup 模式首次运行hermes setup时会提示选择初始化模式模式一Quick SetupNous Portal免费 OAuth 登录自动配置模型 Tool Gateway网页搜索、图片生成、TTS、浏览器。推荐新用户使用。模式二Full Setup手动逐项配置提供商、工具集、消息平台等。适合有明确需求、自带 API Key 的用户。模式三Blank Slate空白起点只保留最小运行集提供商、文件工具、终端工具其余一切关闭。适合需要精确控制 Agent 能力边界的高级用户。空白模式会显式写入配置防止hermes update后自动开启新功能。开启第一次对话配置完成后启动 Hermeshermes # 经典 CLI 模式 hermes --tui # 现代 TUI 模式推荐支持鼠标、弹窗等启动后会显示欢迎横幅包含当前模型、可用工具和已加载技能的信息。验证一切正常用一个简单但具体的提示词测试检查我当前目录告诉我里面有哪些文件并识别主要的项目入口文件。成功标志横幅正确显示你选择的模型/提供商Agent 正常响应无报错信息需要时能调用工具终端、文件读取等对话可以持续超过一轮验证会话恢复确认跨会话连续性正常工作检查我当前目录告诉我里面有哪些文件并识别主要的项目入口文件。TUI 界面基本操作运行hermes --tui进入现代 TUI 模式后常用操作操作快捷键发送消息Enter多行输入换行AltEnter或CtrlJ打断 Agent 当前任务直接输入新消息后Enter强制中断CtrlC查看所有命令输入/触发自动补全核心斜杠命令命令作用/help显示所有可用命令/tools列出当前启用的工具/model运行时切换模型/memory查看和管理 Agent 记忆/skills查看和管理技能/save保存当前对话/new开启新会话保留当前设置/verbose切换工具调用详细输出级别/voice on开启语音输入模式终端执行后端配置Hermes 支持六种终端执行环境决定 Agent 的 Shell 命令在哪里运行后端命令在哪里执行隔离程度适用场景local默认本机直接执行无开发、个人使用dockerDocker 容器内完全隔离安全沙箱、CI/CDssh远程服务器网络边界远程开发、高性能机器modalModal 云沙箱完全云 VM临时云计算、评测daytonaDaytona 工作区完全云容器托管云开发环境singularitySingularity 容器命名空间隔离HPC 集群、共享机器切换到 Docker 后端推荐用于生产hermes config set terminal.backend docker或直接编辑~/.hermes/config.yamlterminal: backend: docker docker_image: nikolaik/python-nodejs:python3.11-nodejs20安全说明默认的local后端让 Agent 拥有和你相同的文件系统权限。如果你希望限制 Agent 的操作范围切换到docker后端是最简单有效的方式。工具集管理Hermes 将 70 内置工具分组为 28 个工具集可以按需启用或关闭hermes tools # 打开可视化工具集管理界面curses UI主要工具集工具集包含能力filesystem文件读写、目录操作terminalShell 命令执行web网页搜索、内容提取browser完整浏览器自动化需 Playwrightcode代码执行execute_code工具vision图片分析audio语音转文字、TTSmemory记忆管理工具skills技能管理工具mcpMCP 服务器工具集动态关闭某个工具集该工具集从系统提示词中完全消失不只是禁用——这样可以节省 Token并防止 Agent 误用不该用的工具。配置管理常用命令# 查看当前完整配置 hermes config # 用编辑器打开 config.yaml hermes config edit # 设置单个配置值自动路由到正确文件 hermes config set model anthropic/claude-sonnet-4-6 hermes config set terminal.backend docker hermes config set OPENROUTER_API_KEY sk-or-... # 自动存入 .env # 检查是否有新版本引入的配置项未填写 hermes config check # 交互式补全缺失配置 hermes config migrate # 诊断所有配置问题 hermes doctor # 更新到最新版本 hermes update常见问题排查问题一hermes: command not found# 刷新 Shell 配置 source ~/.bashrc # 或 source ~/.zshrc # 如果仍然找不到检查 PATH echo $PATH # 确保 ~/.local/bin 在其中 export PATH$HOME/.local/bin:$PATH问题二API key not set/ 模型无响应# 重新配置提供商 hermes model # 或直接设置 API Key hermes config set OPENROUTER_API_KEY sk-or-...问题三回复为空或乱码可能是提供商鉴权或模型选择有误# 重新选择模型 hermes model # 全面诊断 hermes doctor问题四上下文窗口不足报错Hermes 要求模型至少支持 64K Token 上下文。切换到支持更大上下文的模型或在使用本地模型时增大上下文参数如 OllamaOLLAMA_NUM_CTX65536。问题五hermes --continue找不到旧会话# 查看所有会话 hermes sessions list # 确认当前 Profile hermes profile list万能恢复工具包遇到任何奇怪问题按以下顺序执行hermes doctor # 1. 诊断 hermes model # 2. 检查模型配置 hermes setup # 3. 重新向导配置 hermes sessions list # 4. 查看会话状态 hermes --continue # 5. 尝试恢复会话 hermes gateway status # 6. 检查网关状态如已启用进阶配置预览完成基础安装后以下功能可以按需开启后续章节详细介绍接入消息平台hermes gateway setup # 交互式配置 Telegram、Discord、Slack 等 hermes gateway # 启动消息网关启用语音模式# 安装语音依赖 cd ~/.hermes/hermes-agent uv pip install -e .[voice] # 在 CLI 中启用 /voice on # 按 CtrlB 开始录音接入 MCP 服务器在~/.hermes/config.yaml中添加mcp_servers: github: command: npx args: [-y, modelcontextprotocol/server-github] env: GITHUB_PERSONAL_ACCESS_TOKEN: ghp_xxxhermes mcp # 交互式管理 MCP 服务器编辑器集成ACPhermes acp # 启动编辑器 Agent 模式VS Code / Zed / JetBrains快速命令参考命令说明hermes启动 CLI 对话hermes --tui启动 TUI 对话推荐hermes desktop启动桌面应用hermes model选择/切换 LLM 提供商和模型hermes setup完整 Setup 向导hermes setup --portal快速配置 Nous Portalhermes tools配置工具集hermes doctor诊断配置问题hermes update更新到最新版本hermes gateway启动消息网关hermes gateway setup配置消息平台hermes --continue恢复最近会话hermes config set KEY VAL设置配置项hermes sessions list查看历史会话hermes profile list查看 Agent Profile❤️❤️❤️本人水平有限如有纰漏欢迎各位大佬评论批评指正如果觉得这篇文对你有帮助的话也请给个点赞、收藏下吧非常感谢! Stay Hungry Stay Foolish 道阻且长,行则将至,让我们一起加油吧