核心用法
apikeys-ui 为 OpenClaw 控制面板新增「API Keys」设置页,用户可在浏览器内直接录入、更新或清除 13 家服务商(OpenAI、Anthropic、Gemini、xAI、Groq 等)的 API 密钥。所有操作通过 WebSocket 直连 Gateway 的 config.patch RPC,密钥数据即时写入本地 clawdbot.json,全程绕过 AI 代理。
显著优点
| 维度 | 优势 |
|:---|:---|
| **安全架构** | 密钥对 AI 代理完全不可见,消除 prompt 注入或日志泄露风险 |
| **用户体验** | 可视化状态指示(✓/缺失)、密码输入框、一键清除、服务商直达链接 |
| **功能映射** | 每个密钥关联具体能力(如 OpenAI → Memory Search / Whisper / TTS) |
| **乐观并发** | 配置哈希校验避免并发写入冲突 |
| **扩展性** | 基于 Lit 的模块化 UI,便于新增服务商槽位 |
潜在缺点与局限性
- 安装复杂度:需手动修改 5+ 个 UI 源码文件(navigation.ts、app.ts、view/controller 等),非一键安装
- 无加密存储:密钥以明文形式存放于本地 JSON 配置文件,依赖系统级文件权限保护
- 浏览器端依赖:若用户禁用 JavaScript 或 WebSocket 受阻,功能失效
- 版本锁定:要求
clawdbot >= 2026.1.0,旧版本无法兼容 - 无审计日志:未记录密钥操作历史,误删无法追溯
适合人群
- 使用 OpenClaw 桌面/自托管版本,需要频繁切换多服务商密钥的开发者
- 对「AI 不可见密钥」有合规或安全洁癖的团队
- 不愿手动编辑 JSON 配置文件的普通用户
常规风险
1. 本地文件泄露:clawdbot.json 若被恶意程序读取,所有密钥暴露
2. 浏览器扩展风险:恶意扩展可能截获输入框内容
3. RPC 中间人:若 Gateway 通信未 TLS 加密,密钥传输可被嗅探
4. 社会工程:用户可能误信虚假「获取密钥」链接,泄露至钓鱼站点