一、全局与配置档案 (Global & Profiles)
hermes --version显示当前版本 (-V)
hermes profile create <名>创建全新的独立配置档案
hermes profile create <新> --clone <旧>克隆已有档案的基础配置来创建新档案
hermes profile list查看本机所有的配置档案列表
hermes profile use <名>永久切换并使用指定的配置档案
hermes profile show显示当前正在使用的配置档案
hermes profile edit <名>直接打开档案的底层 YAML 配置文件
hermes profile rename <旧> <新>重命名已有的配置档案
hermes profile delete <名>删除不需要的旧配置档案
hermes profile export <名>将配置档案导出为分享包或备份
hermes profile import <路径>从文件中导入别人的配置档案
hermes -p <name>单次调用：以指定 profile 运行
hermes -r <session>恢复指定的对话会话
hermes --yolo跳过所有危险操作的确认
hermes --tui启动终端图形交互界面
二、核心命令 (Core)
hermes chat开启交互式对话窗口
hermes setup全功能初始化配置向导
hermes auth管理登录凭据与 API Key
hermes model交互式选择/添加模型
hermes doctor环境诊断与依赖修复
三、状态与网关 (Status & Gateway)
hermes status查看 Agent 及网关运行状态
hermes config path输出当前配置文件的绝对路径
hermes config edit手动编辑配置文件 (YAML)
hermes gateway start后台运行消息网关服务
hermes gateway install将网关注册为系统自启服务
hermes insights显示详细的 Token 消耗分析
💬 微信集成与管理 (WeChat)
hermes gateway setup配置向导/扫码登录 (含微信/WeCom)
hermes gateway start启动消息网关后台服务
hermes gateway stop停止消息网关服务
hermes gateway status查看网关实时运行状态
hermes gateway前台调试模式 (显示详细报错)
journalctl --user -u hermes-gateway -f查看实时系统日志 (最常用)
🏢 企业微信与管理 (WeCom) PRO
hermes pairing list查看已连接/待批准的用户
hermes pairing approve <ID>批准新的配对请求
hermes sessions list查看当前所有活跃的对话会话
hermes doctor --fix自动检查并修复微信运行环境
四、任务与备份 (Tasks & Backup)
hermes cron检查并手动触发定时任务
hermes sessions prune清理过期的历史对话会话
hermes backup备份所有数据 (含记忆与技能)
hermes import从备份包中恢复 Agent 状态
hermes logs tail实时查看后台运行日志
五、技能系统 (Skills)
hermes skills list列出当前掌握的所有技能
hermes skills search在社区库中搜索新功能插件
hermes skills install通过名称或 URL 安装新技能
hermes pairing批准/撤销消息网关配对码
六、高级功能 (Advanced) PRO
hermes honcho管理 Honcho 跨会话长效记忆
hermes mcp run启动 MCP (模型上下文协议) 服务
hermes acp运行 ACP 服务器 (编程专用)
hermes dashboard开启 Web 端可视化管理面板
hermes memory setup配置外部记忆源 (如 Hindsight)
七、迁移与维护 (Misc)
hermes claw migrate从 OpenClaw 迁移旧版数据
hermes update一键检查并更新 Hermes 核心
/model claude-3-5对话内快捷指令：实时换模型
八、Skills 分类速查表
| AI代理 | claude-code, codex, open-code |
| 创意创作 | ascii-art, excalidraw, manim-video |
| 开发辅助 | github-pr-workflow, code-review |
| 音视频 | youtube-content, gif-search, songsee |
| 科学研究 | arxiv, blogwatcher, scholar-search |
⚠️ 微信连接避坑小贴士 (Memorize it!)
- 代理（VPN）是头号杀手：iLink 协议对网络极其敏感。请务必在代理软件中将
ilinkai.weixin.qq.com 设为 直连 (Direct)。
- Account ID 唯一性：每次重新配置产生的 ID 可能不同。如果你在微信里搜不到，请留意扫码成功后机器人发给你的第一条消息。
- 不要“自言自语”：必须用另一个微信号测试，扫码登录的那个微信号发出的消息机器人是收不到的。
- 配置文件手动干预：如果向导无法解决，可尝试直接编辑
~/.hermes/.env。