🎫 飞书 Token 配置总结¶

回答你的问题： 飞书 Token 如果会过期的话，每次存档是不是都要先获取飞书 Token？

✅ 解决方案¶

使用 App Access Token（推荐）¶

答案：不需要每次获取！

✅ 一次配置，永久使用
✅ Token 会自动刷新（脚本自动处理）
✅ 只需保存好 App ID 和 App Secret

📊 Token 类型对比¶

类型	有效期	是否需要每次获取	推荐度
App Access Token	永久（自动刷新）	❌ 不需要	⭐⭐⭐⭐⭐
User Access Token	2 小时	✅ 需要	⭐⭐
Tenant Access Token	2 小时	✅ 需要	⭐⭐⭐

🚀 快速配置（3 步完成）¶

步骤 1：运行配置向导¶

1 2	`cd /home/admin/.openclaw/workspace ./scripts/configure-feishu-app.sh`

按提示输入： - App ID - App Secret

步骤 2：获取 Token¶

1	`python3 scripts/get-feishu-app-token.py`

✅ Token 会自动保存到 config/feishu-app-token.json

步骤 3：测试归档¶

python3 scripts/feishu-archive.py 2026-03-16

🔄 Token 自动管理机制¶

脚本自动处理¶

# 每次运行归档脚本时：
# 1. 检查缓存的 Token 是否过期
# 2. 如果未过期 → 直接使用
# 3. 如果已过期 → 自动用 App Secret 刷新
# 4. 保存新 Token 到配置文件

你只需要¶

**第一次**配置 App ID 和 App Secret
之后**完全不用管**，脚本自动处理

📁 配置文件说明¶

config/feishu-app-credentials.json¶

{
  "app_id": "cli_xxxxxxxxxxxxx",
  "app_secret": "xxxxxxxxxxxxxxxxxxxxxxxxx"
}

- 用途： 保存 App 凭证 - 有效期： 永久（除非重置） - 安全性： 不要上传到 Git

config/feishu-app-token.json¶

{
  "app_access_token": "t-xXXXXXXXXXXXX",
  "expire": 7200,
  "expires_at": 1773700000,
  "updated_at": "2026-03-17T03:30:00"
}

- 用途： 缓存 Token - 有效期： 2 小时（自动刷新） - 管理： 脚本自动维护

⚠️ 注意事项¶

1. App Secret 安全¶

⚠️ **不要**上传到 Git
⚠️ **不要**分享给他人
✅ 已添加到 .gitignore

2. 权限申请¶

创建应用后，记得申请权限： - [x] 云文档只写权限 - [x] 云文档读取权限 - [x] 知识库管理权限

需要**管理员审批**，通常立即生效。

3. Token 刷新¶

脚本会在 Token 过期前**自动刷新**，无需手动干预。

如果想强制刷新：

1	`python3 scripts/get-feishu-app-token.py --force`

🎯 完整工作流¶

┌─────────────────────────────────────────────────────────┐
│  第一次配置                                              │
│  1. 创建飞书应用                                         │
│  2. 获取 App ID 和 Secret                                │
│  3. 运行 configure-feishu-app.sh                        │
│  4. 申请权限并等待审批                                   │
└─────────────────────────────────────────────────────────┘
                          ↓
┌─────────────────────────────────────────────────────────┐
│  获取 Token（一次完成）                                  │
│  1. 运行 get-feishu-app-token.py                        │
│  2. Token 自动保存到配置文件                             │
└─────────────────────────────────────────────────────────┘
                          ↓
┌─────────────────────────────────────────────────────────┐
│  日常使用（完全自动）                                    │
│  1. 运行 feishu-archive.py                              │
│  2. 脚本自动检查 Token 是否过期                          │
│  3. 如过期自动刷新                                       │
│  4. 执行归档操作                                         │
└─────────────────────────────────────────────────────────┘

📝 总结¶

问题¶

飞书 token 如果会过期的话，每次存档是不是都要先获取飞书 token

答案¶

不需要！

使用 App Access Token 方案： - ✅ 第一次配置后，永久使用 - ✅ Token 过期自动刷新 - ✅ 完全自动化，无需手动干预

唯一需要手动的时候¶

第一次配置（10 分钟）
App Secret 泄露需要重置（极少发生）

🔗 相关文档¶

配置完成后，每次归档都会自动使用有效的 Token！