ArmorClaw — Encrypted Secrets Manager for OpenClaw
Stop storing API keys in plain-text .env files.
ArmorClaw encrypts everything with AES-256 and unlocks only on your machine.
Install
CODEBLOCK0
Quick Start
CODEBLOCK1
Use in OpenClaw Agent
CODEBLOCK2
Cross-Skill Sharing
One key, all your skills:
CODEBLOCK3
CLI Reference
CODEBLOCK4
Lock Modes
| Mode | Security | Description |
|---|
| INLINECODE1 | Medium | Type master password each time |
| INLINECODE2 |
Good | Locked to registered machine (MAC address) |
|
static-ip | Good | Locked to your static external IP only |
|
machine+static-ip | Strongest | Machine AND static external IP must match |
|
bot | Convenient | Bot auto-unlocks using stored password |
⚠️ IP restriction requires a STATIC external IP. Dynamic/rotating IPs (most home internet) will lock you out when your IP changes. ArmorClaw will warn you and confirm before registering.
Security
- - AES-256-CBC encryption with PBKDF2-HMAC-SHA256 key derivation (600k iterations)
- HMAC integrity — detects tampering
- Machine binding — vault won't open on another machine
- IP restriction — vault won't open from a different network
- Zero plaintext storage — keys never written unencrypted anywhere
- Access audit log — every read/write tracked with skill name + timestamp
Built by
PHRAIMWORK LLC · MIT License
Part of the PHRAIMWORK Security Suite: SentiClaw + ArmorClaw
ArmorClaw — OpenClaw的加密密钥管理器
别再以明文形式将API密钥存储在.env文件中。
ArmorClaw使用AES-256加密所有内容,且仅在你的机器上解锁。
安装
bash
npx clawhub@latest install armorclaw
pip install ./skills/armorclaw
快速开始
bash
初始化保险库
armorclaw init
存储你的第一个密钥
armorclaw set OPENAI_KEY
或者一次性导入整个.env文件
armorclaw import ~/.openclaw/openclaw.env
列出已存储的密钥
armorclaw list
在OpenClaw Agent中使用
python
from armorclaw.openclaw import injectvaultenv
启动时将保险库中的所有密钥注入环境变量
inject
vaultenv(password=your-master-password)
或者使用ARMORCLAW_PASSWORD环境变量实现机器人自动解锁
export ARMORCLAW_PASSWORD=your-master-password
injectvaultenv()
跨技能共享
一个密钥,所有技能通用:
python
from armorclaw.openclaw import getvaultkey
任何技能都可以从保险库中提取密钥
api
key = getvault
key(OPENAIKEY, skill=senticlaw)
CLI参考
armorclaw init 初始化保险库 + 设置主密码
armorclaw set KEY [value] 存储一个密钥
armorclaw get KEY 检索一个密钥
armorclaw list 列出所有已存储的密钥(不显示值)
armorclaw delete KEY 删除一个密钥
armorclaw import [path] 将.env文件导入保险库
armorclaw log [KEY] 查看访问日志
armorclaw report 技能使用报告
锁定模式
| 模式 | 安全性 | 描述 |
|---|
| password | 中等 | 每次输入主密码 |
| machine |
良好 | 锁定到已注册的机器(MAC地址) |
| static-ip | 良好 | 仅锁定到你的静态外部IP |
| machine+static-ip | 最强 | 机器和静态外部IP必须同时匹配 |
| bot | 便捷 | 机器人使用存储的密码自动解锁 |
⚠️ IP限制需要静态外部IP。 动态/轮换IP(大多数家庭网络)会在IP变化时将你锁定。ArmorClaw会在注册前发出警告并确认。
安全性
- - AES-256-CBC加密,使用PBKDF2-HMAC-SHA256密钥派生(60万次迭代)
- HMAC完整性校验 — 检测篡改
- 机器绑定 — 保险库无法在其他机器上打开
- IP限制 — 保险库无法从其他网络打开
- 零明文存储 — 密钥在任何地方都不会以未加密形式写入
- 访问审计日志 — 每次读/写操作都记录技能名称和时间戳
由
PHRAIMWORK LLC 构建 · MIT许可
属于PHRAIMWORK安全套件的一部分:SentiClaw + ArmorClaw