OpenClaw飞书无响应因密钥填错位置、base_url不匹配或模型名错误：需将飞书AppSecret填入【飞书集成】页，模型密钥填入【模型配置】页并核对前缀、base_url末尾无斜杠、模型名大小写及拼写严格一致，修改后重启gateway服务。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
OpenClaw配置完API Key后，飞书消息发过去却始终没回复，聊天窗口一直显示“对方正在输入…”或干脆静默，后台日志里反复出现Agent failed before reply或401 Unauthorized错误。
确认API Key类型是否填错位置
OpenClaw系统内需区分三类密钥：核心网关密钥、飞书应用凭证、AI模型密钥。若把飞书AppSecret粘贴到【模型配置】页的API Key框里，服务会直接拒绝调用模型——因为模型服务根本收不到合法认证头。
打开后台【对接管理 → 模型配置】，检查当前填写的密钥是否属于你所选Provider（如qwen-portal、openai-compatible）对应的真实模型密钥；飞书凭证应填在【飞书集成】页，而非此处。
方法一：核对密钥前缀
OpenAI类密钥必须以sk-开头，Qwen Portal密钥通常含qwen-或qp-；飞书AppSecret是32位十六进制字符串，不含短横线。看到feishu_或app_开头的密钥，立刻删掉重填。
方法二：用最小化curl验证
在服务器终端执行：curl -H "Authorization: Bearer 【你的密钥】" https://api.openclaw.com/v1/status
返回{"status":"ok"}说明核心网关密钥有效；若返回401，则密钥无效或填错位置。
检查base_url是否匹配密钥所属平台
这一步最容易被忽略：密钥和base_url必须来自同一服务商。拿OpenAI密钥去请求云舒API（https://yunshuapi.cn/v1），必然401。
第一步：进入【模型配置】页，找到你正在使用的模型条目，点击右侧【编辑】。
第二步：核对base_url字段是否满足三个条件：
① 以https://开头；
② 结尾包含/v1（不能是/v1/或多一层/chat/completions）；
③ 域名与密钥发放平台完全一致——比如密钥来自OpenAI控制台，base_url就必须是https://api.openai.com/v1。
第三步：保存后，立即在飞书中发一条测试消息（如“你好”），同时运行openclaw logs --follow观察日志中是否出现request to [url]及后续响应状态码。
注意：【base_url末尾多一个斜杠 / 就会导致401，且错误日志不提示具体原因】
OpenClaw 原生 PDF/文档处理技能，适用于 Nutrient DWS，帮助用户完成 PDF 转换、OCR、文字/表格提取、PII 脱敏等功能。
验证模型名称拼写与大小写
模型名称不是随便写的代号，而是服务端严格校验的字符串。填错一个字母、少一个下划线、大小写不符，都会触发Agent failed before reply。
打开模型提供商的官方文档，复制其公布的准确模型ID。例如：
Qwen Portal的正式模型名是qwen2.5-72b-instruct，不是qwen2.5-72b或Qwen2.5-72b-Instruct；
OpenAI的gpt-4o-mini必须写成gpt-4o-mini，写成gpt-4o_mini或gpt4o-mini均失败。
这一步操作起来很简单，直接对照文档复制粘贴即可，不要手动敲写。
重启gateway服务并捕获实时日志
配置修改后不重启，旧进程仍用缓存中的错误参数运行。
执行openclaw gateway restart，等待返回OK。
紧接着运行openclaw logs --follow，在飞书中发送“测试”，观察终端输出中是否出现以下关键行：
→ message receive: {"text":"测试","open_id":"xxx"}
→ calling model qwen2.5-72b-instruct via https://qwen-api.example.com/v1
→ response status: 200
如果第一条就缺失，说明gateway未真正启动成功，需检查systemctl status clawdbot-gateway.service；如果卡在第二行后无响应，大概率是base_url不通或模型密钥被拒。
