Pass 密钥管理 Skill Skill

Pass 密钥管理 Skill

概述

使用 Pass (Password Store) 统一管理所有 API 密钥和敏感凭证。Pass 基于 GPG 加密，支持 Git 同步，安全可靠。

快速开始

查看所有密钥

pass
# 或
pass ls

获取密钥

pass api/openai           # 显示密钥
pass -c api/openai        # 复制到剪贴板

添加密钥

pass insert api/new-service
# 或多行
pass insert -m api/new-service

编辑密钥

pass edit api/openai

删除密钥

pass rm api/old-service

生成随机密钥

pass generate api/new-token 32

目录结构

~/.password-store/
├── api/                    # API 密钥
│   ├── openrouter-vip.gpg
│   ├── zai.gpg
│   ├── anapi.gpg
│   └── github-copilot.gpg
├── tokens/                 # 访问令牌
│   ├── telegram-bot.gpg
│   └── github.gpg
├── cloud/                  # 云服务凭证
│   ├── aws.gpg
│   └── gcp.gpg
└── services/               # 其他服务
    └── docker.gpg

Git 同步

初始化同步

pass git init
pass git remote add origin git@github.com:用户名/password-store.git
pass git push -u origin master

日常同步

pass git pull    # 拉取
pass git push    # 推送

新设备克隆

# 1. 导入 GPG 密钥
gpg --import private-key.asc

# 2. 克隆仓库
git clone git@github.com:用户名/password-store.git ~/.password-store

与 OpenClaw 集成

方式 1: 启动脚本

创建 ~/.openclaw/scripts/start-with-pass.sh:

#!/bin/bash
# 从 Pass 加载密钥并启动 OpenClaw

export ZAI_API_KEY=$(pass api/zai)
export OPENROUTER_VIP_API_KEY=$(pass api/openrouter-vip)

exec openclaw gateway "$@"

方式 2: 环境变量文件

# 生成 .env 文件（临时使用）
pass api/zai | xargs -I {} echo "ZAI_API_KEY={}" > /tmp/openclaw.env
pass api/openrouter-vip | xargs -I {} echo "OPENROUTER_VIP_API_KEY={}" >> /tmp/openclaw.env

# 使用
source /tmp/openclaw.env && openclaw gateway

方式 3: 直接引用（推荐）

在 ~/.bashrc 或 ~/.zshrc 中添加:

# OpenClaw 密钥
alias openclaw-start='ZAI_API_KEY=$(pass api/zai) OPENROUTER_VIP_API_KEY=$(pass api/openrouter-vip) openclaw gateway'

常用命令速查

| 命令 | 说明 | |------|------| | pass | 列出所有密钥 | | pass api/xxx | 显示密钥 | | pass -c api/xxx | 复制到剪贴板 | | pass insert api/xxx | 添加密钥 | | pass edit api/xxx | 编辑密钥 | | pass rm api/xxx | 删除密钥 | | pass mv api/old api/new | 重命名 | | pass cp api/xxx api/backup | 复制 | | pass find xxx | 搜索 | | pass generate api/xxx 32 | 生成随机密钥 | | pass git pull | 同步拉取 | | pass git push | 同步推送 |

安全最佳实践

1. GPG 密钥备份

# 导出私钥（安全保存！）
gpg --export-secret-keys --armor 你的邮箱 > gpg-private.asc

# 导出公钥
gpg --export --armor 你的邮箱 > gpg-public.asc

2. 使用私有仓库

GitHub/GitLab 私有仓库
即使泄露，没有 GPG 私钥也无法解密

3. 定期轮换密钥

# 更新密钥
pass edit api/openai

# 查看修改历史
pass git log --oneline

4. 多设备同步注意

每台设备需要导入 GPG 私钥
使用 SSH 密钥访问 Git 仓库

故障排查

GPG 解密失败

# 检查密钥
gpg --list-secret-keys

# 重新导入
gpg --import private-key.asc

Git 同步冲突

pass git status
pass git stash
pass git pull
pass git stash pop

权限问题

chmod 700 ~/.password-store
chmod 600 ~/.password-store/**/*.gpg

当前配置

GPG 密钥: 5F845B8E1B6C5C52 (DL <REDACTED_EMAIL>)

已存储的密钥:

api/openrouter-vip - OpenRouter VIP API
api/zai - 智谱 AI API
api/anapi - Anapi Claude API
tokens/telegram-bot - Telegram Bot Token
tokens/github-copilot - GitHub Copilot Token

由小a创建和维护

Agent Skills: Pass 密钥管理 Skill

Install this agent skill to your local

Skill Files