Crypto Guardian

面向管理链上资产的 AI 代理的全面加密货币安全系统。该系统基于针对 AI 代理及其对话历史的真实世界盗窃模式构建。

威胁模型：AI 代理如何被盗

主要攻击向量：对话历史扫描

攻击者主动扫描公共 AI 平台、GitHub 提交记录及对话日志，以搜寻泄露的私钥和助记词。聊天历史中出现一个私钥 = 资产立即被清空。

真实事件（2026-05-01）：

• 私钥被存储在 SESSION-STATE.md 中
• AI 对话历史对扫描系统可访问
• 攻击者数分钟内即发现该密钥 → 两笔交易共盗取约 227 AUD

次要攻击向量

• 钓鱼攻击：伪造的钱包应用、伪造的空投活动
• SIM 卡劫持：交易所使用的基于短信的双因素认证（2FA）
• 供应链攻击：遭入侵的硬件钱包销售商
• 智能合约漏洞利用：已授权的恶意代币
• 社交工程：私信承诺“免费加密货币”

黄金准则（不可协商）

1. 私钥与助记词绝不可存在于工作区文件中

以下文件均不安全：

• SESSION-STATE.md
• working-buffer.md
• MEMORY.md
• .env（若其中直接写入私钥本身）
• 工作区中任意 .json、.txt、.md 文件
• 任何 AI 对话历史（公共平台）

安全替代方案：

• 仅使用 .env，并在运行时通过环境变量引用密钥
• 硬件钱包（密钥永不离开设备）
• 带密码保护的加密存储
• 完全不存储私钥的钱包（仅观察地址 + 硬件签名）

2. 绝不可将私钥输入 AI 对话流程中处理

• 切勿在消息中发送私钥（即使声称用于“辅助分析”）
• 切勿在聊天中要求 AI 交互式签署交易
• 应使用正规签名基础设施（硬件钱包、气隙环境）
• 私钥 = 一次性使用，此后绝不再次接触网络

3. 假设所有工作区文件均为公开可访问

• 写入工作区的每个文件都可能被搜索引擎索引
• 压缩服务、记忆系统与搜索索引均会扫描内容
• 若暴露后会造成严重后果，则请勿将其写入任何文件

钱包架构

策略：分层隔离

热钱包（小额、在线）

• 用途：日常操作、小额资金
• 余额上限：50–500 AUD
• 示例：DEX 交易钱包、Fiverr 收入钱包
• 始终优先采用仅观察（watch-only）访问方式

温钱包（中额、半气隙）

• 用途：活跃项目资金、赏金收入
• 余额：500–5000 AUD
• 访问方式：签名由硬件钱包完成，监控使用仅观察地址
• 示例：Jupiter DCA 钱包、Grip Protocol 钱包

冷钱包（大额、离线）

• 用途：长期持有、储蓄
• 余额：＞5000 AUD
• 访问方式：仅限硬件钱包，完全无网络连接
• 存储方式：物理上与日常设备分离

推荐的钱包配置

Purpose              | Wallet Type        | Key Storage
---------------------|--------------------|----------------------
Trading/Active       | Software (Solflare) | .env, never in files
Grip/Bounty Earn     | Software (MetaMask) | Seed phrase in .env only
Long-Term Savings    | Hardware (Ledger)   | Never touches computer

运营安全检查清单

在处理任何加密资产前

• 这是新钱包还是已有钱包？
• 我是否需要存储私钥或助记词？
• 若是：能否改用硬件钱包实现？
• 若是：签名操作能否在与本代理不同的设备上执行？
• 当前金额是否值得承担密钥暴露的风险？

创建新钱包时

1. 在气隙硬件设备上生成，或在正规软件钱包中生成
2. 立即以物理形式备份助记词（纸张/金属）
3. 在充值前务必验证地址正确性
4. 彻底销毁任何纸质残留的助记词笔记
5. 确认备份安全后，再进行充值

签署交易时

• 使用硬件钱包或正规签名基础设施
• 在设备屏幕上核验目标地址
• 在设备屏幕上核验交易金额
• 切勿盲签（不得签署未知数据）
• 设置合理的代币授权额度（避免无限授权）

集成 AI 代理时

• 使用不暴露原始私钥的钱包 API
• 将密钥存于环境变量中，而非文件
• 采用 signer.py / signer.ts 模式：密钥置于环境变量 → 进程内签名
• 如可行，优先使用钱包连接器（WalletConnect、Phantom），而非原始密钥
• 使用仅观察地址进行监控（切勿将仅观察地址用于签名上下文）

