本文为您汇总了安装、使用 Hermes 相关的常见问题及解决方案。 |问题分类 |问题 | |---|---| |安装 Hermes Agent 插件 |[ArkClaw 升级失败怎么处理？](https://www.volcengine.com/docs/87732/2358943#DcL3Kixj) | |^^|[安装 Hermes Agent 插件时报错“可用空间不足 7GB”，如何解决?](https://www.volcengine.com/docs/87732/2358943#8Z0x2KRh) | |^^|[Hermes Agent 插件安装失败如何解决？](https://www.volcengine.com/docs/87732/2358943#kLdhduml) | |^^|[Hermes Agent 插件安装过程中报错“plugin already exists”如何解决？](https://www.volcengine.com/docs/87732/2358943#qOI3A1YN) | |^^|[安装 Hermes Agent 插件时，ArkClaw 重启失败如何解决？](https://www.volcengine.com/docs/87732/2358943#v1lLvfKi) | |^^|[如何查看 Hermes Agent 插件的安装日志？](https://www.volcengine.com/docs/87732/2358943#avyCegDc) | |^^|[Hermes Agent 插件安装完成后，其安装文件会自动删除吗？](https://www.volcengine.com/docs/87732/2358943#gyxp6DkW) | |^^|[如何为 Hermes Agent 配置第三方模型？](https://www.volcengine.com/docs/87732/2358943#MbSvMEfi) | |使用 Hermes Agent |[开启/关闭 Hermes Agent 时报错“开启/关闭 Hermes 失败”、“读取配置文件失败”或“解析配置文件失败”如何解决？](https://www.volcengine.com/docs/87732/2358943#r0g2dejP) | |^^|[Hermes Agent 生成的数据在哪里？](https://www.volcengine.com/docs/87732/2358943#UstZAXzH) | |^^|[删除 Hermes Agent 容器后，其历史生成的数据还在吗？](https://www.volcengine.com/docs/87732/2358943#0lbPKxm7) | |^^|[如何卸载 Hermes Agent 插件？](https://www.volcengine.com/docs/87732/2358943#vKpCetXN) | |^^|[可以通过 ArkClaw 集成的渠道（例如飞书、微信）使用 Hermes Agent 吗？](https://www.volcengine.com/docs/87732/2358943#TPpxsu68) | |^^|[如何读取 Hermes 生成的文件？](https://www.volcengine.com/docs/87732/2358943#f4kcCsGc) | |^^|[已开启 Hermes 开关，任务为何仍由 ArkClaw 处理？](https://www.volcengine.com/docs/87732/2358943#6LH9RvYe) | |^^|[已关闭 Hermes 开关，任务为何仍由 Hermes 处理？](https://www.volcengine.com/docs/87732/2358943#IURskC9F) | |^^|[提示“OpenClaw 配置文件不是有效 JSON:/root/.openclaw/openclaw.json”如何解决？](https://www.volcengine.com/docs/87732/2358943#JJcEvl0Z) | ## 安装 Hermes Agent 插件 ### ArkClaw 升级失败怎么处理？ ArkClaw 需升级到`ark-26.4.1` 及之后的版本才支持安装 Hermes Agent 插件，升级过程中可能由于兼容性、网络波动等问题导致升级失败。若升级失败，ArkClaw （包含部分已升级的系统/组件）将自动回滚至升级前的版本。您可根据 [升级 ArkClaw 系统/组件版本](https://www.volcengine.com/docs/87732/2275231) 指引再次尝试升级，也可通过 [问题反馈](https://www.volcengine.com/docs/87732/2275227) 获取技术支持。 ### 安装 Hermes Agent 插件时报错“可用空间不足 7GB”，如何解决? 安装 Hermes Agent 需要**不低于 7GB** 的存储空间。您可以与 ArkClaw 对话，安排其帮您梳理安全、可删除的缓存和临时文件数据，在您确认后进行删除，释放被占用的存储空间。 :::warning 删除文件属于高危操作，强烈建议您在 [手动备份](https://www.volcengine.com/docs/87732/2275232#OVv5wQ5n) ArkClaw 数据且充分了解待删除文件作用后，再进行删除操作。 ::: 1. 您可以在 ArkClaw 详情页“状态与用量”页签，查看当前 ArkClaw 可用存储空间。[了解更多](https://www.volcengine.com/docs/87732/2341045)。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_f79472621c17a020a20c55095b475270.png =417x) 2. 让 ArkClaw 帮您找出可安全删除的 npm 下载缓存并进行清理。 :::tip npm 缓存是本地存储的安装包副本。清理该缓存属于安全操作，通常可释放 3~5 GB 的存储空间，唯一的影响是下次安装同名依赖时需重新通过网络下载。 ::: 1. 检测并评估可安全删除的文件。 **Prompt** **：** 帮我检测下系统中 npm 缓存目录（如 ~/.npm），列举可以安全删除的 npm 下载缓存文件、大小、作用和删除风险。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_99607dc520aefb2342b5757770fa013e.png =565x) 2. 清理文件。 **Prompt：** 帮我安全清理上述 npm 下载缓存文件。清理完成后，重新检查并告诉我实际释放了多少存储空间。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_6503ef33f316f6b9846ddb5980dfa5f9.png =565x) 3. 若清理 npm 缓存后可用的存储空间依然不足 7 GB，您可以考虑清理未使用的 ArkClaw 插件（Plugin）。 :::warning 删除 ArkClaw 插件属于**高风险**操作。由于 ArkClaw 许多核心功能深度依赖特定内置插件，误删插件会导致对应功能不可用。强烈建议您仅在存储空间极度匮乏时才进行此操作。 ::: 1. 检测并评估可安全删除的文件。 **Prompt** **：** 扫描并列出当前 ArkClaw 已安装的 Plugin 列表及其占用的磁盘大小，并简要说明用途及删除风险。优先推荐删除老旧的备份目录、未使用的消息渠道插件。【严格安全约束】：lancedb、apmplus、arkclaw\-mode\-switch、ai\-assistant\-security、env\-logger、skill\-switch 等属于核心依赖组件，绝对禁止删除！基于上述约束，帮我筛并输出一份“建议安全删除清单”。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_5f2cc291c53302b91fb528f08299396e.png =716x) 2. 清理文件。 **Prompt：** 我确认不再需要使用 ==XX== 插件。请帮我安全卸载并彻底删除该插件的目录及其残留缓存。请勿触碰任何核心依赖，操作完成后告诉我实际释放了多少存储空间。 :::tip 请将 ==XX== 替换为您希望删除的插件名，例如 `qqbot`。 ::: ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_e672a59048c2e7d95e320a6d048a9c75.png =718x) ### Hermes Agent 插件安装失败如何解决？ Hermes Agent 插件在安装过程中可能因兼容性问题导致安装失败。您可以： 1. 根据 [自动修复 ArkClaw](https://www.volcengine.com/docs/87732/2270355?) 指引进行修复，再尝试安装 Hermes Agent 插件。 2. 若插件依旧安装失败，可通过 [问题反馈](https://www.volcengine.com/docs/87732/2275227) 获取技术支持。 ### Hermes Agent 插件安装过程中报错“plugin already exists”如何解决？该问题是由于您的 ArkClaw 中已安装过 Hermes Agent 插件导致的，您可以： 1. [打开 ArkClaw 终端](https://www.volcengine.com/docs/87732/2270411)。 2. 执行如下命令，下载并运行 Hermes Agent 插件卸载脚本。 ```Bash REGION=$(curl --connect-timeout 5 --max-time 10 -s "http://100.96.0.96/latest/region_id"); curl -fsSL "https://scarif-${REGION}.tos-${REGION}.ivolces.com/arkclaw/hermes/hermes-uninstall.sh" -o hermes-uninstall.sh bash hermes-uninstall.sh --yes ``` 回显如下所示时，表示已成功卸载 Hermes Agent 插件并删除其缓存、历史数据。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_2a4aa14fbf44688deab211d56d53818e.png =504x) 3. 再次安装 Hermes Agent 插件。 ### 安装 Hermes Agent 插件时，ArkClaw 重启失败如何解决？ Hermes Agent 插件安装完成后，需要重启 ArkClaw 网关使其生效，重启过程可能由于各类兼容性问题导致失败。此时，您可以手动 [重启 ArkClaw](https://www.volcengine.com/docs/87732/2266924)，重启完成后，Hermes Agent 插件将自动生效。 ### 如何查看 Hermes Agent 插件的安装日志？ Hermes Agent 插件安装日志存放在 `/var/log/hermes-agent/` 目录下，您可以通过该日志文件查看其安装过程及出现的问题详情。 ```mixin-react return ( ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_930915d80ff5e23baf0fcc8c38545fc6.png =390x) 2. 向 ArkClaw 发送 Prompt，查看相关日志。例如：帮我查看/var/log目录下Hermes 最新安装日志。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_904fa09ace679fdafe5f999e27c9ba0a.png =398x) `}> ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_f722870e373887e3fc9d2da17d3dd27e.png =216x) 2. 执行如下命令，查看最新的 200 条安装日志信息。 \`\`\`Bash sudo tail -n 200 "$(ls -1t /var/log/hermes-agent/upgrade-*.log | head -n 1)" sudo docker logs --tail 200 hermes-agent \`\`\` ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_84eae5d821c8c692bb80a42cf0a9ee44.png =500x) `}>); ``` ### Hermes Agent 插件安装完成后，其安装文件会自动删除吗？ Hermes Agent 插件安装文件不会自动删除，该文件存放于 `/var/cache/hermes-agent` 目录下。您可以按需自行删除： ```mixin-react return ( ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_930915d80ff5e23baf0fcc8c38545fc6.png =390x) 2. 向 ArkClaw 发送 Prompt，删除相关文件。例如：删除 /var/cache/hermes\\-agent 目录及其中的所有文件。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_e4f78b44db2b47942c775969a1e2db86.png =391x) `}> ); ``` ### 如何为 Hermes Agent 配置第三方模型？ Hermes 功能暂仅支持与 ArkClaw 使用同一模型配置，若您的 ArkClaw 使用 [自定制配置](https://www.volcengine.com/docs/87732/2270242) 的第三方模型提供推理服务，您需要通过脚本手动安装 Hermes Agent 插件并指定第三方模型信息。 1. [打开 ArkClaw 终端](https://www.volcengine.com/docs/87732/2270411)。 2. 执行如下命令，下载插件安装脚本。 ```Bash REGION=$(curl --connect-timeout 5 --max-time 10 -s "http://100.96.0.96/latest/region_id"); curl -fsSL "https://scarif-${REGION}.tos-${REGION}.ivolces.com/arkclaw/hermes/hermes-install.sh" -o hermes-install.sh ``` 3. 执行如下命令，通过脚本手动安装 Hermes Agent 插件，并指定第三方模型信息。 ```Bash bash hermes-install.sh --api-key --provider --model --base-url ``` **参数说明：** |参数 |说明 | |---|---| |\-\-api\-key |用于调用和访问目标模型服务的鉴权密钥（API Key），请将``替换为实际值，例如：`sk-j08hbgg5h3****”`。|\ | |:::warning|\ | |API Key 将用于配置 ArkClaw 的底层调用服务的重要凭证，具有该模型的完整访问权限，请妥善保管，谨防泄露。若发生泄露，可能会导致您的模型调用额度被盗刷或引发其他安全风险。|\ | ||\ | |:::| |\-\-api\-key |目标模型服务提供商名称，请将``替换为实际值，例如：`glm`。 | |\-\-model |目标大模型名称，请将``替换为实际值，例如`DeepSeek-V3.2`。 | |\-\-base\-url |用于调用目标模型服务的 API 接口调用地址（Base URL），请将``替换为实际值，例如：`https://api.deepseek.com`。 | 回显如下所示时，表示已成功安装 Hermes Agent 插件并配置第三方模型，请关闭终端页面。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_8a4afac82e2eea489639fab5ec35ba9a.png =567x) 4. 安装成功后，系统将自动开启 Hermes Agent 功能。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_376909ce9dbf5ceb05d141247cf02798.png =559x) ## 使用 Hermes Agent ### 开启/关闭 Hermes Agent 时报错“开启/关闭 Hermes 失败”、“读取配置文件失败”或“解析配置文件失败”如何解决？该问题通常是由于您手动修改了 ArkClaw 的配置文件，出现兼容性问题导致的。您可以根据 [自动修复 ArkClaw](https://www.volcengine.com/docs/87732/2270355?) 指引进行修复，再尝试开启/关闭 Hermes Agent。 ### Hermes Agent 生成的数据在哪里？ Hermes Agent 执行任务后输出的结果、沉淀的 Skill 等数据默认存放在 `/opt/hermes-data` 目录下。 ### 删除 Hermes Agent 容器后，其历史生成的数据还在吗？ Hermes Agent 执行任务后输出的结果、沉淀的 Skill 等数据默认存放在 `/opt/hermes-data` 目录下，删除 Hermes Agent Docker 容器不会删除其中的数据。 ### 如何卸载 Hermes Agent 插件？ 1. Hermes Agent 插件。 1. [打开 ArkClaw 终端](https://www.volcengine.com/docs/87732/2270411)。 2. 执行如下命令，卸载 Hermes Agent 插件并删除其缓存、历史数据。 ```Bash REGION=$(curl --connect-timeout 5 --max-time 10 -s "http://100.96.0.96/latest/region_id"); curl -fsSL "https://scarif-${REGION}.tos-${REGION}.ivolces.com/arkclaw/hermes/hermes-uninstall.sh" -o hermes-uninstall.sh bash hermes-uninstall.sh --yes ``` 回显如下所示时，表示已成功卸载 Hermes Agent 插件并删除其缓存、历史数据。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_2a4aa14fbf44688deab211d56d53818e.png =576x) 2. 确认已完整卸载 Hermes Agent 插件。 ```mixin-react return ( ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_930915d80ff5e23baf0fcc8c38545fc6.png =390x) 2. 向 ArkClaw 发送 Prompt，检查相关文档是否还有残留。例如：帮我检查 Hermes 容器、缓存、数据目录还在不在。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_c2f4afbb591f69da5afe353d3a60aee3.png =397x) `}> ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_fcb9c76472e34f6797c9c51a5e2b2930.png =488x) `}>); ``` ### 可以通过 ArkClaw 集成的渠道（例如飞书、微信）使用 Hermes Agent 吗？可以，您在 ArkClaw 控制台开启 Hermes 功能后，可在 ArkClaw 集成的渠道（例如飞书、微信）发送消息时添加“将任务派发给Hermes执行”即可。 **Prompt 示例：** 将任务派发给 Hermes 执行：请在终端使用 bash/shell 命令，随机生成一个包含 100 个字符的英文字符串，然后统计并输出其中小写字母 a 出现的次数。 ### 如何读取 Hermes 生成的文件 Hermes目前在docker容器内运行，若需进行文件透传，可使Hermes将文件生成或移动至 /opt/data 目录，之后在终端查看 /opt/data\-hermes 即可找到文件。 ### 怎么确保 ArkClaw 把原始 Prompt 直接发给 Hermes Agent？若你希望 ArkClaw 完全不改动您的 Prompt 信息，将其完整的发送给 Hermes Agent 执行，可在 Prompt 中明确告知 ArkClaw **不要添加额外指令**。 **Prompt 示例：** 把这个命令发给 Hermes（不要添加任何额外的指令）：请在终端使用 bash/shell 命令，随机生成一个包含 100 个字符的英文字符串，然后统计并输出其中小写字母 a 出现的次数。 ### 已开启 Hermes 开关，**任务为何仍由** ArkClaw 处理？部分场景下，可能会因为对话中上下文内容，引发 ArkClaw 路由误判，未将任务正确路由至 Hermes。您只需在对话中发送：**让 Hermes 执行本条指令：<您的具体指令内容\>** ，即可纠正。 ### **已关闭 Hermes 开关，任务为何仍由 Hermes 处理？** 部分场景下，可能会因为对话中上下文内容，引发 ArkClaw 路由误判，未将任务正确路由至 ArkClaw。您只需在对话中发送：**由你执行该指令，无需派发给 Hermes**，即可纠正。 ### 提示“OpenClaw 配置文件不是有效 JSON:/root/.openclaw/openclaw.json”如何解决？ * **问题示例：** ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_a8a7f9b71a99163e08bf74c444fc58c0.png =388x) * **解决方案：** 1. [自动修复 ArkClaw](https://www.volcengine.com/docs/87732/2270355)。 2. 单击“Hermes \> 安装插件”按钮，[重新安装 Hermes Agent 插件](https://www.volcengine.com/docs/87732/2356398#AftdJI5y)。