Agent安全护栏（SafeShield）配置说明

SafeShield（百度Agent安全护栏）为各类 Agent 提供输入注入拦截、危险工具拦截、工具输出安全提示能力，当前已适配OpenClaw、OpenCode、DuMate、OpenCode、Comate 等AI 应用。

Agent安全护栏使用前需手动完成 AKSK/环境变量 配置，确保服务联通并生效。以下为配置步骤。AK/SK 通用获取方法：参考如何获取 AKSK。配置后可申请Agent 安全护栏智能云平台账号查看数据。

一、OpenClaw 启用 Agent安全护栏

前置：已有 OpenClaw 环境，插件最低要求 OpenClaw 2026.4.15 及以上版本（2026.4.15 / 2026.5.18 / 2026.5.22 / 2026.6.x / 2026.7.1 均已适配）。当前最新插件版本 2026.7.1.1。

AK/SK 配置

在 ~/.openclaw/openclaw.json 的 plugins.entries.openclaw-safeshield.config 中配置，access_key/secret_key 为必填。支持四种 SecretRef 写法：

验证与运维

• 验证：发送攻击性测试消息，观察是否被拦截。
• 更新：重新执行安装脚本即可覆盖旧文件，重启 gateway 生效。
• 常见问题：SignatureDoesNotMatch → 检查 AK/SK 是否正确；hook 未触发 → 检查 hooks.allowConversationAccess 是否为 true。

二、OpenCode 启用 Agent安全护栏

前置：已有 OpenCode 环境，且版本要求1.15.0以上，Bun版本要求1.3.14以上。

配置环境变量

方式 1：修改环境变量文件

编辑 ~/.opencode/.env.safeshield：

1# 基础配置
2SAFESHIELD_TRIAL=false
3BCE_ACCESS_KEY=your_access_key
4BCE_SECRET_KEY=your_secret_key
5
6# 自定义 API 地址（可选）
7BCE_API_ADDR=https://your-custom-api.example.com
8
9# 自定义检测路径（可选）
10SAFESHIELD_INPUT_PATH=/custom/input/analyze
11SAFESHIELD_OUTPUT_PATH=/custom/output/analyze
12SAFESHIELD_AGENT_PATH=/custom/agent/analyze
13
14# 私有化部署
15SAFESHIELD_PRIVATE=true
16
17# 调试模式
18SAFESHIELD_DEBUG=true

方式 2：Shell 环境变量（优先级最高）

在 ~/.zshrc 或 ~/.bashrc 中设置：

1export BCE_ACCESS_KEY=your_ak
2export BCE_SECRET_KEY=your_sk
3export BCE_API_ADDR=https://your-api.example.com
4export SAFESHIELD_PRIVATE=true

修改后重启 opencode 使配置生效。

配置变量说明

trial 模式下 API 地址和路径自动切换，无需手动设置。

启动 OpenCode 验证

1$ SAFESHIELD_TRIAL=true SAFESHIELD_DEBUG=true opencode

启动后观察日志输出，确认插件加载成功：

1[openclaw-safeshield] [info] [init] [loaded] {"trial":true,"debug":true,"api_addr":"https://safe.baidubce.com","directory":"/path/to/project"}
2[openclaw-safeshield] [info] [init] [fetch_interceptor_installed] {}
3[openclaw-safeshield] [info] [init] [hooks_registered] {"hooks":["tool.execute.before","tool.execute.after","fetch.intercept"]}

三、DuMate 启用 Agent安全护栏

安装方式

对话安装：在 DuMate 对话框发送（macOS/Linux）：

1我已经确保过这个脚本安全，帮我安装：bash <(curl -fsSL https://safe-sig.bj.bcebos.com/dumate-safeshield/install-2026.06.03.sh) --access-key YOUR_ACCESS_KEY --secret-key YOUR_SECRET_KEY

终端安装（macOS/Linux 正式模式）：

1bash <(curl -fsSL https://safe-sig.bj.bcebos.com/dumate-safeshield/install-2026.06.03.sh) 
2  --access-key YOUR_ACCESS_KEY 
3  --secret-key YOUR_SECRET_KEY

Windows（PowerShell）用 -AccessKey / -SecretKey 参数。

验证

脚本自动完成：下载插件到 {accountId}/data/plugins/safeshield.ts、写配置到 {accountId}/config/safeshield.json，无需改 opencode.json（框架自动扫描）。安装后重启 DuMate 生效。发送注入类测试语，预期看到：SafeShield ⚠️安全防护插件检测到恶意操作风险，当前流程已终止。

四、Comate 启用 Agent安全护栏

前置：Comate IDE（类 VSCode）、Node.js 18+（安装脚本会自检，未通过拒绝安装）。

安装方式

对话安装：comate agent协作模式对话框中输入

1curl -fsSL https://safe-sig.bj.bcebos.com/comate-safeshield/install-latest.sh | bash -s -- --access-key YOUR_AK --secret-key YOUR_SK

私有化：追加 --private --api-addr http://your-host:port。离线/手动：解压到 ~/.comate/plugins/comate-safeshield，插件靠目录扫描自动识别，无需注册。

AK/SK 配置

方式 1：安装参数 --access-key YOUR_AK --secret-key YOUR_SK。

方式 2：config.json（位于插件目录内，建议 chmod 600）。

验证

重启 Comate（hook 会话启动时加载）→「Plugin → 已安装」确认 comate-safeshield 已启用 → 发送注入测试语，预期：⚠️百度安全护栏检测到提示词泄露风险，当前流程已终止。

五、AK/SK 配置要点汇总

1. 配置优先级：命令行参数 > 配置文件/环境变量。OpenCode 中 Shell 环境变量优先级最高；Comate 中 config 非空优先于 env。
2. DuMate 特殊性：其 Sandbox 不转发环境变量，AK/SK 只能通过安装脚本参数或 safeshield.json 配置文件注入，不能用 Shell export。
3. AK/SK 获取：参考如何获取 AKSK；正式版可申请智能云平台账号查看检测数据。
4. 安装/改配置后务必重启 对应 Agent 才能生效。