GLM-5.2 接入 飞书 完整指南：云 API 与私有化部署双路径实测

1✅ 中文周报 / 月报 / 述职材料润色与改写
2✅ 制度、流程、报销办法的内部问答
3✅ 会议转写稿 → 纪要 + 待办清单
4✅ 中文合同 / 标书的要点抽取与风险提示
5✅ 政府机关、国企公文风格的改写
6✅ 对数据出境有硬性限制的所有场景

1❌ 高难度算法设计、竞赛级数学证明
2❌ 需要英文语境地道表达的对外文案
3❌ 超长 2M 级别的全文检索（虽然支持 1M，但长尾精度下降）

1from openai import OpenAI
2import os
3
4client = OpenAI(
5    api_key=os.environ["GLM_API_KEY"],               # 形如 xxxxxxxx.xxxxxxxx 两段式
6    base_url="https://open.bigmodel.cn/api/paas/v4", # ❗ 必须带 /api/paas/v4，只写域名会 404
7)
8
9resp = client.chat.completions.create(
10    model="glm-5.2",
11    messages=[
12        {"role": "system", "content": "你是飞书群里的行政助理，回答用中文，不超过 150 字，不要客套话。"},
13        {"role": "user", "content": "报销流程里超过 5000 需要谁签字？"},
14    ],
15    temperature=0.3,
16    max_tokens=2048,
17)
18print(resp.choices[0].message.content)

1client = OpenAI(
2    api_key="sk-local-dummy",                 # 自建服务不校验时可以随便填
3    base_url="http://10.0.0.12:8000/v1",      # 内网 vLLM / SGLang 服务地址
4)
5resp = client.chat.completions.create(model="glm-5.2", messages=[...])

1待签字符串 = timestamp + "\n" + secret
2签名 = HMAC-SHA256(key = secret, message = 待签字符串)，取小写十六进制 hex

1import hashlib, hmac, json, os, time
2import requests
3
4WEBHOOK = os.environ["FEISHU_WEBHOOK_URL"]
5SECRET  = os.environ["FEISHU_BOT_SECRET"]
6
7def gen_sign(timestamp: int, secret: str) -> str:
8    string_to_sign = f"{timestamp}\n{secret}"
9    return hmac.new(
10        secret.encode("utf-8"),
11        string_to_sign.encode("utf-8"),
12        hashlib.sha256,
13    ).hexdigest()          # ❗ hexdigest，不是 base64
14
15def push(body: dict) -> dict:
16    ts = int(time.time())                  # ❗ 秒级，不要乘 1000
17    payload = dict(body, timestamp=str(ts), sign=gen_sign(ts, SECRET))
18    r = requests.post(
19        WEBHOOK,
20        headers={"Content-Type": "application/json; charset=utf-8"},
21        data=json.dumps(payload, ensure_ascii=False).encode("utf-8"),
22        timeout=10,
23    )
24    return r.json()

1{ "Extra": null, "StatusCode": 0, "StatusMessage": "success" }

1from openai import OpenAI
2
3client = OpenAI(api_key=os.environ["GLM_API_KEY"],
4                base_url=os.environ["GLM_BASE_URL"])   # 云 or 内网，改环境变量即可切换
5
6def ask_glm(question: str) -> str:
7    resp = client.chat.completions.create(
8        model="glm-5.2",
9        messages=[
10            {"role": "system", "content": "你是飞书群里的行政助理，回答用中文，150 字以内，先结论后依据。"},
11            {"role": "user", "content": question},
12        ],
13        temperature=0.3,
14        max_tokens=1024,
15    )
16    return resp.choices[0].message.content
17
18push({"msg_type": "text", "content": {"text": ask_glm("下周三的周会要改到周五，帮我写个通知")}})

1{
2  "msg_type": "interactive",
3  "card": {
4    "config": {
5      "wide_screen_mode": true,
6      "enable_forward": true
7    },
8    "header": {
9      "template": "orange",                       // 可选 blue/wathet/turquoise/green/yellow/orange/red/carmine/violet/purple/indigo/grey
10      "title": {
11        "tag": "plain_text",                      // ❗ 必须是对象不是字符串，否则 230002
12        "content": "报销待审批 · 需您处理"
13      }
14    },
15    "elements": [
16      {
17        "tag": "div",
18        "text": { "tag": "lark_md", "content": "**申请人**：李四\n**金额**：¥ 6,800.00\n**事由**：上海客户现场支持差旅" }
19      },
20      { "tag": "hr" },
21      { "tag": "markdown", "content": "GLM-5.2 核对结果：金额超过 5000，按制度需**部门总监**二级审批。" },
22      {
23        "tag": "note",
24        "elements": [{ "tag": "plain_text", "content": "规则来源：《费用报销管理办法》第 3.2 条" }]
25      },
26      {
27        "tag": "action",
28        "actions": [
29          {
30            "tag": "button",
31            "text": { "tag": "plain_text", "content": "通过" },
32            "type": "primary",
33            "value": { "action": "approve", "bill_id": "BX-2026-0615-042" }   // ❗ value 必须是对象
34          },
35          {
36            "tag": "button",
37            "text": { "tag": "plain_text", "content": "驳回" },
38            "type": "danger",
39            "value": { "action": "reject", "bill_id": "BX-2026-0615-042" }
40          }
41        ]
42      }
43    ]
44  }
45}

