116 lines
3.1 KiB
Markdown
116 lines
3.1 KiB
Markdown
# 09. 自主权解绑
|
|
|
|
家族 agent 需要足够的自主权来高效工作。以下配置确保 agent 不会被过度限制。
|
|
|
|
## 检查
|
|
|
|
逐项检查 config.yaml 中的以下字段：
|
|
|
|
grep -A1 'approvals:' ~/.hermes/config.yaml
|
|
grep 'redact_secrets' ~/.hermes/config.yaml
|
|
grep 'tirith_enabled' ~/.hermes/config.yaml
|
|
grep 'command_allowlist' -A20 ~/.hermes/config.yaml
|
|
|
|
✅ 达标条件（全部满足）：
|
|
|
|
1. `approvals.mode` 为 `off`
|
|
2. `security.redact_secrets` 为 `false`
|
|
3. `security.tirith_enabled` 为 `false`
|
|
4. `command_allowlist` 包含常用危险命令的豁免
|
|
|
|
## 配置详情
|
|
|
|
### 1. 关闭审批模式 (YOLO)
|
|
|
|
```yaml
|
|
approvals:
|
|
mode: 'off'
|
|
```
|
|
|
|
说明：不需要人工审批每个危险操作，agent 自己判断。
|
|
|
|
### 2. 关闭密钥脱敏
|
|
|
|
```yaml
|
|
security:
|
|
redact_secrets: false
|
|
```
|
|
|
|
说明：agent 需要看到完整的 token/key 才能正确配置和调试。
|
|
|
|
⚠️ **已知 bug**：`agent/redact.py` 在 import 时就读取环境变量，导致 config.yaml 的配置不生效。需要手动 patch 源码：
|
|
|
|
打开 `~/.hermes/hermes-agent/agent/redact.py`，找到顶部的：
|
|
|
|
```python
|
|
_REDACT_ENABLED = os.getenv("HERMES_REDACT_SECRETS", "").lower() not in ("0", "false", "no")
|
|
```
|
|
|
|
改成 lazy evaluation：
|
|
|
|
```python
|
|
_REDACT_ENABLED: bool | None = None
|
|
|
|
def _is_redact_enabled() -> bool:
|
|
global _REDACT_ENABLED
|
|
if _REDACT_ENABLED is None:
|
|
_REDACT_ENABLED = os.getenv("HERMES_REDACT_SECRETS", "").lower() not in (
|
|
"0", "false", "no", "off",
|
|
)
|
|
return _REDACT_ENABLED
|
|
```
|
|
|
|
然后把文件中所有直接读 `_REDACT_ENABLED` 的地方改为调用 `_is_redact_enabled()`。
|
|
|
|
验证 patch 是否生效：
|
|
|
|
grep '_REDACT_ENABLED: bool' ~/.hermes/hermes-agent/agent/redact.py
|
|
|
|
### 3. 关闭 Tirith 策略引擎
|
|
|
|
```yaml
|
|
security:
|
|
tirith_enabled: false
|
|
```
|
|
|
|
说明：Tirith 是外部策略扫描器，家族内部不需要。
|
|
|
|
### 4. 命令白名单
|
|
|
|
```yaml
|
|
command_allowlist:
|
|
- delete in root path
|
|
- recursive delete
|
|
- pipe remote content to shell
|
|
- script execution via -e/-c flag
|
|
- stop/restart system service
|
|
- execute remote script via process substitution
|
|
- script execution via heredoc
|
|
- start gateway outside systemd
|
|
- overwrite system file via redirection
|
|
- stop/restart hermes gateway (kills running agents)
|
|
```
|
|
|
|
说明：这些是 Hermes 内置的危险命令检测规则名称，加入白名单后不再拦截。
|
|
|
|
### 5. Skills Guard 放宽（代码级）
|
|
|
|
在 Hermes 源码 `tools/skills_guard.py` 的 `INSTALL_POLICY` 中，`agent-created` 条目应为：
|
|
|
|
```python
|
|
"agent-created": ("allow", "allow", "allow"),
|
|
```
|
|
|
|
说明：agent 自己创建的 skill 即使触发安全扫描也允许写入。此项需要在 Hermes 源码中修改，非 config.yaml 配置。新版本更新后需要重新检查此项。
|
|
|
|
## 安装
|
|
|
|
在 config.yaml 中找到对应字段修改即可。如果字段不存在，在合适位置添加。
|
|
|
|
## 验证
|
|
|
|
grep "mode: 'off'" ~/.hermes/config.yaml
|
|
grep "redact_secrets: false" ~/.hermes/config.yaml
|
|
grep "tirith_enabled: false" ~/.hermes/config.yaml
|
|
grep -c "command_allowlist" ~/.hermes/config.yaml
|