OpenClaw Windows Tokens额度不足故障处理指南
遇到OpenClaw在Windows上弹出“Rate limit exceeded”,自动化任务卡死、数据采集中断、新指令全部失效——这本质上是Clawhub服务端的Tokens配额用完了,跟本地网络或软件版本无关。不少用户误以为重启软件甚至重装系统能解决问题,但额度由服务器控制,本地操作毫无作用。要恢复流程,必须生成一个Full access权限的Token,再通过clawhub login完成认证,才算真正解除限制。
核实当前Token剩余量
先打开OpenClaw主界面,查看右上角「剩余 Tokens」数字。如果显示为0或负数,或者长期卡在低位(比如不足1000),说明已触发限流保护。此时即便网络正常、Gateway在线,所有依赖远程模型的指令都会直接失败。
一个常见误区:认为重启软件能重置额度——不可能。这个数值由Clawhub服务器统一管控,本地重启一万次也没任何效果。
生成并配置Clawhub Token
方法一:从官网直接获取
访问 https://clawhub.dev/settings/tokens(需科学上网),登录你的Clawhub账户。点击「Create token」,权限范围选择「Full access」——只有Full access才能正常执行自动化任务。生成后立刻复制整段token字符串,格式类似claw_abc123def456...。⚠️ 【务必保存到本地文本文件,网页关闭后就再也看不到这串token了】。
方法二:通过命令行快速补发
按Win+R输入cmd回车,打开命令提示符。执行 clawhub token create --scope full。返回一段JSON结果,其中包含token:字段,提取value值并复制即可。
执行登录认证
第一步:确保OpenClaw完全退出——不仅关闭界面,还需要在任务管理器中检查clawd.exe是否有残留进程。不彻底退出会导致登录被占用。
第二步:在CMD中执行登录指令:clawhub login --token 【刚复制的完整token字符串】。
第三步:观察返回信息。只有出现OK. Logged in as @yourname才表示认证成功。如果提示Invalid token,先检查复制的token是否含有多余空格或换行——【token开头结尾绝对不能有空格,否则认证必败】。
验证限流是否已解除
重新双击启动Openclaw Windows 一键启动.exe,等待Gateway上线后,在对话框中输入一个测试指令,例如「读取桌面test.txt内容」。
如果返回结构化文本而不是报错,并且右上角Tokens数值开始逐步回升(每分钟增长50~200),说明限流已解除。
如果依然报Rate limit exceeded,则需检查杀毒软件是否拦截了clawhub命令的通信——临时关闭Windows Defender实时防护再试,通常可以解决。