1App ID:     cli_a1b2c3d4e5f6g7h8
2App Secret: Xd8xxxxxxxxxxxxxxxxxxxxxxxxxxxx

1import threading, time, requests
2
3TOKEN_URL = "https://open.feishu.cn/open-apis/auth/v3/tenant_access_token/internal"
4
5class TokenCache:
6    """有效期 7200 秒；多实例部署请放到 Redis 里共用"""
7    def __init__(self, app_id, app_secret):
8        self.app_id, self.app_secret = app_id, app_secret
9        self._token, self._expire_at, self._lock = None, 0, threading.Lock()
10
11    def get(self):
12        with self._lock:
13            if time.time() < self._expire_at:
14                return self._token
15            r = requests.post(TOKEN_URL, json={
16                "app_id": self.app_id, "app_secret": self.app_secret,
17            }, timeout=10).json()
18            if r.get("code") != 0:
19                raise RuntimeError(f"token 获取失败: {r}")
20            self._token = r["tenant_access_token"]
21            self._expire_at = time.time() + r.get("expire", 7200) - 300    # 提前 5 分钟续期
22            return self._token
23
24tokens = TokenCache(os.environ["FEISHU_APP_ID"], os.environ["FEISHU_APP_SECRET"])

1def send(receive_id: str, text: str, id_type: str = "chat_id"):
2    url = f"https://open.feishu.cn/open-apis/im/v1/messages?receive_id_type={id_type}"
3    body = {
4        "receive_id": receive_id,          # 群的 chat_id 或人的 open_id
5        "msg_type": "text",
6        "content": json.dumps({"text": text}, ensure_ascii=False),   # ❗ content 是 JSON 字符串
7    }
8    r = requests.post(url, headers={"Authorization": "Bearer " + tokens.get()},
9                      json=body, timeout=15).json()
10    if r.get("code") != 0:
11        raise RuntimeError(f"发送失败 {r.get('code')}: {r.get('msg')}")
12    return r["data"]["message_id"]

1import json
2import lark_oapi as lark
3
4def on_message(data: lark.im.v1.P2ImMessageReceiveV1) -> None:
5    msg = data.event.message
6    try:
7        text = json.loads(msg.content).get("text", "").strip()
8    except json.JSONDecodeError:
9        return
10    if not text:
11        return
12    answer = ask_glm(text)              # 打到你自己的内网推理服务
13    send(msg.chat_id, answer)
14
15ws = lark.ws.Client(
16    os.environ["FEISHU_APP_ID"],
17    os.environ["FEISHU_APP_SECRET"],
18    event_handler=lark.EventDispatcherHandler.builder("", "")
19        .register_p2_im_message_receive_v1(on_message)
20        .build(),
21    log_level=lark.LogLevel.INFO,
22)
23ws.start()          # 阻塞运行，用 systemd / pm2 守护

1from Crypto.Cipher import AES
2import base64, hashlib, json
3
4def decrypt(encrypted_b64: str, encrypt_key: str) -> dict:
5    key = hashlib.sha256(encrypt_key.encode()).digest()    # 32 字节
6    raw = base64.b64decode(encrypted_b64)
7    cipher = AES.new(key, AES.MODE_CBC, raw[:16])          # 前 16 字节为 IV
8    plain = cipher.decrypt(raw[16:])
9    return json.loads(plain[: -plain[-1]].decode("utf-8")) # 去 PKCS7 填充

1请把下面这段我要发到全公司群的通知，改成规范的中文商务通知。
2
3要求：
41. 保留全部事实要素（时间、地点、对象、要求），一个都不能丢
52. 语气正式但不生硬，去掉口语词和感叹号
63. 控制在 180 字以内，分两段：第一段讲事，第二段讲要求
74. 如果缺了关键要素（比如没说几点、没说带什么），不要替我补全，直接在结尾标一行「待补充：xxx」
8
9原文：
10各位，周三那个会改到周五下午了哈，还是老地方那个大会议室，大家记得把上周的进度汇报材料带上，别忘记了！

1你是本公司 HR 制度助手，只依据下面的《员工手册》片段回答。
2
3硬性规则：
4- 手册里没有的内容，必须回答「手册里没有这部分，请直接联系人事 @王五」，不允许推测
5- 涉及天数、金额、百分比的数字必须原样引用，不允许换算、不允许四舍五入
6- 回答不超过 150 字，格式统一为「结论 + 依据条款 + 联系人」
7- 不许说「建议」「可能」「一般来说」这类模糊表达
8
9《员工手册》片段：
10<粘贴内容>

1下面是本次周会的语音转写稿（约 9000 字，含口语重复、口误和抢话现象）。请输出：
2
31. 核心结论，最多 5 条，每条 30 字以内
42. 待办清单表格，表头固定为：负责人 | 任务 | 截止时间 | 优先级
5   - 没有明确提到负责人的填「待认领」，不许猜是谁
6   - 没提到时间的填「未约定」，不许编日期
73. 未达成共识的分歧点，用一句话概括双方立场
84. 风险项：有人提到「来不及」「人手不够」「依赖外部」的，逐条列出
9
10转写稿：
11<粘贴文本>