Kimi上传文件卡在转圈是因上传通道阻断或前置条件未满足：需检查Network中无upload请求、文件是否超50MB/200MB限制、文件名含特殊字符，改用Kimi Work客户端或清缓存重连。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
Kimi上传文件时页面一直显示转圈、无响应、进度条卡住不动，说明文件未真正进入处理队列，不是网速慢导致的延迟，而是上传通道被阻断或前置条件未满足。
确认文件是否被系统拦截
第一步：打开浏览器开发者工具（Windows按F12 → 切换到Network标签页），拖入文件后观察是否有kimi-upload或/api/v1/upload相关请求发出。没有请求发出，说明文件根本没触发上传逻辑。
第二步：检查文件大小是否超过当前模型限制。Kimi Chat免费版单次上传上限为【50MB】；Kimi Work客户端则取决于你绑定的订阅类型——Kimi Pro用户支持最大200MB，但若使用的是免费额度或企业试用账号，默认仍锁定在50MB。超限文件会被前端直接拦截，不发请求，只转圈。
第三步：查看文件名是否含特殊字符。中文括号（）、顿号、全角空格、emoji符号，甚至某些带BOM头的UTF-8文本文件，在部分浏览器（尤其是Edge旧版、Safari 17.4之前）中会导致File API读取失败。改名为“report_v2.pdf”这类纯英文+数字组合再试。
跳过网页端，改用Kimi Work客户端上传
网页版依赖浏览器沙箱环境，对本地文件系统权限控制严格；Kimi Work是原生桌面应用，拥有完整文件读写能力，上传成功率高3倍以上。
方法一：直接拖拽文件到Kimi Work主界面中央区域，松手即开始上传。这一步操作起来很简单，直接把文件拖进去就行。
方法二：点击输入框右侧的「?」图标 → 在弹出窗口中选择文件 → 点击“打开”。注意：【不要双击文件名】，否则会用默认程序打开，而非上传。
方法三：如果拖拽和点击都失效，手动将文件复制进Kimi Work默认监听目录——Windows路径为C:\Users\【用户名】\Documents\KimiWork\inbox，macOS路径为~/Documents/KimiWork/inbox。Kimi Work每3秒自动扫描该目录，放入即识别。
OpenClaw专家 — 用于任何OpenClaw问题或需求，包括配置错误、网关崩溃、网关未启动、斜杠指令、频道路由等。
清除上传缓存并重置连接状态
网页端上传失败后残留的临时缓存可能污染后续请求，必须手动清空。
① 在Kimi聊天界面右上角点击头像 → 选择「设置」→ 滚动到底部点「清除上传缓存」→ 确认。
② 关闭所有Kimi网页标签页，彻底退出浏览器进程（任务管理器里杀掉chrome.exe或edge.exe所有实例）。
③ 重新打开浏览器，访问 https://kimi.moonshot.cn，登录后先不做任何操作，等待10秒让WebSocket连接重建完成，再上传文件。
这一步不能跳过。很多用户反馈“清缓存没用”，实际是因为没杀浏览器进程，旧连接还在后台占着端口，新页面连的仍是故障链路。
检查API密钥是否误填进网页版
如果你同时在用OpenClaw或自建Agent调用Kimi API，曾把API Key粘贴进Kimi网页版的某个隐藏输入框（比如调试模式下按Ctrl+Shift+I打开Console后手动执行过fetch请求），会导致网页版身份认证混乱，上传功能永久性失能。
验证方式：打开浏览器地址栏，输入javascript:console.log(localStorage.getItem('auth'))，回车。如果返回一长串以"sk-"开头的字符串，说明API Key已被错误写入本地存储。
解决办法：在Console中执行localStorage.removeItem('auth') → 刷新页面 → 重新登录账号。
