ArkClaw 企业版
ArkClaw 企业版
文档指南
请输入
- 文档首页
ArkClaw 企业版ArkClaw 企业版员工使用ArkClawArkClaw快捷功能Hermes AgentHermes Agent 常见问题
复制全文
下载 pdfHermes Agent 常见问题
文档反馈
问问助手本文为您汇总了安装、使用 Hermes 相关的常见问题及解决方案。
安装 Hermes Agent 插件
ArkClaw 升级失败怎么处理？
ArkClaw 需升级到ark-1.2.3 及之后的版本才支持安装 Hermes Agent 插件，升级过程中可能由于兼容性、网络波动等问题导致升级失败。若升级失败，ArkClaw （包含部分已升级的系统/组件）将自动回滚至升级前的版本。您可根据 升级 ArkClaw 系统/组件版本 指引再次尝试升级，也可通过 问题反馈 获取技术支持。
安装 Hermes Agent 插件时报错“可用空间不足 7GB”，如何解决?
安装 Hermes Agent 需要不低于 7GB 的存储空间。您可以与 ArkClaw 对话，安排其帮您梳理安全、可删除的缓存和临时文件数据，在您确认后进行删除，释放被占用的存储空间。
注意
- 您可以在 ArkClaw 详情页“状态与用量”页签，查看当前 ArkClaw 可用存储空间。
- 让 ArkClaw 帮您找出可安全删除的 npm 下载缓存并进行清理。
说明
npm 缓存是本地存储的安装包副本。清理该缓存属于安全操作，通常可释放 3~5 GB 的存储空间，唯一的影响是下次安装同名依赖时需重新通过网络下载。
- 检测并评估可安全删除的文件。
- Prompt：帮我检测下系统中 npm 缓存目录（如 ~/.npm），列举可以安全删除的 npm 下载缓存文件、大小、作用和删除风险。
-
- 清理文件。
- Prompt：帮我安全清理上述 npm 下载缓存文件。清理完成后，重新检查并告诉我实际释放了多少存储空间。
-
- 若清理 npm 缓存后可用的存储空间依然不足 7 GB，您可以考虑清理未使用的 ArkClaw 插件（Plugin）。
注意
删除 ArkClaw 插件属于高风险操作。由于 ArkClaw 许多核心功能深度依赖特定内置插件，误删插件会导致对应功能不可用。强烈建议您仅在存储空间极度匮乏时才进行此操作。
- 检测并评估可安全删除的文件。
- Prompt：扫描并列出当前 ArkClaw 已安装的 Plugin 列表及其占用的磁盘大小，并简要说明用途及删除风险。优先推荐删除老旧的备份目录、未使用的消息渠道插件。【严格安全约束】：lancedb、apmplus、arkclaw-mode-switch、ai-assistant-security、env-logger、skill-switch 等属于核心依赖组件，绝对禁止删除！基于上述约束，帮我筛并输出一份“建议安全删除清单”。
-
- 清理文件。
- Prompt：我确认不再需要使用 XX 插件。请帮我安全卸载并彻底删除该插件的目录及其残留缓存。请勿触碰任何核心依赖，操作完成后告诉我实际释放了多少存储空间。
说明
请将 XX 替换为您希望删除的插件名，例如 qqbot。
-
Hermes Agent 插件安装失败如何解决？
Hermes Agent 插件在安装过程中可能因兼容性问题导致安装失败。 您可以：
- 根据 自动修复 ArkClaw 指引进行修复，再尝试安装 Hermes Agent 插件。
- 若插件依旧安装失败，可通过 问题反馈 获取技术支持。
Hermes Agent 插件安装过程中报错“plugin already exists”如何解决？
该问题是由于您的 ArkClaw 中已安装过 Hermes Agent 插件导致的，您可以：
- 执行如下命令，下载并运行 Hermes Agent 插件卸载脚本。
- 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.shbash hermes-uninstall.sh --yes
- 回显如下所示时，表示已成功卸载 Hermes Agent 插件并删除其缓存、历史数据。
-
- 再次安装 Hermes Agent 插件。
安装 Hermes Agent 插件时，ArkClaw 重启失败如何解决？
Hermes Agent 插件安装完成后，需要重启 ArkClaw 网关使其生效，重启过程可能由于各类兼容性问题导致失败。此时，您可以手动 重启 ArkClaw，重启完成后，Hermes Agent 插件将自动生效。
如何查看 Hermes Agent 插件的安装日志？
Hermes Agent 插件安装日志存放在 /var/log/hermes-agent/ 目录下，您可以通过该日志文件查看其安装过程及出现的问题详情。
- 关闭 Hermes。
-
- 向 ArkClaw 发送 Prompt，查看相关日志。例如：帮我查看/var/log目录下Hermes 最新安装日志。
-
- 执行如下命令，查看最新的 200 条安装日志信息。
- sudo tail -n 200 "$(ls -1t /var/log/hermes-agent/upgrade-*.log | head -n 1)"sudo docker logs --tail 200 hermes-agent
-
Hermes Agent 插件安装完成后，其安装文件会自动删除吗？
Hermes Agent 插件安装文件不会自动删除，该文件存放于 /var/cache/hermes-agent 目录下。您可以按需自行删除：
- 关闭 Hermes。
-
- 向 ArkClaw 发送 Prompt，删除相关文件。例如：删除 /var/cache/hermes-agent 目录及其中的所有文件。
-
使用 Hermes Agent
开启/关闭 Hermes Agent 时报错“开启/关闭 Hermes 失败”、“读取配置文件失败”或“解析配置文件失败”如何解决？
Hermes Agent 生成的数据在哪里？
Hermes Agent 执行任务后输出的结果、沉淀的 Skill 等数据默认存放在 /opt/hermes-data 目录下。
删除 Hermes Agent 容器后，其历史生成的数据还在吗？
Hermes Agent 执行任务后输出的结果、沉淀的 Skill 等数据默认存放在 /opt/hermes-data 目录下，删除 Hermes Agent Docker 容器不会删除其中的数据。
如何卸载 Hermes Agent 插件？
- Hermes Agent 插件。
- 执行如下命令，卸载 Hermes Agent 插件并删除其缓存、历史数据。
- 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.shbash hermes-uninstall.sh --yes
- 回显如下所示时，表示已成功卸载 Hermes Agent 插件并删除其缓存、历史数据。
-
- 确认已完整卸载 Hermes Agent 插件。
-
- 关闭 Hermes。
-
- 向 ArkClaw 发送 Prompt，检查相关文档是否还有残留。例如：帮我检查 Hermes 容器、缓存、数据目录还在不在。
-
执行如下命令，查看 Hermes 容器、缓存及数据目录是否还存在。docker ps -a | grep hermes-agentdocker images | grep hermes-agentls -la /root/.openclaw/extensions | grep openclaw-plugin-hermes若所有命令均无回显内容，表示已完整卸载 Hermes Agent 插件。
可以通过 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”如何解决？
- 问题示例：
-
- 解决方案：
- 单击“Hermes > 安装插件”按钮，重新安装 Hermes Agent 插件。
如何更换 Hermes Agent 使用的模型？
暂不支持通过 ArkClaw 控制台更新 Hermes Agent 使用的模型，您可以根据如下指引完成调整：
- 执行如下命令，下载更换 Hermes Agent 使用模型的脚本。
- 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-model-switch.sh" -o hermes-model-switch.sh
- 按需执行对应命令，通过脚本更新 Hermes Agent 使用的模型。
- 当您不仅需要更换模型，还需要调整模型提供商或调用地址时，请使用本方式。注意本场景命令执行过程将删除运行 Hermes Agent 的 Docker 容器并进行重建。容器内的数据（除持久化目录外）将被删除且无法找回，请谨慎操作。持久化目录 /opt/hermes-data（对应容器内 /opt/data目录）中的数据在容器重建后仍会保留，无需额外备份。bash hermes-model-switch.sh --api-key <your_apikey> --model <model_name> --base-url <model_url>说明
- 请将<your_apikey>替换为调用目标模型的实际 API Key。
- 请将<model_name>替换为目标模型名称，例如：doubao-seed-2-0-lite-260215。
- 请将<model_url>替换为调用目标模型的URL，例如：https://ark.cn-beijing.volces.com/api/v3。
Hermes 执行任务时报错“ACP error [-32603]: Internal error”如何解决？
该问题通常是由于 Hermes 使用的推理模型配置不正确，或对应模型已达到限额导致的。您可以：
- 等待对应模型恢复额度。例如：使用火山方舟 Coding Plan 时，可前往 Coding Plan 控制台，查看超限情况并了解额度刷新时间。
如何查看 Hermes Agent 使用的推理模型信息？
您可以通过 Hermes Agent 配置文件 /opt/hermes-data/config.yaml，了解其使用的推理模型信息。
- 执行如下命令，查看 Hermes Agent 使用的推理模型。
- cat /opt/hermes-data/config.yaml | grep default: | head -n 1
- 回显如下所示时，表示当前 Hermes Agent 使用的是 doubao-seed-2-0-code-preview-260215 模型。
-
最近更新时间：2026.06.26 17:37:36
这个页面对您有帮助吗？
有用
有用
无用
无用