OpenClawAI内存不足时应启用轻量模式、切换超轻量模型、限制进程资源、精简上下文缓存、禁用非必要I/O功能；具体包括设置lite_mode:true、改用qwen3:0.6b模型、ulimit限值、max_turns:3、禁用日志与磁盘缓存。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在运行OpenClawAI时遭遇内存不足（OOM）错误、进程被系统终止、响应延迟或界面冻结，则极可能是物理内存被模型加载、上下文缓存与日志写入共同耗尽。以下是针对低配设备的多种内存优化处理方法：
一、启用轻量化运行模式
该模式通过剥离图形渲染代理、多任务流调度器等非核心组件，仅保留基础指令路由与本地Shell执行能力，可将内存常驻占用压降至512MB以下，适用于2GB内存设备。
1、编辑主配置文件：Linux/macOS路径为/root/.openclaw/openclaw.json；Windows路径为%APPDATA%\openclaw\openclaw.json。
2、在文件顶层JSON对象中添加字段："lite_mode": true。
3、保存文件后，在终端或PowerShell中执行：openclaw restart使配置生效。
二、切换至超轻量模型与推理后端
本地模型推理是内存压力的主要来源。使用参数量低于1.5B的超轻量模型，并搭配Ollama等内存友好的推理引擎，可避免OOM崩溃与长时间阻塞，尤其适配8GB及以下内存设备。
1、通过命令行切换模型：openclawconfig setmodel qwen3:0.6b。
2、若已安装Ollama，执行：ollama run qwen3:0.6b启动专用轻量服务。
3、修改openclaw.json中agents.defaults.model_url字段，指向本地Ollama地址：http://127.0.0.1:11434/api/chat。
三、强制限制进程资源上限
防止OpenClaw后台服务持续抢占全部可用内存与CPU时间片，导致系统界面冻结或SSH断连。必须通过操作系统级手段施加硬性约束，确保其他关键进程仍有可用资源。
1、Windows用户：以管理员身份运行PowerShell，执行：Start-Process -FilePath "node" -ArgumentList "index.js" -WorkingDirectory "C:\openclaw" -WindowStyle Hidden -PriorityClass BelowNormal。
OpenClaw 原生 PDF/文档处理技能，适用于 Nutrient DWS，帮助用户完成 PDF 转换、OCR、文字/表格提取、PII 脱敏等功能。
2、Linux/macOS用户：启动前设置资源限制：ulimit -v 2000000 && ulimit -s 4096 && node index.js（限制虚拟内存2GB、栈大小4MB）。
3、验证限制生效：运行ps -o pid,vsz,rss,nice,comm -C node，确认VSZ（虚拟内存）未突破设定阈值。
四、精简上下文与缓存策略
默认配置下，OpenClaw不主动清洗对话历史，大量无效上下文持续累积，显著抬高内存占用与Token消耗。启用语义感知修剪与严格缓存生命周期可快速释放内存。
1、编辑openclaw-config.yaml，在context节下设置：max_turns: 3（仅保留最近3轮对话）。
2、设置上下文存活时间：ttl: 300（5分钟自动过期）。
3、启用智能修剪策略：pruning_strategy: "smart"，并关闭预加载模型：preload_models: false。
五、禁用非必要I/O密集型功能
低速存储（如5400rpm机械硬盘）在日志轮转、缓存写入、临时文件生成等操作中极易成为性能瓶颈，间接加剧内存压力。关闭日志持久化与磁盘缓存可降低内存映射区域占用。
1、在openclaw-config.yaml中定位logging节，将file输出设为enabled: false。
2、修改cache节：enabled: false，或仅启用内存内缓存：backend: "memory"。
3、清空现有临时日志目录：rm -rf /tmp/openclaw/（Linux/macOS）或del /q "%TEMP%\openclaw\*"（Windows）。
