令牌管理

发布地址： https://clawhub.com/skills/token-management

目的： 统一管理 API 令牌——包括存储、测试、文档化及过期时间追踪。

触发语句：

• “添加令牌 X”
• “为 Y 保存 API key”
• “我需要令牌 Z”

🔴 关键规则

在索要任何令牌前，务必首先检查 ~/Documents/life/.env！

工作流程

收到新令牌时：

0. 提交 Git（如适用）

   • 若 .env 位于 Git 仓库中：cd ~/Documents/life && git add -A && git commit -m "Before updating TOKEN_NAME"
   • 安全第一！

1. 询问过期时间

   • 提问：“这个令牌何时过期？”
   • 格式：YYYY-MM-DD，或 “1 year” / “never”

2. 存入 .env

   • 位置： ~/Documents/life/.env（标准路径）
   • 格式：SERVICE_NAME_TOKEN=value # Expires: YYYY-MM-DD
   • 示例：WILEY_JIRA_TOKEN=abc123 # Expires: 2027-02-12

3. 创建日历提醒（仅限有明确过期时间的令牌）

   • 时间： 过期日前 7 天（提前一周预警）
   • 事件标题： “⚠️ 续订 [SERVICE] API 令牌（将在 7 天后过期）”
   • 格式： 全天事件
   • 命令：

     gog calendar create primary 
       --summary "⚠️ Renew SERVICE token" 
       --from "YYYY-MM-DDT00:00:00-05:00" 
       --to "YYYY-MM-DDT23:59:59-05:00" 
       --description "Token expires YYYY-MM-DD. Renew at: [RENEWAL_URL]"
     

4. 测试令牌权限

   • 运行完整测试套件，确认该令牌具备哪些操作能力
   • 脚本： 使用下方模板（按服务类型适配）
   • 将测试结果记录至 connections/ 目录下的对应文件
   • 示例：

     # 测试 Jira 令牌
     import requests, base64
     
     TOKEN = "..."
     EMAIL = "user@example.com"
     auth = base64.b64encode(f"{EMAIL}:{TOKEN}".encode()).decode()
     
     tests = [
         ("Get user", "GET", "/rest/api/3/myself"),
         ("List projects", "GET", "/rest/api/3/project"),
         ("Search issues", "GET", "/rest/api/3/search", {"jql": "assignee=currentUser()"}),
     ]
     
     for name, method, endpoint, *params in tests:
         r = requests.get(f"https://DOMAIN{endpoint}", 
                         headers={'Authorization': f'Basic {auth}'},
                         params=params[0] if params else None)
         print(f"{'✅' if r.ok else '❌'} {name}: {r.status_code}")
     

5. 在 connections/ 中文档化

   • 新建或更新 ~/Documents/life/connections/SERVICE.md
   • 需包含：
     • 令牌权限范围（读/写/作用域）
     • 获取时间： YYYY-MM-DD
     • 过期时间： YYYY-MM-DD
     • 续订链接： 获取新令牌的 URL
     • 使用方式（含代码示例）
   • 关联对应的 .env 变量名
   • 示例：

     ## Token Info
     - **Obtained:** 2026-02-12
     - **Expires:** 2027-02-12
     - **Renew at:** https://id.atlassian.com/manage-profile/security/api-tokens
     - **Scope:** read-write
     - **Variable:** `WILEY_JIRA_TOKEN` (~/Documents/life/.env)
     

6. 更新令牌索引

   • 在此 SKILL.md 文件中维护该列表（见下文）

需要调用 API 时：

1. ✅ 务必先检查 .env： ~/Documents/life/.env
2. 若未找到： 查阅 connections/ 目录中的配置说明
3. 仍缺失时： 向 Nicholas 索要令牌

令牌索引

位置： ~/Documents/life/.env

示例令牌：

你的索引： 请在本节中维护你本地副本中的专属列表（即本技能文档的本地拷贝）。

常用命令

添加令牌

# 追加至 .env（本技能将自动执行）
echo "SERVICE_TOKEN=value" >> ~/Documents/life/.env

检查令牌是否存在

grep SERVICE_TOKEN ~/Documents/life/.env

列出全部令牌

cat ~/Documents/life/.env

.env 存放位置

标准路径： ~/Documents/life/.env

选择此路径的原因：

• ✅ 属于 Life 基础设施（可共享、公开）
• ✅ 可抵御 workspace 清除操作
• ✅ 与 connections/ 目录结构保持一致
• ✅ 不依赖 OpenClaw workspace 环境

Python 中使用：

from dotenv import load_dotenv
load_dotenv('~/Documents/life/.env')  # 或传入绝对路径

Shell 中使用：

source ~/Documents/life/.env
echo $YOUR_TOKEN_NAME

创建时间： 2026-02-12
更新时间： 2026-02-13（已脱敏，适用于公开发布）