feishu-wiki-tools/references/auth.md

飞书知识库鉴权配置

配置来源

所有飞书维度的配置统一从 ~/.openclaw/openclaw.json 的 channels.feishu 读取：

字段	说明
appId	应用 App ID
appSecret	应用 App Secret（敏感）
botOpenId	机器人的 Open ID

脚本通过 init_token.py 读取配置并获取 tenant_access_token（有效期 2 小时，自动续期）。

完整配置步骤

1. 在飞书开放平台为应用开通权限：

   • wiki:wiki — 知识库读写
   • wiki:member:create — 添加成员
   • docx:document — 文档读写
   • docx:document:readonly — 文档只读
   • drive:drive — 云盘操作
   • space:document:delete — 删除文档

2. 应用 Bot ID / Open ID

   • 从配置文件读取 channels.feishu.appId 和 channels.feishu.botOpenId

3. 添加机器人为知识库成员（需管理员 OAuth）：

   • 走 OAuth 获取 user_access_token
   • 调 POST /wiki/v2/spaces/{space_id}/members
   • member_type: openid, member_role: member

4. 授予编辑权限（需管理员 OAuth + 用户同意）：

   • 调 POST /drive/v1/permissions/{obj_token}/members?type=docx
   • perm: full_access

5. 日常操作：直接用 tenant_access_token

   • 从 ~/.openclaw/openclaw.json 读取 app_id/app_secret
   • 调 POST /auth/v3/tenant_access_token/internal 获取 token
   • 有效期 2 小时，自动续期