Local-Passwords-Manager

本地密码管理器，用于存储、查询、修改和删除账号密码。当用户要求记住密码、查询密码、修改密码、删除密码时使用。 存储文件：~/.openclaw/workspace/passwords.json 特性：密码加密存储、支持多账号、记录创建/修改时间、支持备注/URL、支持姓名、全字段搜索 触发词：记住xxx密码、查一下xxx、修改xxx密码、删除xxx密码、我的密码、搜索xxx

Password Manager

本地密码管理器，支持密码加密、多账号存储、时间记录、备注信息、姓名、全字段搜索。

存储位置

• ~/.openclaw/workspace/passwords.json - 加密后的密码数据
• ~/.openclaw/workspace/.password_key - 加密密钥（600权限）

功能特性

• 🔐 密码加密：使用 Fernet 对称加密，密钥存储在本地文件
• 👥 多账号：支持同一服务存储多个账号
• 📅 时间记录：记录密码创建时间和最后修改时间
• 📝 备注支持：支持存储 URL 或备注信息
• 👤 姓名支持：支持存储中文名（可选）
• 🔍 全字段搜索：支持按服务名、账号、姓名、备注搜索
• ✏️ 修改密码：支持更新已有密码
• 📤 导入/导出：支持 CSV 批量导入导出
• 🏷️ 标签分类：支持给密码加标签，方便筛选
• ⚡ 原子写入：防止并发覆盖

存储字段

字段	必填	说明
username	✅	账号/用户名
password	✅	加密后的密码
name	可选	中文姓名
note	可选	备注/URL
tags	可选	标签数组，如 ["VPN", "服务器"]
created_at	✅	创建时间
updated_at	✅	最后修改时间

使用方式

记住密码

python3 scripts/password_manager.py add <服务名> <账号> <密码> [备注] [姓名] [标签]

示例：

# 基本用法
python3 scripts/password_manager.py add GitHub [e-mail] 123456

# 带备注
python3 scripts/password_manager.py add 首都之窗VPN wangteng wangteng@123 https://example.com

# 带备注、姓名和标签
python3 scripts/password_manager.py add 腾讯云 admin pass123 "" "" "云服务,生产环境,重要"

查询密码

# 查询某服务的所有账号
python3 scripts/password_manager.py get <服务名>

# 查询指定账号
python3 scripts/password_manager.py get <服务名> <账号>

搜索密码（全字段）

支持精确搜索和模糊搜索：

# 精确搜索（默认）
python3 scripts/password_manager.py search <关键词>

# 模糊搜索（支持输错字，比如输入 "wy" 能搜到 "wangyi"）
python3 scripts/password_manager.py search <关键词> --fuzzy

示例：

# 搜索包含 "wangyi" 的所有记录
python3 scripts/password_manager.py search wangyi

# 搜索包含 "李" 的姓名
python3 scripts/password_manager.py search 李

# 搜索备注中包含 "dify" 的记录
python3 scripts/password_manager.py search dify

修改密码

python3 scripts/password_manager.py update <服务名> <账号> <新密码>

示例：

python3 scripts/password_manager.py update GitHub [e-mail] newpass123

删除密码

# 删除指定账号
python3 scripts/password_manager.py delete <服务名> <账号>

# 删除整个服务
python3 scripts/password_manager.py delete <服务名>

列出所有密码

# 列出所有
python3 scripts/password_manager.py list

# 按标签筛选
python3 scripts/password_manager.py list --tag VPN

# 查看所有标签
python3 scripts/password_manager.py tags

导出密码

导出所有密码为 CSV 文件：

python3 scripts/password_manager.py export

生成文件：passwords_export_YYYYMMDD_HHMMSS.csv

导入密码

从 CSV 文件导入密码：

python3 scripts/password_manager.py import <CSV文件>

CSV 格式要求：

服务,账号,密码,姓名,备注,标签,创建时间,更新时间
GitHub,[e-mail],123456,,,云服务,,
测试服务,test,testpass,测试用户,备注,VPN;服务器,2024-01-01,2024-01-01

注意：导入时会追加到现有数据，不会覆盖 标签用逗号分隔，如 VPN,服务器

命令行示例

# 添加密码
python3 scripts/password_manager.py add GitHub [e-mail] 123456

# 添加密码（带备注、姓名和标签）
python3 scripts/password_manager.py add 腾讯云 admin pass123 "" "" "云服务,生产环境,重要"

# 查询所有账号
python3 scripts/password_manager.py get <服务名>

# 查询指定账号（可复制密码）
python3 scripts/password_manager.py get <服务名> <账号> --copy

# 搜索（精确匹配）
python3 scripts/password_manager.py search wangyi

# 模糊搜索（支持输错字）
python3 scripts/password_manager.py search wy --fuzzy

# 列出所有密码
python3 scripts/password_manager.py list

# 按标签筛选
python3 scripts/password_manager.py list --tag VPN

# 查看所有标签
python3 scripts/password_manager.py tags

# 批量添加标签（给某服务所有账号加标签）
python3 scripts/password_manager.py add-tag <服务名> <标签>

# 批量添加标签（给搜索结果加标签）
python3 scripts/password_manager.py add-tag --search <关键词> <标签>

# 移除标签
python3 scripts/password_manager.py remove-tag <服务名> <账号> <标签>

# 批量删除（搜索结果）
python3 scripts/password_manager.py delete --search <关键词>

# 批量删除（按标签）
python3 scripts/password_manager.py delete --tag <标签>

# 批量删除（无标签的记录）
python3 scripts/password_manager.py delete --empty-tags

# 修改密码
python3 scripts/password_manager.py update GitHub [e-mail] newpass123

# 删除指定账号
python3 scripts/password_manager.py delete GitHub [e-mail]

# 导出为 CSV
python3 scripts/password_manager.py export

# 从 CSV 导入
python3 scripts/password_manager.py import passwords.csv

数据格式

passwords.json 格式：

{
  "服务名": [
    {
      "username": "账号",
      "password": "加密后的密码",
      "name": "中文姓名（可选）",
      "note": "备注/URL（可选）",
      "created_at": "2024-01-01T12:00:00",
      "updated_at": "2024-01-02T12:00:00"
    }
  ]
}

依赖

pip install cryptography

• cryptography：用于密码加密（必需）

测试说明

开发新功能时，使用独立的测试数据：

# 1. 创建测试数据
python3 scripts/password_manager.py add "测试服务" "testuser" "testpass123"

# 2. 测试功能
python3 scripts/password_manager.py get "测试服务"
python3 scripts/password_manager.py update "测试服务" "testuser" "newpass"
python3 scripts/password_manager.py search test

# 3. 测试完成后删除
python3 scripts/password_manager.py delete "测试服务"