飞书文档创建

核心流程

1. 获取用户授权（仅首次）

若 feishu-user-token.json 不存在或 token 过期，需要用户重新授权：

授权链接：

https://open.feishu.cn/open-apis/authen/v1/authorize?client_id=cli_a95aca1714f89cd2&redirect_uri=http://localhost:6010/oauth/feishu/callback&scope=offline_access docx:document docx:document:create docx:document.block:convert&response_type=code

用户访问链接 → 授权 → 飞书跳转回 localhost:6010 → 回调 URL 中的 code=xxx 即为授权码

2. 交换 Token

import urllib.request

# 1. 获取 app_access_token
app_body = '{"app_id":"cli_a95aca1714f89cd2","app_secret":"oq9F8U4J3dnAyYR9AHRnigntKkOKPQ1K"}'
req = urllib.request.Request(
    "https://open.feishu.cn/open-apis/auth/v3/app_access_token/internal",
    data=app_body.encode("utf-8"),
    headers={"Content-Type": "application/json; charset=utf-8"},
    method="POST"
)
app_token = json.loads(urllib.request.urlopen(req).read().decode("utf-8"))["app_access_token"]

# 2. 用 code 换取 user_access_token
code = "用户授权后获得的code"
user_body = json.dumps({"grant_type": "authorization_code", "code": code}).encode("utf-8")
req = urllib.request.Request(
    "https://open.feishu.cn/open-apis/authen/v1/oidc/access_token",
    data=user_body,
    headers={
        "Authorization": f"Bearer {app_token}",
        "Content-Type": "application/json; charset=utf-8"
    },
    method="POST"
)
result = json.loads(urllib.request.urlopen(req).read().decode("utf-8"))
user_token = result["data"]["access_token"]
refresh_token = result["data"]["refresh_token"]

3. 创建文档（关键：请求体格式！）

import json, urllib.request

token = "user_access_token"
headers = {
    "Authorization": f"Bearer {token}",
    "Content-Type": "application/json; charset=utf-8"
}

# 创建文档 - 请求体直接用 {"title": "标题"} 而不是 {"document_style": {"title": ...}}！
body = json.dumps({"title": "文档标题"}, ensure_ascii=False).encode("utf-8")
req = urllib.request.Request(
    "https://open.feishu.cn/open-apis/docx/v1/documents",
    data=body,
    headers=headers,
    method="POST"
)
doc_id = json.loads(urllib.request.urlopen(req).read().decode("utf-8"))["data"]["document"]["document_id"]

4. 添加内容块

base_url = f"https://open.feishu.cn/open-apis/docx/v1/documents/{doc_id}/blocks/{doc_id}/children"

def add_text(text, indent=0):
    block = {"block_type": 2, "text": {"elements": [{"type": "text_run", "text_run": {"content": text}}]}}
    if indent > 0:
        block["style"] = {"indent_level": indent}
    body = json.dumps({"children": [block]}, ensure_ascii=False).encode("utf-8")
    req = urllib.request.Request(base_url, data=body, headers=headers, method="POST")
    urllib.request.urlopen(req)

def add_heading(text, level=1):
    key = f"heading{level}"
    block = {"block_type": level + 2, key: {"elements": [{"type": "text_run", "text_run": {"content": text}}]}}
    body = json.dumps({"children": [block]}, ensure_ascii=False).encode("utf-8")
    req = urllib.request.Request(base_url, data=body, headers=headers, method="POST")
    urllib.request.urlopen(req)

Block Type 参考：

关键要点

1. 请求体格式：创建文档用 {"title": "xxx"}，不是 {"document_style": {"title": ...}}
2. 编码：所有请求必须用 UTF-8 编码，Content-Type: application/json; charset=utf-8
3. Token 存储：C:\\Users\\廖洪庆\\.openclaw-autoclaw\\credentials\\feishu-user-token.json
4. 请求限流：每个请求间隔 0.3-0.5 秒，避免 429 错误