OpenClaw 2026.2.15 卡在twiddling thumbs、日志刷context window too smallTaoToken 通道没坏坏的是默认 4096 的 contextWindow。先去 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end 创建一把 API Key然后把 OpenClaw 自定义 Provider 的 Base URL 填成https://taotoken.net/api最后回到~/.openclaw/openclaw.json把models.providers里的contextWindow抬到 200000、maxTokens抬到 128000。三步做完再重启网关openclaw models status --probe不报错、Agents 显示 1 active才算真正能继续往下接 Slack。这篇按排障顺序写不按安装顺序写。因为 TUI 转圈这个现象很多人会先去怀疑模型、怀疑网络、怀疑 Slack token来回折腾半天最后发现只是配置文件里一个数字没改。把顺序调整成「先定位报错 → 再决定通道 → 最后改配置和验证」能省下大量重复restart的时间。1. twiddling thumbs 卡住先确认是不是 contextWindow 只有 40961.1 TUI 转圈时到底发生了什么twiddling thumbs和noodling是 OpenClaw TUI 在等模型返回时给的两个状态词本身不代表崩溃。问题是它一直停在这两个词上不动既不报错退出也不返回内容看起来像死机。日志里那句context window too small才是关键线索模型入口收到了一个超出声明上限的请求于是整条链路卡在等待里。OpenClaw 2026.2.15 对「自定义 Provider」有一个不太友好但很省事的默认值——如果你只在 onboard 里填了 Base URL 和 API Key没有显式声明上下文长度它就按 4096 处理。4096 在几年前够用现在连一份稍微完整的系统提示词加历史对话都塞不下。TUI 不会告诉你「你超了」只会告诉你「窗口太小」然后就转圈。1.2 为什么加大模型或者换通道都没用这一点必须先讲清楚否则很容易走弯路。contextWindow是 OpenClaw 用来做请求裁剪和拼接的参数它写在本地配置里不由通道决定。也就是说无论你把模型通道指向哪里OpenClaw 仍然按 4096 去截断和组装上下文。换通道解决的是「能不能调通、够不够用、Key 好不好管」解决不了「本地声明的窗口太小」。TaoToken 在这个问题里的角色很明确提供 API Key 和一条兼容的模型通道 Base URL让 OpenClaw 有个稳定的入口可以调用。上下文长度仍然是你在openclaw.json里改两者不是一回事。把这条边界记住后面所有配置都不会串。1.3 排障前先把 Key 准备好在动手改配置文件之前先把凭据准备好避免配置改一半又去开浏览器。打开 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end注册登录之后进控制台创建 API Key复制出来的字符串我们统一用YOUR_API_KEY代指不要直接贴到聊天记录或者截图里。同一页面的模型广场会列出当前可用的模型 ID把它记下来后面 onboard 和配置文件都要用。提示Key 只在创建时完整显示一次复制完先存进密码管理器。如果反复找不到直接重新创建一把即可不要靠记忆猜。2. openclaw onboard 里把自定义 Provider 指到 TaoToken2.1 onboard 交互里的两个关键输入如果你正在跑openclaw onboard走到自定义 Provider 这一段时会依次问 Provider URL 和 API Key。Provider URL 这一栏填https://taotoken.net/api注意两点结尾不要加/v1也不要带任何查询参数。API Key 这一栏填上一步拿到的YOUR_API_KEY。模型 ID 那一栏按模型广场当时列表里显示的原文填写不要自己加日期后缀或者猜测命名规则。这一步做完之后onboard 只会帮你写一份最基础的 Provider 配置。它不会替你声明contextWindow所以下一节的手工编辑仍然必须做。很多人以为 onboard 跑完就结束了结果回到 TUI 继续转圈就是因为漏了这一步。2.2 已经装好、不想重跑 onboard 的情况OpenClaw 的配置是纯文本直接编辑完全等价于重跑一遍 onboard。打开~/.openclaw/openclaw.json找到models.providers这一层新增或修改你的自定义 Provider 节点。下面这段是通道部分字段名按 OpenClaw 的实际结构写值按你自己的环境替换。{ models: { providers: { taotoken: { type: openai-compatible, baseUrl: https://taotoken.net/api, apiKey: YOUR_API_KEY } } } }baseUrl就是通道地址apiKey就是刚创建的 Key。平台侧如果之后调整了可用模型你只要在这里的模型列表里改 ID不用动其他文件。2.3 模型 ID 不要凭印象写context window too small修完之后紧跟着最容易撞上的第二个错就是模型不存在或者 404。绝大多数情况不是通道的问题而是模型 ID 写错了。以 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end 模型广场当时列表为准列表上怎么写的就怎么填不做任何「顺手美化」。如果同一把 Key 想在多个工具里用建议把模型 ID 单独记在一个便签里配置时复制粘贴而不是手敲。手敲是最常见的低级错误来源。3. 改 openclaw.jsoncontextWindow 200000、maxTokens 1280003.1 找对层级models.providers 而不是 agents 目录这是本篇最重要的一节。要改的文件是~/.openclaw/openclaw.json要改的层级是models.providers。不要改agents/main/agent/models.json那个文件管的是 Agent 维度的模型引用关系不是 Provider 的能力声明。改错地方会出现一种很迷惑的现象文件确实改了restart也确实跑了但models status --probe显示的还是 4096。判断方法很简单打开配置文件搜索contextWindow。如果搜到的位置在models.providers下面那是对的如果压根搜不到说明你还没声明过需要手动补上。3.2 完整的 Provider 配置片段把上一节的通道部分扩写成下面这样contextWindow和maxTokens两个值都补上。模型 ID 换成模型广场里实际列出的那个。{ models: { providers: { taotoken: { type: openai-compatible, baseUrl: https://taotoken.net/api, apiKey: YOUR_API_KEY, contextWindow: 200000, maxTokens: 128000, models: [ { id: YOUR_MODEL_ID, name: YOUR_MODEL_ID } ] } } } }contextWindow决定 OpenClaw 认为这个 Provider 能吃多长的上下文maxTokens决定单次生成的上限。两个值都写清楚TUI 就不会再因为默认 4096 而提前拒绝请求。平台侧不同模型的真实上限可能不同具体以模型广场当时列表为准这里的 200000 和 128000 是给 OpenClaw 的声明值。3.3 改完之后顺手检查 JSON 语法配置文件写坏一个逗号OpenClaw 启动时会直接读不到 Provider表现又变回「没有可用模型」比原来的报错更难判断。保存前用编辑器的 JSON 校验看一眼或者跑一次python -m json.tool ~/.openclaw/openclaw.json能正常打印出格式化内容就说明语法没问题。注意如果文件里已经有其他 Provider不要整段替换只在你自己的 Provider 节点里加字段。多 Provider 并存时OpenClaw 按 Agent 里配置的引用去选不会自动切。4. gateway restart 之后用 models status --probe 验证4.1 重启和等待的正确姿势配置改完不重启是不会生效的。OpenClaw 的网关需要重新加载配置文件官方顺序是先重启再等一段时间让探针跑完。完整命令如下openclaw gateway restart sleep 15 openclaw models status --probesleep 15不是可选项。网关重启后需要通过探针去逐个确认 Provider 是否可用立刻执行查询经常会拿到上一次的缓存状态看起来像没生效。等十几秒再看结果才靠谱。4.2 一眼看懂 probe 输出models status --probe的正常输出里你应该关注三件事一是当前 Provider 被识别到了二是没有context window too small这类告警三是 Agents 一行显示 1 active。这三项同时满足才说明通道和上下文声明都到位了。如果 Agents 显示 0 active通常是 Agent 里引用的模型 ID 和 Provider 里声明的 ID 对不上如果 Provider 识别到了但仍有窗口告警回到第 3 节检查是不是改错了文件。排障阶段不要凭感觉改按「先看 Provider、再看 Agent、最后看窗口数值」的顺序查。4.3 确认无误后再去配 Slack Socket ModeOpenClaw 的模型链路和 Slack 接入是两件独立的事。模型没跑通就去配 Slack只会让问题叠加你分不清是模型没返回还是 Slack 那边没收到。所以顺序建议是先让models status --probe干净再进 Slack Socket Mode 的配置把 App Token、Bot Token 这些填完最后在频道里发一条消息做端到端验证。这一步和第 1 节说的边界是同一条通道归通道配置归配置。先把本地声明修对再去接外部集成排查面会小很多。5. 改完还是不对三个高频对照5.1 仍然报 context window too small九成是改错了位置或者在models.providers下面的节点名和 Agent 里引用的名字不一致。另一个可能是你同时保留了两份配置比如openclaw.json和某个环境变量覆盖同时存在。检查环境变量里有没有旧的OPENCLAW_*覆盖项有就先清掉再 restart。顺便确认一下你有没有在改完之后忘记保存或者编辑器把文件写到了备份路径。这类问题听起来低级但在实际排障中出现频率非常高。5.2 401 或者模型找不到401 基本是 Key 的问题复制时多了空格、复制了半截、或者用的是别的平台的 Key。模型找不到则是模型 ID 的问题回到 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end 看一眼模型广场当前列表复制完整的 ID 覆盖掉配置文件里的值再走一遍 restart 加 probe。baseUrl写错也会伪装成这两类错误。确认它必须是https://taotoken.net/api结尾没有/v1也没有任何查询参数。如果是从别处复制过来的配置模板把 URL 那一行整个替换掉不要只改域名。5.3 probe 通过但 TUI 还在 noodling这时候通道已经没问题了去看 Agent 侧。常见原因是 Agent 里挂的工具描述太长或者系统提示词里塞了大量历史内容即使contextWindow声明到 200000实际拼出来的请求也可能触到别的限制。可以先把 Agent 的历史会话清一轮再试一次。还有一种情况是 Slack 集成配置了一半就开了 TUI网关在等外部连接。把 Slack 相关配置临时注释掉单独验证模型这一层能快速区分到底是哪一半在拖。6. 跑通之后去控制台对一下这次调用models status --probe干净之后建议用同一把 Key 在 TaoToken 模型对话 里发一条测试消息确认模型 ID 和通道地址跟 OpenClaw 里写的是同一套。如果打算长期挂着 OpenClaw 跑任务可以到 Coding Plan 看套餐是否够用需要再开一把 Key 给别的工具用在 控制台 API Keys 创建。想对照其他命令行工具的接法可以翻 Claude Code 接入文档里面的环境变量写法虽然针对 Claude Code但通道地址和 Key 的用法是同一套逻辑。最后留一句提醒contextWindow这个数字以后每次换模型都值得复查一次。不同模型能吃多长上下文并不一样声明得比真实上限大会在长对话里出现难以定位的截断声明得太小又回到今天这个转圈现场。改完配置、重启、probe这三步固定成肌肉记忆OpenClaw 的模型层基本不会再给你制造意外。