Bagman

面向处理钱包、私钥和秘密信息的AI代理的安全密钥管理模式。

何时使用此技能

• - 代理需要访问钱包/区块链
• 处理API密钥、凭证或秘密信息
• 构建AI控制资金的系统
• 防止通过提示或输出泄露秘密

快速开始

bash

安装1Password CLI

身份验证

为代理凭证创建保险库

运行示例

核心规则

架构

┌─────────────────────────────────────────────────────┐
│ AI代理 │
├─────────────────────────────────────────────────────┤
│ 会话密钥（受限） │
│ ├─ N小时后过期 │
│ ├─ 每笔交易/每日最高消费 │
│ └─ 允许的合约/方法白名单 │
├─────────────────────────────────────────────────────┤
│ 密钥管理器（1Password/Vault） │
│ ├─ 仅在运行时获取 │
│ ├─ 绝不持久化到磁盘 │
│ └─ 访问审计追踪 │
├─────────────────────────────────────────────────────┤
│ 智能账户（ERC-4337） │
│ ├─ 可编程权限 │
│ └─ 无需暴露密钥即可恢复 │
└─────────────────────────────────────────────────────┘

实现文件

1. 秘密获取

1Password CLI模式

bash

在运行时获取（绝不存储结果）

使用注入的秘密运行（绝不接触磁盘）

.env.tpl（可安全提交 - 不含秘密）

PRIVATE_KEY=op://Agents/trading-bot/session-key
RPC_URL=op://Infra/alchemy/sepolia-url
OPENAIAPIKEY=op://Services/openai/api-key

Python用法

python
from secretmanager import getsession_key

获取已验证的会话密钥

检查有效性

print(f剩余时间: {creds.time_remaining()})
print(f允许的合约: {creds.allowed_contracts})

使用密钥（绝不记录它！）

保险库级别ACL（推荐）

配置1Password保险库权限：

Agent-Credentials/
├── trading-bot-session # 代理可读取
├── payment-bot-session # 代理可读取
└── master-key # 仅操作员（代理无访问权限）

原则： 代理凭证应放在具有只读代理访问权限的保险库中。主密钥应放在代理无法访问的单独保险库中。

2. 输出清理

在发送到任何地方之前，应用于所有代理输出：

python
from sanitizer import OutputSanitizer

def respond(content: str) -> str:
在任何输出前进行清理。
return OutputSanitizer.sanitize(content)

捕获：

- 私钥（0x + 64位十六进制）

- OpenAI/Anthropic/Groq/AWS密钥

- GitHub/Slack/Discord令牌

- BIP-39种子短语（12/24个单词）

- PEM私钥

- JWT令牌

检测到的模式

3. 输入验证

在任何钱包操作前检查输入：

python
from validator import InputValidator, ThreatLevel

result = InputValidator.validate(user_input)

if result.level == ThreatLevel.BLOCKED:
return f请求被阻止: {result.reason}

if result.level == ThreatLevel.SUSPICIOUS:
# 记录以供审查，但允许
logsuspicious(userinput, result.reason)

继续操作

威胁类别

4. 操作白名单

绝不执行任意操作。仅限明确的白名单：

python
from dataclasses import dataclass
from decimal import Decimal
from typing import Optional

@dataclass
class AllowedOperation:
name: str
handler: callable
max_value: Optional[Decimal] = None
requires_confirmation: bool = False
cooldown_seconds: int = 0

ALLOWED_OPS = {
checkbalance: AllowedOperation(checkbalance, get_balance),
transfer_usdc: AllowedOperation(
transfer_usdc,
transfer,
max_value=Decimal(500),
requires_confirmation=True,
cooldown_seconds=60
),
swap: AllowedOperation(
swap,
swap_tokens,
max_value=Decimal(1000),
cooldown_seconds=300
),
}

def execute(op_name: str, kwargs):
if opname not in ALLOWEDOPS:
raise PermissionError(f操作{op_name}不允许)

op = ALLOWEDOPS[opname]

if op.maxvalue and kwargs.get(amount, 0) > op.maxvalue:
raise PermissionError(f金额超过限制: {op.max_value})

if op.requires_confirmation:
return requestconfirmation(opname, kwargs)

return op.handler(kwargs)

5. 确认流程

高价值操作需要明确确认：

python
import hashlib
import time

pending_confirmations = {}

def request_confirmation(operation: str, details: dict) -> str:
code = hashlib.sha256(
f