新手入门需五步:一、运行hermes version和hermes doctor验证安装与依赖;二、执行hermes setup配置模型提供商、api密钥及默认模型;三、输入hermes启动cli交互,自然语言提交任务;四、用/tools启用memory并执行任务触发技能沉淀;五、运行hermes setup gateway选微信clawbot扫码绑定。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

如果您刚接触 Hermes Agent,但尚未掌握基础操作流程,则可能是由于缺乏系统性的初始化与交互指引。以下是完成新手入门的步骤:
一、验证安装与环境检查
确认 Hermes Agent 已正确安装并具备运行条件,避免因依赖缺失或版本不兼容导致后续命令失败。
1、在终端中执行 hermes version 命令,查看当前安装的 Hermes Agent 版本号,确认是否为 v0.13.0 或更高版本。
2、运行 hermes doctor 命令,触发全链路诊断,检查 Python、Node.js、uv、Playwright 等核心依赖是否就绪。
3、若诊断报告中出现红色警告项,根据提示执行对应修复操作,例如未检测到 Playwright 则需手动运行 playwright install chromium。
二、启动配置向导
通过交互式 setup 流程完成模型提供商、API 密钥及基础服务参数的初始化写入,确保环境可立即响应任务请求。
1、在终端中输入 hermes setup 并回车,启动配置向导。
2、按提示选择模型提供商(如 Kimi、OpenRouter、Anthropic),国内用户推荐优先选择 Kimi 以保障连接稳定性。
3、粘贴从 https://platform.moonshot.cn/console 获取的有效 API Key,密钥将被安全写入 ~/.hermes/.env 文件。
4、选择默认对话模型(如 moonshot-v1-8k),完成配置后系统自动保存并退出向导。
三、启动交互式 CLI
进入终端对话界面,直接以自然语言提交任务,触发 Hermes Agent 的推理与工具调用能力。
1、在终端中执行 hermes 命令,等待加载完成后显示欢迎横幅与提示符。
2、输入任意初始指令,例如 “列出当前目录下的所有 .py 文件”,观察 Agent 是否自动调用终端工具并返回结果。
3、若首次运行无响应,检查终端是否处于代理拦截状态,可临时关闭系统代理后重试。
四、启用持久化记忆与技能沉淀
激活 Hermes Agent 的核心进化机制,使其在完成任务后自动生成 Markdown 技能文件并存入本地知识库。
1、在 CLI 中输入 /tools,进入工具管理菜单。
2、使用方向键选中 memory 选项并按空格启用,确认 SQLite FTS5 记忆引擎已激活。
3、执行一次含明确目标的任务,例如 “搜索 GitHub 上 star 数超过 5000 的 Rust Web 框架,并生成对比表格”。
4、任务完成后,检查 ~/.hermes/skills/ 目录下是否新增对应时间戳命名的 Markdown 文件。
五、配置微信 ClawBot 接入
将 Hermes Agent 接入常用通讯平台,实现跨设备消息收发与远程任务触发。
1、在 CLI 中输入 /gateway 或运行 hermes setup gateway 启动网关配置。
2、在渠道列表中输入序号 14 选择微信 ClawBot,系统将生成二维码链接。
3、使用手机微信浏览器打开该链接,扫码授权后点击“确认登录”,完成消息接口绑定。
4、在微信中向 Bot 发送任意文字,等待 TUI 终端弹出配对码,将其完整复制粘贴回终端完成最终绑定。











