# 环境与密钥

> 在 Beav 保存变量，并决定外部 Agent 可以如何使用。

- 原文: https://beav.pro/docs/agent/secrets

在 Beav 左下角账号菜单打开「环境与密钥」，也可从 MCP 连接设置进入。添加 API Key 或密码时，把类型选为「Secret」。点击变量名编辑名称、值、备注和访问级别；停用后所有 Agent 都不能使用，但变量仍保留。

![环境与密钥弹窗：每行是一个变量，显示备注、最近使用、遮盖的值、外部 Agent 访问级别、启用开关](https://beav.pro/screenshots/env-secrets-zh-2026-10-08.webp)

*每个变量一行：可显示或复制值、切换启用，并单独设置外部 Agent 能否使用。*

## 批量编辑与导入

「.env 编辑」把变量显示为文本。Secret 的 `••••••••` 表示保留原值，替换它才会更新；紧挨变量上方的 `#` 注释保存为备注。删除一行会删除该变量，保存前请核对删除提示。「导入 .env」只合并，不删除已有变量。

## 外部 Agent 访问级别

| 级别  | 效果                                                        |
| --- | --------------------------------------------------------- |
| 不共享 | 外部 Agent 看不到变量；账号菜单中新建变量默认如此                              |
| 仅注入 | Agent 可看名称和备注，并通过 `secrets_run` 在本机命令中使用；素材库中新建或导入的变量默认如此 |
| 可读取 | Agent 还能用 `secrets_read` 获取明文                             |

外部 Agent 可用 `secrets_list` 列出已共享变量的名称与备注。仅注入会遮盖常规命令输出中的原值，但能运行命令的客户端仍可能取得或转发注入值；只共享给信任的工具。需要密钥时在 Beav 中添加并告诉 Agent 变量名，不要把值粘贴到聊天里。
