踩坑实录:Windows装OpenClaw,我被权限和定时任务折腾了整整一晚上(避坑指南)
昨晚,一个看似简单的需求——让 AI 助手在 Windows 上定时执行任务——硬生生折腾到半夜两点。
从 exec denied: allowlist miss 报红,到端口被占满,到配对失败,到 QQ 机器人掉线,每一个坑都踩得怀疑人生。
但好消息是:全部解决了,而且有完整可复现的排障路径。
今天把这套方案整理出来,给同样在 Windows 上跑 OpenClaw 的朋友,省点命。
一、先说最重要的:新版权限配置,错一个字都不行
OpenClaw 2026.3.31 重构了权限体系,旧版的 tools.exec.enabled 等配置完全失效,这是踩坑的根源。
❌ 这些配置别试了,不生效
tools.exec.enabled = false → 新版不识别,直接报错exec.ask = "off" → 路径错误,Unrecognized keyapprovals.exec.enabled → 配置层级不对,不生效✅ 正确配置,放到 openclaw.json
"tools":{"profile":"full","exec":{"ask":"off","security":"full"}},"approvals":{"exec":{"enabled":false}}profile: "full" | |
exec.ask: "off" | |
exec.security: "full" | |
approvals.exec.enabled: false |
改完记得重启网关:
openclaw gateway restart二、端口占用:最容易被忽视的坑
排完权限,第二个坑来了:端口被占满,网关起不来。
报错长这样:
Port 18789 is already in useGateway Runtime: unknown根因就一个:之前的网关进程没关干净,残留的 node.exe 锁死了端口。
解决方案:
# 1. 先强制杀掉所有 node 进程(这步最关键)taskkill /F /IM node.exe /T# 2. 重启网关openclaw gateway restart# 3. 验证状态openclaw gateway status✅ 成功标准:看到 Gateway is running on port 18789
三、配对失败:定时任务的隐形拦路虎
以为重启完就没事了?定时任务一执行:
gateway connect failed: pairing required这是 OpenClaw 的安全机制——新设备必须手动批准,才能操作 cron 等高权限功能。
解决步骤:
# 1. 查看待批准的配对请求openclaw devices list# 2. 批准请求(替换为实际的 Request ID)openclaw devices approve de507d3b-ec1a-479a-89c7-649638c46bde# 3. 重启网关openclaw gateway restart✅ 成功标准:openclaw cron list 返回空列表而不是报错,定时任务引擎才算真正在线。
四、QQ 机器人掉线:网关重启后的连锁反应
网关重启后,QQ 机器人大概率会断线:
Connection failed: Error: Network error getting access_token修复:
# 1. 重启 QQ 机器人服务openclaw bot restart default# 2. 验证状态openclaw bot status✅ 成功标准:状态显示 online
五、验收清单:对着检查,不漏项
• ✅ exec 执行:直接跑命令,无审批、无拦截 • ✅ 网关状态: Gateway is running on port 18789• ✅ 配对状态: openclaw devices list中 Pending 为空• ✅ 定时任务: openclaw cron list返回空列表(不是报错)• ✅ QQ 机器人:状态 online,能正常对话
六、一键修复脚本(建议收藏)
保存为 fix-openclaw.bat,以后出问题双击直接跑:
@echo offchcp 65001 >nulecho ========================================echo OpenClaw 一键修复脚本echo ========================================echo.echo [1/4] 正在终止所有 Node 进程...taskkill /F /IM node.exe /T >nul 2>&1echo 完成!echo.echo [2/4] 正在重启网关服务...openclaw gateway restartecho 完成!echo.echo [3/4] 正在重启 QQ 机器人...openclaw bot restart defaultecho 完成!echo.echo [4/4] 正在验证状态...openclaw gateway statusopenclaw bot statusecho.echo ========================================echo 修复完成!echo ========================================pause写在最后
折腾这一晚上,OpenClaw 的能力是真的强,但 Windows 环境的坑也确实多。
好在问题都有解——配置改对、重启生效、批准配对,三步走完满血复活。
收藏这篇,下次遇到同样问题对照处理,至少省两小时。
如果你在 Windows 上部署 OpenClaw 也遇到过类似问题,欢迎在评论区留言,我们一起交流。
关注【华崟智能科技】,获取更多 AI 实战干货、私有化部署方案、自动化运维技巧。
夜雨聆风