必须完成api密钥注入、飞书应用权限开通、消息通道对接三步闭环：先在deepseek平台创建并验证api密钥；再在飞书开放平台创建自建应用，启用机器人并勾选三项关键权限；最后配置长连接模式，部署openclaw服务并填入凭证。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
要让DeepSeek API真正驱动飞书机器人自动应答、理解上下文并执行业务逻辑，必须完成API密钥注入、飞书应用权限开通、消息通道对接三步闭环，缺一不可。
获取并验证DeepSeek API Key
访问 DeepSeek官方平台，登录后进入「API密钥」页面，点击「创建新密钥」，复制生成的 sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx 字符串。这个密钥不能泄露，【一旦泄露需立即在平台删除并重建】。
用 curl 快速验证是否可用：
curl -X POST https://api.deepseek.com/v1/chat/completions \-H "Authorization: Bearer sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \-H "Content-Type: application/json" \-d '{"model": "deepseek-chat", "messages": [{"role": "user", "content": "你好"}]}'
返回含 "choices" 字段的 JSON 即表示密钥有效；若提示 401 或 "invalid api key"，请检查是否复制了多余空格或已过期。
在飞书开放平台创建自建应用并启用机器人
登录 飞书开放平台 → 左侧「应用管理」→「创建应用」→ 选择「企业自建应用」→ 填写名称（如“客服AI”）、描述、图标。
进入应用后台 → 左侧「功能与能力」→「机器人」→ 点击「添加机器人」→ 开启「启用机器人」开关，并设置机器人名称（需与后续配置中 bot_name 完全一致）。
关键一步：在「权限管理」中，必须勾选以下三项，否则机器人无法收发消息：
① 消息 → 发送消息（群聊/私聊）
② 消息 → 读取用户发给机器人的单聊消息
③ 用户 → 读取用户基本信息（用于识别提问人）
不勾选第②项，机器人将完全收不到私聊内容；不勾选第①项，所有回复都会静默失败。
配置消息接收方式：长连接优先
飞书支持 Webhook 和长连接两种消息接入模式。Webhook 需公网IP和HTTPS域名，调试成本高；长连接由飞书主动推送事件到你的服务端，本地开发直连即可，推荐首选。
在应用后台 → 「事件订阅」→「订阅事件」→ 勾选：
• im.message.receive_v1（收到私聊消息）
• im.message.receive_in_group_v1（收到群聊@消息）
然后点击「启用长连接」→ 复制「App ID」和「App Secret」→ 这两个值将填入后端配置文件中，【App Secret 仅显示一次，丢失需重置】。
部署后端服务并注入凭证
以 OpenClaw 为例（适配 2026.x 版本）：
第一步：安装工具链
npm install -g openclaw@latest
第二步：初始化服务并接受风险声明
openclaw onboard --install-daemon --non-interactive --accept-risk
第三步：编辑配置文件 ~/.openclaw/config.yaml，填入以下核心字段：
llm: provider: deepseek api_key: "sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" base_url: "https://api.deepseek.com"channels: lark: app_id: "cli_xxxxxxxxxxxxxxxx" app_secret: "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" bot_name: "客服AI"
注意 bot_name 必须与飞书后台设置的机器人名称一字不差，包括大小写和空格。
第四步：启动服务
openclaw start
第五步：检查状态
openclaw status
终端输出中出现「Gateway: running」且「lark channel: connected」即表示飞书通道已打通。
大量免费API接口：立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游，为数据API应用能力赋能！
