Hermes 第一次对话

装好之后，第一件事是让 Hermes 能连上大模型，然后成功发出一条消息。本篇带你走完配置到对话的全流程。

核心配置命令：hermes setup

Hermes 提供交互式配置向导，覆盖模型、终端后端、网关、工具等：

hermes setup

跟着提示一步步选即可。对大多数新手，最省事的方式是下面这条。

最省事的路径：hermes setup –portal

Nous Portal 是官方聚合服务，一次登录就能同时拿到模型与各种工具网关（网页搜索、图像生成、语音等），免去了到处收集 API Key 的麻烦：

hermes setup --portal

按提示完成 OAuth 登录，模型与工具就都配置好了。这是官方首推的入门方式。

选择模型提供商

如果你更想用自己的模型 Key，可以在 hermes setup 里选「model」一节，或者之后用：

hermes model

常见提供商：

• Nous Portal：官方聚合，开箱即用，适合海外与国内用户。
• OpenAI / Anthropic：直接用官方 Key。
• OpenRouter：一个入口接大量模型，切换灵活。
• Moonshot（Kimi）：国内可访问，长上下文表现好，可作为可选模型通过 OpenRouter 等方式接入。是否选用取决于你的网络与偏好，并非必须。

选好后，Hermes 会把配置写进 ~/.hermes/config.yaml。

启动对话

配置就绪，启动两种界面之一：

# 经典命令行界面
hermes

# 现代 TUI（推荐，带有多行编辑与命令补全）
hermes --tui

启动后你会看到欢迎信息，里面列出了当前模型、可用工具与技能。试着发一句具体、好验证的话：

帮我用 Python 写一个函数，判断一个字符串是不是回文。

如果它正常回复并给出代码，说明整条链路已经跑通。

经验法则

先让一次完整对话跑通，再逐步叠加其他功能（工具、记忆、网关、定时任务）。不要一上来就把所有能力都打开，容易在出错时分辨不清是哪一层的问题。

查看与修改配置

随时可以查看当前配置：

hermes config          # 查看完整配置
hermes config edit     # 用编辑器打开 config.yaml
hermes config get model
hermes config set model anthropic/claude-opus-4

hermes config set 会自动把值路由到正确文件，密钥类内容会存进 ~/.hermes/.env，其余写进 config.yaml。

本篇小结

• hermes setup --portal 是最省事的入门路径。
• 也可自行选 Nous Portal、OpenAI、Anthropic、OpenRouter 或 Moonshot 等模型。
• hermes 进经典 CLI，hermes --tui 进现代 TUI。
• 先跑通一次对话，再叠加高级功能。

下一篇我们深入对话与会话管理，学会和 Hermes 高效沟通。