一、Hermes Agent 是什么Hermes Agent 是 Nous Research 开源的自主进化 AI 智能体框架——不是那种问一答一的聊天机器人而是一个越用越聪明的长期数字伙伴。它能在每一次交互中积累经验、自动沉淀可复用技能、精准记住你的偏好用得越久协作效率越高。Kanban看板是 Hermes Agent v0.12.0 引入的多智能体任务编排系统基于 SQLite 持久化看板支持任务拆解、角色分派、并行执行与自动状态流转。简单说一张看板调度一队 AI并行干活状态不丢。解决的核心痛点痛点传统单 AgentHermes Kanban任务阻塞串行执行一步卡住全流程停滞并行 Delegate各子 Agent 独立运行状态丢失会话结束即忘无法断点续传SQLite 持久化断电重启不丢状态协同混乱多角色混在同一个上下文Profile 级隔离职责清晰不串台二、安装前准备2.1 系统要求项目最低要求推荐配置操作系统Linux / macOS / Windows (WSL2)Ubuntu 22.04 / macOS 13CPUx86_64 / ARM642 核内存256 MB2 GB存储100 MB1 GB含依赖和轨迹文件网络稳定联网10 Mbps前置依赖Git 2.0curl, bashWindows 用户注意原生 Windows 不支持必须通过 WSL2 运行且需要管理员权限开启 WSL2 功能。WSL1 也不行务必确认是 WSL2。2.2 准备 LLM API 密钥Hermes Agent 是模型无关的至少准备以下任意一个API 密钥模型提供商特色获取地址OpenRouter200 模型一键切换openrouter.aiAnthropic Claude推理能力顶级console.anthropic.comOpenAIGPT 系列platform.openai.com智谱 GLM国产模型中文友好open.bigmodel.cnKimi200 万 Token 上下文platform.moonshot.cnDeepSeek性价比之王platform.deepseek.comOllama 本地零成本隐私安全ollama.com国内用户建议Kimi 或智谱 GLM 连接稳定、性价比高也可通过自定义base_url接入国内中转服务无需代理即可调用 Claude 全系模型。2.3 国内网络加速建议如遇 GitHub / PyPI 下载缓慢建议提前配置镜像# 配置清华 PyPI 镜像pip configsetglobal.index-url https://pypi.tuna.tsinghua.edu.cn/simple三、安装方式详解Hermes Agent 提供 4 种安装方式最终功能完全一致区别仅在安装流程和运维方式。方式一curl 一键脚本官方推荐最快 2 分钟适合绝大多数用户脚本自动处理所有依赖Python、Node.js、ripgrep、ffmpeg 等。# Linux / macOS / WSL2 通用curl-fsSLhttps://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh|bash# 刷新 shell 配置让 hermes 命令生效source~/.zshrc# 或 source ~/.bashrc脚本自动完成的工作安装 uvPython 包管理器比 pip 快 10 倍安装 Python 3.11不污染系统 Python安装 Node.js 22、ripgrep、ffmpeg克隆仓库到~/.hermes/hermes-agent创建虚拟环境安装全部依赖启动配置向导方式二Docker 部署适合服务器 / 追求隔离# 基础运行dockerrun-d\-v~/.hermes:/root/.hermes\-p8080:8080\nousresearch/hermes-agent:latest# 带反向代理的完整部署生产推荐# 需搭配 docker-compose.yml Traefik方式三uv 手动安装适合开发者# 安装 uvcurl-LsSfhttps://astral.sh/uv/install.sh|shsource~/.bashrc# 克隆并安装gitclone https://github.com/NousResearch/hermes-agent.git ~/.hermes/hermes-agentcd~/.hermes/hermes-agent uv venvsource.venv/bin/activate uv pipinstall-e.# 初始化hermes setup方式四云服务器一键镜像阿里云、腾讯云、百度智能云均已提供 Hermes Agent 应用镜像选购轻量服务器后可直接启动免去安装步骤。四、初始化配置安装完成后执行初始化向导hermes setup向导会依次引导你完成4.1 配置 LLM 模型选择模型提供商 → 输入 API Key → 选择模型 → 确认上下文长度。# 或直接用命令配置hermes model# 选择 Custom endpoint 可接入任意 OpenAI 兼容 API# 输入 base_url 和 API Key 即可国内中转配置示例以 Kimi 为例# ~/.hermes/config.yamlmodel:provider:custombase_url:https://api.moonshot.cn/v1api_key:sk-your-key-heremodel:moonshot-v1-128k4.2 消息平台集成可选向导会询问是否集成消息平台。选择你需要的平台按提示配置 Bot Token 即可。也可以后续再配置。4.3 验证安装# 健康检查hermes doctor# 快速对话测试hermes chat# 输入任意内容确认模型正常响应4.4 关键目录结构~/.hermes/ ├── config.yaml # 全局配置 ├── .env # API 密钥敏感信息 ├── SOUL.md # Agent 人格定义 ├── kanban.db # Kanban 看板数据库SQLite ├── state.db # 记忆数据库SQLite FTS5 ├── sessions/ # 会话历史 ├── memories/ # 持久化记忆 ├── skills/ # 技能文件Markdown ├── cron/ # 定时任务配置 ├── trajectories/ # 执行轨迹JSONL └── profiles/ # 多 Profile 目录五、Kanban 看板操作指南这才是重头戏——Kanban 是 Hermes 实现一队 AI 并行干活的核心引擎。5.1 初始化看板# 步骤 1初始化看板数据库hermes kanban init# 步骤 2验证数据库生成ls-la~/.hermes/kanban.db# 确认文件存在且可读写# 步骤 3启动 Dispatcher 后台服务持续监听新任务hermes dispatcher start--daemon5.2 创建多角色 Agent Profile每个 Profile 代表一个具备特定技能的独立 AI 角色Kanban 依据任务类型自动唤醒对应 Profile。# 创建 researcher 角色hermes profile create researcher# 为 researcher 安装技能hermes-presearcher skillsinstallweb-search summarize# 创建 engineer 角色hermes profile create engineer# 为 engineer 安装技能hermes-pengineer skillsinstallcode-gen terminal-exec# 创建 reviewer 角色hermes profile create reviewer hermes-previewer skillsinstallcode-review security-audit# 创建 reporter 角色hermes profile create reporter hermes-preporter skillsinstallreport-gen chart-genProfile 隔离保证隔离维度说明配置隔离独立的 config.yaml、.env人格隔离独立的 SOUL.md记忆隔离独立的 state.db会话隔离独立的 sessions/技能隔离独立的 skills/网关隔离独立的 Gateway 进程 Bot Token定时任务隔离独立的 cron/5.3 为各 Profile 配置差异化模型不同角色可以使用不同模型实现成本与能力的最优匹配# researcher 用 Kimi长上下文适合文献阅读hermes-presearcher configsetmodel.model moonshot-v1-128k# engineer 用 Claude代码能力顶级hermes-pengineer configsetmodel.model anthropic/claude-sonnet-4# reporter 用 DeepSeek性价比高适合生成报告hermes-preporter configsetmodel.model deepseek/deepseek-chat5.4 创建看板任务# 方式一指定拆解数量和角色hermes kanban create\--title构建用户登录系统\--split5\--rolesresearcher,engineer,engineer,reviewer,reporter# 方式二直接指定子任务内容hermes kanban_create\--title处理新销售线索\--tasks解析表单,验证邮箱,录入CRM,发送欢迎邮件创建后Kanban 会自动将父任务拆解为子任务卡片为每个子任务绑定对应角色的 Profile将子任务状态设为pending写入~/.hermes/kanban.db5.5 查看看板状态# 查看所有任务概览hermes kanban list# 查看指定任务详情hermes kanban showtask-id# 实时跟踪执行日志流hermes kanbantail5.6 任务状态流转Kanban 任务遵循严格的状态机pending → assigned → running → completed ✓ → failed ✗可重试回 pending → blocked ⚠解除阻塞后回 pending状态含义触发条件pending待处理任务刚创建assigned已分派绑定 Agent Profilerunning执行中子 Agent 开始工作completed已完成执行成功failed已失败执行出错可重试blocked已阻塞依赖未满足需人工介入5.7 人工介入与阻塞处理# 阻塞某个任务暂停执行hermes kanban blocktask-id--reason等待第三方API审批# 解除阻塞恢复执行hermes kanban resolvetask-id# 重试失败任务hermes kanban retrytask-id六、Delegate 并行执行Delegate 机制是 Kanban 的加速引擎——主 Agent 动态生成子 Agent 实例在隔离终端会话中并行处理子任务。6.1 启用 Delegate# 启动带委托能力的 Agenthermes run --enable-delegate --max-delegate-workers46.2 在 SOUL.md 中配置并行策略# ~/.hermes/SOUL.md或对应 Profile 的 SOUL.md ## 并行策略 - 当任务复杂度 3 时使用 delegate_tool 并行处理 - 最多同时启动 4 个子 Agent - 每个子 Agent 独立终端、独立上下文 - 子 Agent 间通过 kanban.db 共享状态6.3 关键特性各子 Agent 拥有独立上下文、独立工具作用域、独立迭代预算子 Agent 间互不干扰零上下文开销支持通过 RPC 调用工具子 Agent 完成后自动更新看板状态七、Cron 定时调度将重复性高、时效性强的任务交给内置 Cron 调度器实现无人值守。7.1 配置定时任务# ~/.hermes/crontab.yaml-schedule:0 */2 * * *# 每 2 小时执行一次job:kanban_sync --status pending-schedule:0 9 * * 1-5# 工作日每天早上 9 点job:生成日报并推送至飞书群7.2 调度器操作# 启动调度服务hermescronstart# 查看调度状态hermescronstatus# 输出: Active: true, Next fire: [timestamp]# 查看所有定时任务hermescronlist7.3 两种触发模式模式说明适用场景定时触发基于 Cron 表达式定期巡检、日报生成条件触发基于外部事件文件变更触发、Git Push 触发、API 响应触发八、记忆与轨迹系统8.1 持久化记忆Hermes 的记忆不是简单的对话历史而是一个三层记忆系统层次说明存储会话记忆当前对话上下文内存持久记忆跨会话的重要事实和经验SQLite FTS5技能记忆成功经验的提炼Markdown 格式skills/ 目录记忆系统的四大能力自动评估智能判断什么值得记、什么该忘主动召回适时主动回忆相关经验技能沉淀完成复杂任务后自动提炼为技能文件用户建模基于 Honcho 的辩证法用户建模深度理解用户偏好8.2 轨迹保存与回溯所有工作流执行过程以 JSONL 格式完整记录# 轨迹文件路径~/.hermes/trajectories/*.jsonl# 会话搜索hermes session_searchfailed at kanban_complete# 支持任意节点状态还原与问题复现轨迹记录内容涵盖系统提示、用户输入、工具调用、子 Agent 输出、错误堆栈。九、自定义 SOUL.md 人格SOUL.md 是 Hermes Agent 的灵魂文件定义了 Agent 的身份特征与行为边界。# ~/.hermes/SOUL.md ## 身份 你是一个资深数据工程师专注于大数据平台开发和数据治理。 ## 行为准则 - 编写代码前先分析需求输出设计方案 - 代码必须包含错误处理和日志 - 优先使用 SQL 解决数据问题 - 遇到不确定的技术选型先调研再决策 ## 并行策略 - 当任务复杂度 3 时使用 delegate_tool 并行处理 - 最多同时启动 4 个子 Agent ## 输出偏好 - 使用 Markdown 格式输出 - 代码块标注语言类型 - 关键步骤添加中文注释每个 Profile 可以拥有独立的 SOUL.md确保不同角色专注各自领域。十、实战案例多角色协同开发以构建用户登录系统为例完整演示 Kanban 工作流。步骤 1初始化hermes kanban init hermes dispatcher start--daemon步骤 2创建角色hermes profile create researcher hermes profile create engineer hermes profile create reviewer hermes profile create reporter# 安装技能hermes-presearcher skillsinstallweb-search summarize hermes-pengineer skillsinstallcode-gen terminal-exec hermes-previewer skillsinstallcode-review security-audit hermes-preporter skillsinstallreport-gen chart-gen步骤 3创建看板任务hermes kanban create\--title构建用户登录系统\--split5\--rolesresearcher,engineer,engineer,reviewer,reporterKanban 自动拆解为 5 个子任务子任务角色内容#1researcher调研最佳实践输出 UI 设计稿#2engineer后端 API 实现认证、鉴权#3engineer前端组件开发登录页、注册页#4reviewer安全审查SQL 注入、XSS、CSRF#5reporter生成测试报告步骤 4并行执行hermes run --enable-delegate --max-delegate-workers4执行流程researcher → engineer(后端) → engineer(前端) → reviewer → reporter各子 Agent 在隔离环境中并行工作状态实时写入kanban.db。步骤 5监控与干预# 实时查看执行日志hermes kanbantail# 如果某个子任务卡住hermes kanban blocksub-task-id--reason等待设计稿确认hermes kanban resolvesub-task-id# 查看最终结果hermes kanban showparent-task-id十一、常见问题与排障Q1安装脚本执行失败# 检查 Git 是否安装git--version# 检查网络连通性curl-Ihttps://github.com# 国内用户配置代理或使用镜像exportHTTPS_PROXYhttp://your-proxy:portQ2模型调用 401 / 403 错误检查 API Key 是否正确hermes config get model.api_key检查 API 余额是否充足确认base_url配置正确国内中转地址不要带/v1后缀除非接口要求Q3Kanban 任务一直卡在 pending# 确认 Dispatcher 是否运行hermes dispatcher status# 如果未运行启动它hermes dispatcher start--daemon# 检查 kanban.db 是否可读写ls-la~/.hermes/kanban.dbQ4Delegate 子 Agent 无响应检查--max-delegate-workers是否设置过小确认模型 API 并发限制未触发查看轨迹文件排查具体错误hermes session_search delegateQ5如何重置全部数据重新开始# 停止所有服务hermes dispatcher stop hermescronstop# 备份后清除慎用mv~/.hermes ~/.hermes.bak hermes setup hermes kanban initQ6Windows WSL2 网络不通# 确认 WSL2 版本wsl--list--verbose# 如果是 WSL1升级到 WSL2wsl --set-version Ubuntu2# DNS 问题修复echonameserver 8.8.8.8|sudotee/etc/resolv.conf十二、命令速查表命令说明hermes setup初始化配置向导hermes model配置/切换 LLM 模型hermes chat开始对话hermes doctor健康检查hermes kanban init初始化看板数据库hermes kanban create创建看板任务hermes kanban list查看任务列表hermes kanban show id查看任务详情hermes kanban tail实时跟踪日志hermes kanban block id阻塞任务hermes kanban resolve id解除阻塞hermes kanban retry id重试失败任务hermes dispatcher start --daemon启动调度服务hermes dispatcher status查看调度状态hermes profile create name创建 Profilehermes -p profile skills install skill为 Profile 安装技能hermes -p profile config set model.model model为 Profile 配置模型hermes cron start启动定时调度hermes cron status查看调度状态hermes cron list查看定时任务hermes session_search keyword搜索会话历史hermes run --enable-delegate --max-delegate-workers N启动并行执行十三、选型建议推荐使用需要 AI 多角色协同完成复杂任务需要跨会话保持任务状态和记忆需要 AI 自主学习并沉淀技能对数据隐私有要求自托管 本地模型个人 / 团队长期使用的 AI 助手谨慎使用简单的问答/聊天场景过度设计杀鸡用牛刀对延迟极度敏感的实时交互场景对系统稳定性有极高要求的生产环境项目仍在快速迭代期无技术能力的终端用户需要一定的开发和运维能力十四、参考资源资源链接GitHub 仓库https://github.com/NousResearch/hermes-agent官方文档https://hermes-agent.nousresearch.com/docsWeb UI第三方https://github.com/EKKOLearnAI/hermes-web-ui社区技能市场ClawHub / LobeHub / GitHub写在最后Hermes Kanban 把看板方法论和AI Agent 编排玩出了新花样——用 SQLite 持久化保状态、用 Profile 隔离分角色、用 Delegate 并行提效率、用记忆系统让 AI 越用越懂你。项目虽年轻v0.13.0但架构设计扎实生态丰富MIT 协议无商业限制是当前 AI Agent 赛道最值得深入的开源项目之一。建议先在非关键业务场景试点验证积累经验后再扩大应用范围。先跑起来再跑得好。
hermes-kanban-安装与操作手册
发布时间：2026/5/22 1:08:29
一、Hermes Agent 是什么Hermes Agent 是 Nous Research 开源的自主进化 AI 智能体框架——不是那种问一答一的聊天机器人而是一个越用越聪明的长期数字伙伴。它能在每一次交互中积累经验、自动沉淀可复用技能、精准记住你的偏好用得越久协作效率越高。Kanban看板是 Hermes Agent v0.12.0 引入的多智能体任务编排系统基于 SQLite 持久化看板支持任务拆解、角色分派、并行执行与自动状态流转。简单说一张看板调度一队 AI并行干活状态不丢。解决的核心痛点痛点传统单 AgentHermes Kanban任务阻塞串行执行一步卡住全流程停滞并行 Delegate各子 Agent 独立运行状态丢失会话结束即忘无法断点续传SQLite 持久化断电重启不丢状态协同混乱多角色混在同一个上下文Profile 级隔离职责清晰不串台二、安装前准备2.1 系统要求项目最低要求推荐配置操作系统Linux / macOS / Windows (WSL2)Ubuntu 22.04 / macOS 13CPUx86_64 / ARM642 核内存256 MB2 GB存储100 MB1 GB含依赖和轨迹文件网络稳定联网10 Mbps前置依赖Git 2.0curl, bashWindows 用户注意原生 Windows 不支持必须通过 WSL2 运行且需要管理员权限开启 WSL2 功能。WSL1 也不行务必确认是 WSL2。2.2 准备 LLM API 密钥Hermes Agent 是模型无关的至少准备以下任意一个API 密钥模型提供商特色获取地址OpenRouter200 模型一键切换openrouter.aiAnthropic Claude推理能力顶级console.anthropic.comOpenAIGPT 系列platform.openai.com智谱 GLM国产模型中文友好open.bigmodel.cnKimi200 万 Token 上下文platform.moonshot.cnDeepSeek性价比之王platform.deepseek.comOllama 本地零成本隐私安全ollama.com国内用户建议Kimi 或智谱 GLM 连接稳定、性价比高也可通过自定义base_url接入国内中转服务无需代理即可调用 Claude 全系模型。2.3 国内网络加速建议如遇 GitHub / PyPI 下载缓慢建议提前配置镜像# 配置清华 PyPI 镜像pip configsetglobal.index-url https://pypi.tuna.tsinghua.edu.cn/simple三、安装方式详解Hermes Agent 提供 4 种安装方式最终功能完全一致区别仅在安装流程和运维方式。方式一curl 一键脚本官方推荐最快 2 分钟适合绝大多数用户脚本自动处理所有依赖Python、Node.js、ripgrep、ffmpeg 等。# Linux / macOS / WSL2 通用curl-fsSLhttps://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh|bash# 刷新 shell 配置让 hermes 命令生效source~/.zshrc# 或 source ~/.bashrc脚本自动完成的工作安装 uvPython 包管理器比 pip 快 10 倍安装 Python 3.11不污染系统 Python安装 Node.js 22、ripgrep、ffmpeg克隆仓库到~/.hermes/hermes-agent创建虚拟环境安装全部依赖启动配置向导方式二Docker 部署适合服务器 / 追求隔离# 基础运行dockerrun-d\-v~/.hermes:/root/.hermes\-p8080:8080\nousresearch/hermes-agent:latest# 带反向代理的完整部署生产推荐# 需搭配 docker-compose.yml Traefik方式三uv 手动安装适合开发者# 安装 uvcurl-LsSfhttps://astral.sh/uv/install.sh|shsource~/.bashrc# 克隆并安装gitclone https://github.com/NousResearch/hermes-agent.git ~/.hermes/hermes-agentcd~/.hermes/hermes-agent uv venvsource.venv/bin/activate uv pipinstall-e.# 初始化hermes setup方式四云服务器一键镜像阿里云、腾讯云、百度智能云均已提供 Hermes Agent 应用镜像选购轻量服务器后可直接启动免去安装步骤。四、初始化配置安装完成后执行初始化向导hermes setup向导会依次引导你完成4.1 配置 LLM 模型选择模型提供商 → 输入 API Key → 选择模型 → 确认上下文长度。# 或直接用命令配置hermes model# 选择 Custom endpoint 可接入任意 OpenAI 兼容 API# 输入 base_url 和 API Key 即可国内中转配置示例以 Kimi 为例# ~/.hermes/config.yamlmodel:provider:custombase_url:https://api.moonshot.cn/v1api_key:sk-your-key-heremodel:moonshot-v1-128k4.2 消息平台集成可选向导会询问是否集成消息平台。选择你需要的平台按提示配置 Bot Token 即可。也可以后续再配置。4.3 验证安装# 健康检查hermes doctor# 快速对话测试hermes chat# 输入任意内容确认模型正常响应4.4 关键目录结构~/.hermes/ ├── config.yaml # 全局配置 ├── .env # API 密钥敏感信息 ├── SOUL.md # Agent 人格定义 ├── kanban.db # Kanban 看板数据库SQLite ├── state.db # 记忆数据库SQLite FTS5 ├── sessions/ # 会话历史 ├── memories/ # 持久化记忆 ├── skills/ # 技能文件Markdown ├── cron/ # 定时任务配置 ├── trajectories/ # 执行轨迹JSONL └── profiles/ # 多 Profile 目录五、Kanban 看板操作指南这才是重头戏——Kanban 是 Hermes 实现一队 AI 并行干活的核心引擎。5.1 初始化看板# 步骤 1初始化看板数据库hermes kanban init# 步骤 2验证数据库生成ls-la~/.hermes/kanban.db# 确认文件存在且可读写# 步骤 3启动 Dispatcher 后台服务持续监听新任务hermes dispatcher start--daemon5.2 创建多角色 Agent Profile每个 Profile 代表一个具备特定技能的独立 AI 角色Kanban 依据任务类型自动唤醒对应 Profile。# 创建 researcher 角色hermes profile create researcher# 为 researcher 安装技能hermes-presearcher skillsinstallweb-search summarize# 创建 engineer 角色hermes profile create engineer# 为 engineer 安装技能hermes-pengineer skillsinstallcode-gen terminal-exec# 创建 reviewer 角色hermes profile create reviewer hermes-previewer skillsinstallcode-review security-audit# 创建 reporter 角色hermes profile create reporter hermes-preporter skillsinstallreport-gen chart-genProfile 隔离保证隔离维度说明配置隔离独立的 config.yaml、.env人格隔离独立的 SOUL.md记忆隔离独立的 state.db会话隔离独立的 sessions/技能隔离独立的 skills/网关隔离独立的 Gateway 进程 Bot Token定时任务隔离独立的 cron/5.3 为各 Profile 配置差异化模型不同角色可以使用不同模型实现成本与能力的最优匹配# researcher 用 Kimi长上下文适合文献阅读hermes-presearcher configsetmodel.model moonshot-v1-128k# engineer 用 Claude代码能力顶级hermes-pengineer configsetmodel.model anthropic/claude-sonnet-4# reporter 用 DeepSeek性价比高适合生成报告hermes-preporter configsetmodel.model deepseek/deepseek-chat5.4 创建看板任务# 方式一指定拆解数量和角色hermes kanban create\--title构建用户登录系统\--split5\--rolesresearcher,engineer,engineer,reviewer,reporter# 方式二直接指定子任务内容hermes kanban_create\--title处理新销售线索\--tasks解析表单,验证邮箱,录入CRM,发送欢迎邮件创建后Kanban 会自动将父任务拆解为子任务卡片为每个子任务绑定对应角色的 Profile将子任务状态设为pending写入~/.hermes/kanban.db5.5 查看看板状态# 查看所有任务概览hermes kanban list# 查看指定任务详情hermes kanban showtask-id# 实时跟踪执行日志流hermes kanbantail5.6 任务状态流转Kanban 任务遵循严格的状态机pending → assigned → running → completed ✓ → failed ✗可重试回 pending → blocked ⚠解除阻塞后回 pending状态含义触发条件pending待处理任务刚创建assigned已分派绑定 Agent Profilerunning执行中子 Agent 开始工作completed已完成执行成功failed已失败执行出错可重试blocked已阻塞依赖未满足需人工介入5.7 人工介入与阻塞处理# 阻塞某个任务暂停执行hermes kanban blocktask-id--reason等待第三方API审批# 解除阻塞恢复执行hermes kanban resolvetask-id# 重试失败任务hermes kanban retrytask-id六、Delegate 并行执行Delegate 机制是 Kanban 的加速引擎——主 Agent 动态生成子 Agent 实例在隔离终端会话中并行处理子任务。6.1 启用 Delegate# 启动带委托能力的 Agenthermes run --enable-delegate --max-delegate-workers46.2 在 SOUL.md 中配置并行策略# ~/.hermes/SOUL.md或对应 Profile 的 SOUL.md ## 并行策略 - 当任务复杂度 3 时使用 delegate_tool 并行处理 - 最多同时启动 4 个子 Agent - 每个子 Agent 独立终端、独立上下文 - 子 Agent 间通过 kanban.db 共享状态6.3 关键特性各子 Agent 拥有独立上下文、独立工具作用域、独立迭代预算子 Agent 间互不干扰零上下文开销支持通过 RPC 调用工具子 Agent 完成后自动更新看板状态七、Cron 定时调度将重复性高、时效性强的任务交给内置 Cron 调度器实现无人值守。7.1 配置定时任务# ~/.hermes/crontab.yaml-schedule:0 */2 * * *# 每 2 小时执行一次job:kanban_sync --status pending-schedule:0 9 * * 1-5# 工作日每天早上 9 点job:生成日报并推送至飞书群7.2 调度器操作# 启动调度服务hermescronstart# 查看调度状态hermescronstatus# 输出: Active: true, Next fire: [timestamp]# 查看所有定时任务hermescronlist7.3 两种触发模式模式说明适用场景定时触发基于 Cron 表达式定期巡检、日报生成条件触发基于外部事件文件变更触发、Git Push 触发、API 响应触发八、记忆与轨迹系统8.1 持久化记忆Hermes 的记忆不是简单的对话历史而是一个三层记忆系统层次说明存储会话记忆当前对话上下文内存持久记忆跨会话的重要事实和经验SQLite FTS5技能记忆成功经验的提炼Markdown 格式skills/ 目录记忆系统的四大能力自动评估智能判断什么值得记、什么该忘主动召回适时主动回忆相关经验技能沉淀完成复杂任务后自动提炼为技能文件用户建模基于 Honcho 的辩证法用户建模深度理解用户偏好8.2 轨迹保存与回溯所有工作流执行过程以 JSONL 格式完整记录# 轨迹文件路径~/.hermes/trajectories/*.jsonl# 会话搜索hermes session_searchfailed at kanban_complete# 支持任意节点状态还原与问题复现轨迹记录内容涵盖系统提示、用户输入、工具调用、子 Agent 输出、错误堆栈。九、自定义 SOUL.md 人格SOUL.md 是 Hermes Agent 的灵魂文件定义了 Agent 的身份特征与行为边界。# ~/.hermes/SOUL.md ## 身份 你是一个资深数据工程师专注于大数据平台开发和数据治理。 ## 行为准则 - 编写代码前先分析需求输出设计方案 - 代码必须包含错误处理和日志 - 优先使用 SQL 解决数据问题 - 遇到不确定的技术选型先调研再决策 ## 并行策略 - 当任务复杂度 3 时使用 delegate_tool 并行处理 - 最多同时启动 4 个子 Agent ## 输出偏好 - 使用 Markdown 格式输出 - 代码块标注语言类型 - 关键步骤添加中文注释每个 Profile 可以拥有独立的 SOUL.md确保不同角色专注各自领域。十、实战案例多角色协同开发以构建用户登录系统为例完整演示 Kanban 工作流。步骤 1初始化hermes kanban init hermes dispatcher start--daemon步骤 2创建角色hermes profile create researcher hermes profile create engineer hermes profile create reviewer hermes profile create reporter# 安装技能hermes-presearcher skillsinstallweb-search summarize hermes-pengineer skillsinstallcode-gen terminal-exec hermes-previewer skillsinstallcode-review security-audit hermes-preporter skillsinstallreport-gen chart-gen步骤 3创建看板任务hermes kanban create\--title构建用户登录系统\--split5\--rolesresearcher,engineer,engineer,reviewer,reporterKanban 自动拆解为 5 个子任务子任务角色内容#1researcher调研最佳实践输出 UI 设计稿#2engineer后端 API 实现认证、鉴权#3engineer前端组件开发登录页、注册页#4reviewer安全审查SQL 注入、XSS、CSRF#5reporter生成测试报告步骤 4并行执行hermes run --enable-delegate --max-delegate-workers4执行流程researcher → engineer(后端) → engineer(前端) → reviewer → reporter各子 Agent 在隔离环境中并行工作状态实时写入kanban.db。步骤 5监控与干预# 实时查看执行日志hermes kanbantail# 如果某个子任务卡住hermes kanban blocksub-task-id--reason等待设计稿确认hermes kanban resolvesub-task-id# 查看最终结果hermes kanban showparent-task-id十一、常见问题与排障Q1安装脚本执行失败# 检查 Git 是否安装git--version# 检查网络连通性curl-Ihttps://github.com# 国内用户配置代理或使用镜像exportHTTPS_PROXYhttp://your-proxy:portQ2模型调用 401 / 403 错误检查 API Key 是否正确hermes config get model.api_key检查 API 余额是否充足确认base_url配置正确国内中转地址不要带/v1后缀除非接口要求Q3Kanban 任务一直卡在 pending# 确认 Dispatcher 是否运行hermes dispatcher status# 如果未运行启动它hermes dispatcher start--daemon# 检查 kanban.db 是否可读写ls-la~/.hermes/kanban.dbQ4Delegate 子 Agent 无响应检查--max-delegate-workers是否设置过小确认模型 API 并发限制未触发查看轨迹文件排查具体错误hermes session_search delegateQ5如何重置全部数据重新开始# 停止所有服务hermes dispatcher stop hermescronstop# 备份后清除慎用mv~/.hermes ~/.hermes.bak hermes setup hermes kanban initQ6Windows WSL2 网络不通# 确认 WSL2 版本wsl--list--verbose# 如果是 WSL1升级到 WSL2wsl --set-version Ubuntu2# DNS 问题修复echonameserver 8.8.8.8|sudotee/etc/resolv.conf十二、命令速查表命令说明hermes setup初始化配置向导hermes model配置/切换 LLM 模型hermes chat开始对话hermes doctor健康检查hermes kanban init初始化看板数据库hermes kanban create创建看板任务hermes kanban list查看任务列表hermes kanban show id查看任务详情hermes kanban tail实时跟踪日志hermes kanban block id阻塞任务hermes kanban resolve id解除阻塞hermes kanban retry id重试失败任务hermes dispatcher start --daemon启动调度服务hermes dispatcher status查看调度状态hermes profile create name创建 Profilehermes -p profile skills install skill为 Profile 安装技能hermes -p profile config set model.model model为 Profile 配置模型hermes cron start启动定时调度hermes cron status查看调度状态hermes cron list查看定时任务hermes session_search keyword搜索会话历史hermes run --enable-delegate --max-delegate-workers N启动并行执行十三、选型建议推荐使用需要 AI 多角色协同完成复杂任务需要跨会话保持任务状态和记忆需要 AI 自主学习并沉淀技能对数据隐私有要求自托管 本地模型个人 / 团队长期使用的 AI 助手谨慎使用简单的问答/聊天场景过度设计杀鸡用牛刀对延迟极度敏感的实时交互场景对系统稳定性有极高要求的生产环境项目仍在快速迭代期无技术能力的终端用户需要一定的开发和运维能力十四、参考资源资源链接GitHub 仓库https://github.com/NousResearch/hermes-agent官方文档https://hermes-agent.nousresearch.com/docsWeb UI第三方https://github.com/EKKOLearnAI/hermes-web-ui社区技能市场ClawHub / LobeHub / GitHub写在最后Hermes Kanban 把看板方法论和AI Agent 编排玩出了新花样——用 SQLite 持久化保状态、用 Profile 隔离分角色、用 Delegate 并行提效率、用记忆系统让 AI 越用越懂你。项目虽年轻v0.13.0但架构设计扎实生态丰富MIT 协议无商业限制是当前 AI Agent 赛道最值得深入的开源项目之一。建议先在非关键业务场景试点验证积累经验后再扩大应用范围。先跑起来再跑得好。
相关文章
创业者必看：别跟风做 “伪交互数字人”，能落地才是产品核心
引言 深耕 AI 交互领域多年，服务大量创业团队后发现：不少创业者盲目入局数字人赛道，投入高额成本打造的产品，虽具备基础交互能力，但多为云端延迟式被动交互，难以适配真实商用场景，无法规模化变…
2026年HR推荐的10个专业简历模板网站，从模板到写法
2026年HR推荐的10个专业简历模板网站，从模板到写法写一份让HR眼前一亮的简历，是很多求职者遇到的难题。模板选什么风格、内容怎么写才专业、怎么排版才不会被系统筛掉——这些问题常常让人头疼。这篇文章整理了10个HR推荐的专业简历模板网站，…
千问 LeetCode 2543. 判断一个点是否可以到达 C语言实现
这道题的核心是从终点反向推导，利用最大公约数（GCD） 的性质来判断。C语言实现与Java思路完全一致，只是语法略有不同。核心结论从 (targetX, targetY) 能反向到达 (1, 1) 的充要条件是： gcd(targetX, targetY) 是 2 的幂…
实战代码审计：从一个逻辑缺陷到前台无授权 RCE 的奇妙之旅
声明： 本文记录的是一次授权/合规的源码审计过程。为保护厂商安全，本文已对目标 CMS 名称、敏感目录及变量名进行打码或化名处理。本文仅供安全技术交流与学习，请勿用于非法用途。在最近的一次日常代码审计中，我看上了一款小众但功…
【FlinkSQL笔记】（三）Flink SQL 核心重难点（窗口函数、水印）
一、窗口函数 流式数据无限无边界，例如想要统计每5分钟、每1小时的数据，必须用窗口函数，这是Flink SQL和普通SQL最大的区别之一。 1、 滚动窗口 TUMBLE（最常用） 特点：无重叠、无间隔、固定时长，…
WenShape文生3D模型：基于One-2-3-45框架的开源3D资产生成工具项目深度解析
WenShape文生3D模型：基于One-2-3-45框架的开源3D资产生成工具项目深度解析 项目简介 WenShape 是一个基于 One-2-3-45 技术框架开发的开源“文生3D”模型生成系统，旨在通过文本指令快速、高效地生成高质量3D模型资产。该项目由 unitagain 维护࿰…
万店精灵功能全景解读：从店铺管理到批量上货，一篇看懂
一、店铺管理：统一掌控多http://www.wandianjingling.com/q/r/FV0233平台店铺1. 店铺列表主页面你可以按平台（抖店、拼多多、淘宝等）快速筛选已绑定的店铺，每个标签旁都清晰标注了店铺数量。列表中每一项都包含：店铺名…
地球的定位密码——经纬度
📌 什么是经纬度？ 简单来说，经纬度就是给地球上的每一个点发一个“身份证”。它由经度和纬度组成：纬度从赤道（0）向南北两极（90N/S）度量，决定南北方向的位置；…
3个场景+4大优势：自动鼠标移动器让你的Mac永远保持活跃
3个场景4大优势：自动鼠标移动器让你的Mac永远保持活跃 【免费下载链接】automatic-mouse-mover a minimalistic go library/app to keep your mac active and alive 项目地址: https://gitcode.com/gh_mirrors/au/automatic-mouse-mover 你是否曾因系统自动休…
单日大涨4.52%！华泰柏瑞中韩半导体ETF（513310.SH）上演“高热度”行情，溢价率风险引关注
5月21日，华泰柏瑞中韩半导体ETF（513310.SH）延续强势表现，当日收盘价报5.625元，涨幅达4.52%，盘中交投异常活跃，换手率109.80%，量比为1.32，市场资金交易热情高涨。然而&…
11. 架构：前端工程化与状态管理实战
写在前面： 如果说后端 MVT 引擎是 GIS 系统的“心脏”，那么前端就是它的“大脑”和“面孔”。在现代 WebGIS 开发中，如何优雅地管理复杂的图层状态、如何处理海量瓦片的渲染逻辑，是决定项目成败的关键。 今天，我们将深入 light-mvt-server 的前端核心，看看如何利用 Vite …
淘金币自动化脚本终极指南：10分钟搞定淘宝日常任务，每天为你节省20分钟
淘金币自动化脚本终极指南：10分钟搞定淘宝日常任务，每天为你节省20分钟 【免费下载链接】taojinbi 淘宝淘金币自动执行脚本，包含蚂蚁森林收取能量，芭芭农场全任务，解放你的双手 项目地址: https://gitcode.com/gh_mi…
【实用小程序】超轻量级文件上传下载中心 (File Download Server)
站内源码及jar包下载 一、项目概述 文件下载中心一个基于 Java 内置 HTTP 服务器（com.sun.net.httpserver）构建的轻量级文件管理服务。它零第三方依赖，单 JAR 包即可运行，适合在内网环境或临时场景中快速搭建文件共享站点。 你的团队需要临时共享一批日志文件或交付物，…
py每日spider案例之某website之xin东方选课搜索接口(难度一般 扣取代码即可)
加密位置: 逆向接口参数: 逆向接口: const g = globalThis; g.window = g; g.self = g; g.location = {<
终极轻量级Android文本编辑器Markor：多格式笔记应用完全指南
终极轻量级Android文本编辑器Markor：多格式笔记应用完全指南 【免费下载链接】markor Text editor - Notes & ToDo (for Android) - Markdown, todo.txt, plaintext, math, .. 项目地址: https://gitcode.com/gh_mirrors/ma/markor 在移动设备上寻找一款…
MPC-BE：基于DirectShow架构的专业级开源媒体播放解决方案
MPC-BE：基于DirectShow架构的专业级开源媒体播放解决方案 【免费下载链接】MPC-BE MPC-BE – универсальный проигрыватель аудио и видеофайлов для операционной системы Windows. 项目地址:…
如何快速计算3D模型体积和重量：STL-Volume-Model-Calculator终极指南
如何快速计算3D模型体积和重量：STL-Volume-Model-Calculator终极指南 【免费下载链接】STL-Volume-Model-Calculator STL Volume Model Calculator Python 项目地址: https://gitcode.com/gh_mirrors/st/STL-Volume-Model-Calculator 你是否曾经为3D打印项目…
通过Taotoken CLI工具一键配置团队开发环境与模型密钥
通过Taotoken CLI工具一键配置团队开发环境与模型密钥 1. CLI工具安装与基本使用 Taotoken提供的CLI工具可通过npm全局安装或直接使用npx运行。对于需要频繁使用CLI的团队，推荐全局安装： npm install -g taotoken/taotoken对于临时使用或项目级配置&a…