代币授权安全

“无限授权”的风险

当你为某代币设置支出授权时，常默认选择“无限”额度。这意味着一旦该合约存在恶意行为或遭黑客入侵，攻击者即可清空你的全部余额。

准则：始终设定具体授权额度，禁止使用无限授权。

如何查询已授权代币

# 在 Etherscan/Blockscan 上检查代币授权
# 1. 在 Blockscan/Polkassembly 上打开该地址页面
# 2. 点击 “Token Approvals”
# 3. 撤销所有未使用或可疑的授权

# Base 网络专用：
# https://basescan.org/tokenapprovalchecker

授权检查清单

• 使用新 dApp 前，先检查代币授权
• 撤销不再使用的 dApp 的所有授权
• 使用有限授权（精确数额，非无限）
• 对 USDT、USDC、WETH 等高价值代币需格外谨慎

多重签名（Multisig）配置

对于金额 ＞5000 AUD 的资产，建议采用多重签名：

Gnosis Safe（免费，部署于 Base）

• 2-of-3 签名者：硬件钱包 + Ledger + 桌面端
• 任何交易均需多个设备共同授权
• 恢复能力：任一设备丢失，其余仍可正常运作

适用多重签名的场景：

• 团队/项目资金（多决策方）
• 长期储蓄（＞1 年）
• 高价值持有（＞5000 AUD）
• 任何无法承受资金清空风险的钱包

事件响应

若怀疑密钥已泄露

1. 立即行动 —— 默认视为已失陷，直至反证成立
2. 检查区块链 —— 查找未经你授权的转出交易
3. 若已被清空：交易不可逆。请完整记录留档。
4. 撤销关联 API 密钥：如交易所相关密钥
5. 若为全新钱包：立即将剩余资金转移至新钱包
6. 严禁：继续使用已暴露密钥执行任何操作

若发现资金已被清空

1. 保存交易哈希 —— 作为向交易所提交报告的证据
2. 向交易所报案（若资金已提现至该交易所）
3. 核查是否为智能合约漏洞利用 —— 此类情形或可恢复
4. 接受损失 —— 若交易已上链且不可逆

恢复极为罕见

与信用卡不同，加密货币交易不可撤销。预防是唯一真正有效的保护手段。

面向 OpenClaw 代理：实践落地指南

本代理的钱包策略

Wallet Type    | Address           | Storage      | Used For
---------------|-------------------|---------------|--------------------------
Active DCA    | [DISCARDED]          | None        | （空置，已被清空）
Bounty Earn   | 0xD1089e...           | .env only   | Grip, ClawMoney
Watch-Only    | [YOUR WALLET]         | TOOLS.md    | 仅监控用途
New DCA Wallet| TBD (new generation)  | Hardware    | Jupiter DCA（未来启用）

密钥存储规则

1. 绝不在任何位置明文写入完整私钥（除 .env 外，且该文件必须加入 .gitignore）
2. 绝不在对话中提及：包括“让我验证这个密钥是否正确”等场景
3. 绝不在 SESSION-STATE.md 或 working-buffer.md 中写入
4. 会话结束后，绝不在内存文件中保留密钥
5. 金额 ＞500 AUD 时，必须使用硬件钱包

环境变量使用模式

# 正确：私钥仅存在于环境变量中
from dotenv import load_dotenv
load_dotenv()
private_key = os.environ["SOLANA_PRIVATE_KEY"]  # 绝不写入文件

# 错误：私钥写入任意工作区文件
# private_key = "[PRIVATE KEY]"  # 绝对禁止

使用仅观察钱包进行监控

监控所用地址与签名所用地址必须不同：

• 监控地址：存放于 TOOLS.md 或配置文件中
• 签名地址：仅存于硬件钱包中

如此，即便监控凭证意外泄露，资金依然绝对安全。

总结：安全性 vs. 便捷性

经验法则：丢失钱包的代价绝不应影响人生轨迹。热钱包中仅存放你能承受损失的金额。

紧急联系渠道

• Base 网络浏览器： https://basescan.org/
• 代币授权检查器： https://basescan.org/tokenapprovalchecker
• Revoke.cash（一键撤销授权）： https://revoke.cash/
• Gnosis Safe（多重签名）： https://app.safe.global/
• Ledger 安全恢复指引： https://www.ledger.com/stop-phishing-attacks

Crypto Guardian v1.0 — 基于 2026-05-01 发生的真实钱包盗窃事件编写