pass-secrets

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 [email protected]:用户名/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 [email protected]:用户名/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

---

相关资源

• Pass 官网
• Pass GitHub
• 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创建和维护