openclaw频繁死机可能原因 openclaw稳定性问题排查|Duuu笔记
面向高级开发者的AI指南，涵盖
OpenClaw AI频繁卡死或退出的五大原因及对应解决方案：一、修正tasks.yaml中timeout_ms为30000+；二、禁用system_exec类skill并设disable_system_calls: true；三、切换至Node.js 21.7.3并npm ci重建依赖；四、调低max_heap_mb至3584，停用内存敏感skill，限制LLM token与速率；五、用winser注册为系统服务，指定低权限账户运行并禁用GUI类skill。
如果您在使用OpenClaw AI时频繁遭遇进程卡死、无响应或自动退出，则可能是由于终端运行环境异常、配置参数失当或资源调度冲突所致。以下是针对该问题的系统性排查与应对步骤：
一、检查并修正定时任务超时配置
OpenClaw定时任务若未设置合理超时阈值，极易触发无限等待回环，导致主线程阻塞与进程假死。该问题在99%用户部署中被忽略，但却是引发频繁死机的首要诱因。
1、打开OpenClaw主目录下的
config/tasks.yaml
文件。
2、定位所有
timeout_ms
字段，确保其值不为
0
或空值。
3、将全局默认超时设为
30000（即30秒）
，对高延迟技能可单独提升至
60000
，但禁止设为无限等待。
4、保存后执行
npx openclaw restart --force
强制重载任务配置。
二、禁用非必要系统级权限调用
OpenClaw在启用
system_exec
或
file_access
类skills时，若缺乏沙箱约束，会因Windows UAC拦截、杀毒软件干预或权限降级失败而突然终止进程。
1、进入
skills/
目录，列出所有启用的skill插件。
2、核查是否存在名称含
shell
、
exec
、
admin
或
registry
的skill。
3、对确认非必需的此类skill，在其
manifest.json
中将
"requires_admin"
字段设为
false
，并将
"privileged"
设为
"none"
。
4、在
config/core.yaml
中添加限制项：
disable_system_calls: true
。
三、切换Node.js运行时版本并锁定依赖
OpenClaw对Node.js 22.x存在已知异步调度缺陷，尤其在Windows平台下易引发Event Loop冻结；而Node.js 20.x则因TLS握手兼容性问题导致API连接超时连锁崩溃。
1、卸载当前Node.js，通过nvm-windows执行
nvm uninstall 22.12.0
与
nvm uninstall 20.15.1
。
Sheet+
Excel和GoogleSheets表格AI处理工具
下载
2、安装经验证稳定的
Node.js 21.7.3
：
nvm install 21.7.3
，再执行
nvm use 21.7.3
。
3、进入OpenClaw根目录，删除
node_modules
与
package-lock.json
。
4、运行
npm ci --no-audit --ignore-scripts
，强制按
package-lock.json
原始哈希重建依赖。
四、关闭内存敏感型插件并限制Token消耗
部分skills（如日志归档、对话快照、多轮记忆增强）会在后台持续申请内存并写入磁盘，当物理内存低于4GB余量时，Windows会强制终止Node.js子进程以保系统稳定。
1、编辑
config/memory.yaml
，将
max_heap_mb
设为
3584
（即3.5GB），避免触发GC风暴。
2、在
skills/
中停用以下插件：
auto-backup
、
context-snapshot
、
token-meter
（即使已安装也需在
enabled
中设为
false
）。
3、于
config/api.yaml
中为每个接入的LLM端点添加
max_tokens_per_call: 1024
与
rate_limit: "5r/m"
硬性限制。
五、启用进程守护模式并隔离运行环境
原生终端运行方式缺乏崩溃恢复机制，一旦发生未捕获异常或SIGINT误触，进程即永久终止；且与用户桌面会话强绑定，锁屏或远程断开将直接中断服务。
1、安装Windows服务管理器：
npm install -g winser
。
2、执行
winser -i -s -a "node .\dist\index.js --mode=service"
，将OpenClaw注册为系统服务。
3、在Windows服务管理器中找到
openclaw-service
，右键属性→“登录”选项卡→勾选
“允许服务与桌面交互”
并指定专用低权限账户运行。
4、禁用所有图形界面相关skill（如
desktop-notifier
、
screenshot-capture
），防止GDI对象泄漏。
