docs/bot/feishu-bot-config.md
本文只解决两类常见诉求：
适用场景：
这也是本项目最推荐、最容易落地的飞书通知方式。
需要配置的变量：
FEISHU_WEBHOOK_URL=https://open.feishu.cn/open-apis/bot/v2/hook/your_hook_token
# 按需填写
FEISHU_WEBHOOK_SECRET=your_sign_secret
FEISHU_WEBHOOK_KEYWORD=股票日报
适用场景：
相关变量：
FEISHU_APP_ID=cli_xxx
FEISHU_APP_SECRET=xxx
# App Bot 主动推送时必填
FEISHU_CHAT_ID=oc_xxx
# 私聊时设置 open_id；群聊默认 chat_id
FEISHU_RECEIVE_ID_TYPE=chat_id
# 事件订阅 / Stream Bot 时才开启
FEISHU_STREAM_ENABLED=true
注意：
FEISHU_APP_ID / FEISHU_APP_SECRET 不会直接开启群 Webhook 推送FEISHU_WEBHOOK_URLFEISHU_APP_ID、FEISHU_APP_SECRET 和 FEISHU_CHAT_IDFEISHU_STREAM_ENABLED 只代表事件订阅 / Stream Bot，不参与主动通知是否配置完成的判断requirements.txt 中已有的 lark-oapi>=1.0.0，标准安装使用 pip install -r requirements.txt；参考 Feishu message create OpenAPI、lark-oapi PyPI 和 SDK repo路径通常是：
完成后复制机器人提供的 Webhook URL。
示例：
FEISHU_WEBHOOK_URL=https://open.feishu.cn/open-apis/bot/v2/hook/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
飞书群机器人常见有三种安全限制：
如果你的机器人开启了额外安全项，项目侧也必须同步配置，否则请求会被飞书拒绝。
把飞书里配置的同一个关键词写到：
FEISHU_WEBHOOK_KEYWORD=股票日报
项目会自动在每条飞书消息前补上这个关键词，你不需要手工改报告模板。
把飞书里显示的 secret 写到：
FEISHU_WEBHOOK_SECRET=your_sign_secret
项目会自动按飞书要求为每条消息补 timestamp 和 sign。
只要配置了 FEISHU_WEBHOOK_URL，通知发送就会走 Webhook 通道。
如果你还同时填了：
FEISHU_APP_ID=...
FEISHU_APP_SECRET=...
也不会影响 Webhook 推送；但它们本身不能替代 FEISHU_WEBHOOK_URL。
如果未配置 Webhook，也可以用 App Bot 主动推送：
FEISHU_APP_ID=cli_xxx
FEISHU_APP_SECRET=xxx
FEISHU_CHAT_ID=oc_xxx
FEISHU_RECEIVE_ID_TYPE=chat_id
此时 FEISHU_STREAM_ENABLED 不需要开启；它只用于事件订阅 / Stream Bot。
如果你在飞书自动化流程里消费本项目推送的卡片消息，请按下面配置：
content 可按需保留占位符）：{
"msg_type": "interactive",
"card": {
"config": { "wide_screen_mode": true },
"elements": [
{
"tag": "div",
"text": {
"tag": "lark_md",
"content": "..."
}
}
],
"header": {
"title": {
"tag": "plain_text",
"content": "A股智能分析报告"
}
}
}
}
card.elements[0].text.content
FEISHU_APP_ID / FEISHU_APP_SECRET现象：
原因：
FEISHU_CHAT_ID，群 Webhook 推送则需要 FEISHU_WEBHOOK_URL正确做法：
FEISHU_WEBHOOK_URLFEISHU_CHAT_ID，并确认应用有发消息权限且机器人在目标群中FEISHU_WEBHOOK_KEYWORD现象：
正确做法：
FEISHU_WEBHOOK_KEYWORDFEISHU_WEBHOOK_SECRET现象：
正确做法：
FEISHU_WEBHOOK_SECRET检查：
如果你在云服务器、Docker、GitHub Actions 上跑，出口 IP 可能和本地不同。
检查：
FEISHU_WEBHOOK_URL=https://open.feishu.cn/open-apis/bot/v2/hook/your_hook_token
FEISHU_WEBHOOK_URL=https://open.feishu.cn/open-apis/bot/v2/hook/your_hook_token
FEISHU_WEBHOOK_KEYWORD=股票日报
FEISHU_WEBHOOK_URL=https://open.feishu.cn/open-apis/bot/v2/hook/your_hook_token
FEISHU_WEBHOOK_SECRET=your_sign_secret
FEISHU_WEBHOOK_URL=https://open.feishu.cn/open-apis/bot/v2/hook/your_hook_token
FEISHU_WEBHOOK_SECRET=your_sign_secret
FEISHU_WEBHOOK_KEYWORD=股票日报
FEISHU_WEBHOOK_URL 已配置FEISHU_APP_ID / FEISHU_APP_SECRET / FEISHU_CHAT_ID 三项齐全FEISHU_WEBHOOK_KEYWORD / FEISHU_WEBHOOK_SECRET如果你不是单纯做群 Webhook 推送，而是要继续配置飞书应用、长连接机器人或云文档，可以参考下面这组原截图。
https://open.feishu.cn/document/develop-an-echo-bot/introduction