🎫 飞书 App Access Token 获取指南¶

重要： App Access Token 永久有效，不会过期！
更新时间： 2026-03-17

🎯 为什么要用 App Access Token？¶

📋 获取步骤¶

步骤 1：创建企业自建应用¶

1. 访问飞书开放平台：https://open.feishu.cn/
2. 登录企业管理员账号（扫码登录）
3. 点击 "企业自建应用" → "创建应用"
4. 填写应用信息：
5. 应用名称：OpenClaw 归档助手
6. 应用图标：（可选）
7. 应用描述：自动归档对话到知识库

步骤 2：获取凭证¶

创建应用后，在应用管理页面找到：

• App ID（应用 ID）
• App Secret（应用密钥）

⚠️ 重要： App Secret 只显示一次，请立即复制保存！

步骤 3：配置应用权限¶

在应用管理页面，点击 "权限管理"：

需要的权限¶

配置方法¶

1. 点击 "申请权限"
2. 搜索上述权限名称
3. 勾选并申请
4. 管理员审批（需要企业管理员审核通过）

步骤 4：获取 App Access Token¶

方法 1：使用 API 直接获取（推荐）¶

1
2
3
4
5
6

curl -X POST "https://open.feishu.cn/open-apis/auth/v3/app_access_token/internal" \
  -H "Content-Type: application/json" \
  -d '{
    "app_id": "cli_xxxxxxxxxxxxx",
    "app_secret": "xxxxxxxxxxxxxxxxxxxxxxxxx"
  }'

响应示例：

1
2
3
4
5
6
7
8

{
  "code": 0,
  "msg": "success",
  "data": {
    "app_access_token": "t-xXXXXXXXXXXXXXXXXXXXXXXX",
    "expire": 7200
  }
}

⚠️ 注意： 虽然显示 expire: 7200（2 小时），但 App Access Token 可以**无限次刷新**，只要 App ID 和 App Secret 不变，就可以一直获取新 Token。

方法 2：使用 Python 脚本获取¶

1

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

步骤 5：更新脚本配置¶

编辑 scripts/feishu-archive.py：

1
2
3
4
5
6
7

# 旧配置（User Access Token - 会过期）
# USER_ACCESS_TOKEN = "u-fLM1T9ZUJ0qWLyWRcZeTmg14hYkw5hMjq28a3xk007vp"

# 新配置（App Access Token - 永久有效）
APP_ID = "cli_xxxxxxxxxxxxx"
APP_SECRET = "xxxxxxxxxxxxxxxxxxxxxxxxx"
USE_APP_TOKEN = True  # 启用 App Token 模式

🔧 自动获取 Token 脚本¶

我已经创建了自动获取脚本：

scripts/get-feishu-app-token.py¶

用法：

1
2
3
4
5

# 获取并保存 Token
python3 scripts/get-feishu-app-token.py

# 仅查看（不保存）
python3 scripts/get-feishu-app-token.py --dry-run

配置文件：

1
2
3
4
5
6
7

// config/feishu-app-token.json
{
  "app_id": "cli_xxxxxxxxxxxxx",
  "app_secret": "xxxxxxxxxxxxxxxxxxxxxxxxx",
  "token": "t-xXXXXXXXXXXXXXXXXXXXXXXX",
  "expires_at": 1773700000
}

📝 完整配置清单¶

1. 获取 App ID 和 App Secret¶

• 创建企业自建应用
• 复制 App ID
• 复制 App Secret（只显示一次！）

2. 申请权限¶

• 申请云文档权限
• 申请知识库权限
• 等待管理员审批

3. 获取 Token¶

• 运行获取脚本
• 验证 Token 有效

4. 配置脚本¶

• 更新 feishu-archive.py
• 测试上传功能

5. 获取空间信息¶

• 获取 Space ID
• 获取 Folder Token

🔍 验证配置¶

1
2
3
4
5

# 测试 Token 是否有效
python3 scripts/test-feishu-token.py

# 测试完整流程
python3 scripts/feishu-archive.py 2026-03-16

⚠️ 常见问题¶

Q1: App Access Token 真的不会过期吗？¶

A: App Access Token 本身有效期是 2 小时，但可以**无限次刷新**。只要保存好 App ID 和 App Secret，就可以随时获取新 Token，相当于"永久有效"。

Q2: 管理员审批需要多久？¶

A: 通常立即生效，最长不超过 24 小时。

Q3: 多个脚本如何共享 Token？¶

A: 使用配置文件 config/feishu-app-token.json，所有脚本都从这里读取。

Q4: Token 泄露了怎么办？¶

A: 1. 立即在飞书开放平台**重置 App Secret** 2. 旧 Token 立即失效 3. 更新配置文件

📚 相关文档¶

• 飞书开放平台
• App Access Token 文档
• 权限管理指南

下一步：填写 App ID 和 App Secret，然后运行获取脚本