Skill:kyvault
🔐 本地加密密钥管理 CLI——AES-256-GCM 纯本地存储,AI 只能拿到别名注入,永远看不到明文。
适用场景
招聘人事
适合角色
介绍
以下内容整理自开源仓库 `webkubor/kyvault` 的 README / SKILL.md 摘要:
---
name: kyvault
version: 1.3.0
description: "轻量级加密密钥管理 — 支持多账户多密钥,AI 安全注入。触发条件: 需要管理密钥、密码、API Token、服务器台账或 CLI 令牌时触发。触发词: 密钥、secret、token、API key、password、kyvault、server ledger、cli token。"
license: MIT
author: webkubor
category: security
platforms: [linux, macos]
metadata:
openclaw:
tags: [security, secrets, passwords, encryption, kyvault]
requires:
python: [>=3.10, cryptography>=41.0]
---
# Kyvault
本地加密密钥库 — 人存一次,AI 用别名注入,永远看不到明文。
## 快捷别名
| 别名 | 等价 | 用途 |
|------|------|------|
| `ky` | `kyvault` | 主命令 |
| `kyp` | `kyvault platform` | 列出平台 |
| `kya` | `kyvault account` | 账户管理 |
| `kyk` | `kyvault key` | 密钥管理 |
| `kyi` | `kyvault init` | 初始化 |
| `kyr` | `kyvault run` | 注入 env |
| `kyconnect` | `kyvault connect` | AI 一键连接 |
| - | `kyvault doctor` | 工具自检修复 |
| - | `kyvault update` | 在线升级工具 |
## 安装与对接
```bash
curl -fsSL https://raw.githubusercontent.com/webkubor/kyvault/main/install.sh | bash
kyvault init # 生成 master key(已存在则原样返回,绝不覆盖)
```
`install.sh` 装的是 Rust 静态二进制到 `~/.local/bin`,并顺手清掉旧的 Python 版
(pipx 包 / `/usr/local/bin` 里的 python shim / 数据目录下的模块副本)。
**不要用 `pip install kyvault`** —— PyPI 从来没有成功发布过,那条指引一直是错的。
## 账户管理
```bash
# 保存账户(用户名+密码)
kya set github user@gmail.com mypassword123
kya set github admin@gmail.com adminpass456
# 读取密码
kya get github user@gmail.com
# 列出平台下所有账户
kya list github
# 删除账户
kya delete github user@gmail.com
```
## 密钥管理
```bash
# 保存平台密钥(API Key、Token 等)
kyk set github ghp_xxxxxxxxxxxx mytoken
kyk set openai sk-xxxxxxxxxxxx mykey
# 读取密钥
kyk get github ghp_xxxxxxxxxxxx
# 列出平台下所有密钥
kyk list github
# 删除密钥
kyk delete github ghp_xxxxxxxxxxxx
```
## 平台查询
```bash
# 列出所有平台及摘要
kyp
# 查看指定平台详情
kyp github
```
## AI 集成
```bash
# 推代码
kyr --env GITHUB_TOKEN=ghp_xxxxxxxxxxxx -- git push
# 调 API
kyr --env OPENAI_API_KEY=sk-xxxxxxxxxxxx -- python app.py
# 多个密钥
kyr --env TOKEN1=secret1 --env TOKEN2=secret2 -- python script.py
```
## 别名系统
```bash
# 创建别名(AI 只认识这个)
ky alias set github_token secret://github/ghp_xxxxxxxxxxxx
# 用别名注入
kyr --env GITHUB_TOKEN=github_token -- git push
```
## 从 .env 迁移
```bash
# 预览(不实际导入)
ky import --file .env --dry-run
# 导入全部
ky import --file .env
# 只导入 GitHub 相关
ky import --file .env --prefix GITHUB_
```
## 🖥️ 服务器密码与租金台账 (Server Ledger)
```bash
# 保存服务器
kyvault server set my-host 120.46.12.3 rootpwd123 --cost "99元/月" --provider "腾讯云"
# 查询全部台账信息
kyvault server get my-host
# 指定读取单个加密字段
kyvault server get my-host --field ip
kyvault get secret://server/my-host/root-password
```
## 🔌 CLI 客户端多 Token 维护 (CLI Multi-Tokens)
```bash
# 为指定 CLI 的不同账户存储 Token
kyvault cli set studio-cli webkubor jwt_token_main
kyvault cli set studio-cli test-user jwt_token_test
# 查询指定 Profile 的加密令牌
kyvault cli get studio-cli webkubor
kyvault get secret://cli/studio-cli/test-user
```
## 存储
---
**说明**:内容由公开仓库整理,使用前请自行核对是否适合你的场景。
安装方式
1. 打开仓库:https://github.com/webkubor/kyvault 2. 查找 SKILL.md 或 README 中的安装章节 3. 克隆或下载所需 Skill 子目录到本地 skills 路径(如 `.cursor/skills/` 或 `.claude/skills/`) 4. 重启 / 重载 Agent 客户端 5. 用一条真实任务验证 Skill 是否被正确加载
适用平台
- Claude
- Codex