ClawBot离线缓存配置指南：网络不稳时的完整解决方案
网络波动直接影响AI工具的响应可靠性。当ClawBot在弱网环境下出现延迟、丢包或连接中断，通常暴露了其默认实时同步机制缺乏本地容错层的问题。
解决方案的核心在于构建离线优先的工作流，通过本地化策略降低对实时网络的依赖。以下五项配置能系统性提升其在恶劣网络条件下的鲁棒性。
一、启用本地消息队列缓存
这是构建离线能力的基石。该功能启用一个基于SQLite的持久化消息队列，在网络中断期间将对话数据暂存于本地磁盘。网络恢复后，系统自动重发队列中的消息，确保交互连续性。
配置流程：
1. 定位至ClawBot配置目录：~/.jvs/.openclaw/。
2. 使用文本编辑器打开openclaw.json文件。
3. 在根对象内，添加或修改如下配置节点：
"message_cache": {"enabled": true, "max_size_mb": 50, "retry_interval_sec": 30}
其中，`enabled`开启功能；`max_size_mb`定义缓存文件体积上限；`retry_interval_sec`设置网络恢复后的重试间隔。
4. 保存文件并完全重启ClawBot客户端进程，确保配置加载。
二、切换为离线推理网关模式
若本地部署了vLLM等推理服务，此配置可将所有AI请求定向至本地端点，彻底规避远程网关的不稳定性。这能从根本上消除“网关不可达”类错误。
操作前提：确认本地vLLM服务已运行并监听http://127.0.0.1:8080端口。
1. 编辑~/.jvs/.openclaw/openclaw.json文件，定位"gateway"配置节点。
2. 将"url"字段值修改为："http://127.0.0.1:8080/v1/chat/completions"。
3. 将"mode"字段值设置为："offline"。
4. 移除或注释掉"api_key"字段，离线模式下无需API密钥校验。
三、禁用远程状态心跳与遥测上报
ClawBot默认的心跳与遥测数据上报会在弱网下产生额外超时请求，可能导致界面卡顿或误判离线。关闭这些服务可释放网络带宽。
通过命令行执行：
1. clawdbot config set telemetry.enabled false （禁用遥测数据上报）。
2. clawdbot config set heartbeat.enabled false （禁用状态心跳）。
3. clawdbot config save （持久化配置更改）。
4. 重启ClawBot服务使配置生效。
四、配置本地静态资源映射
Dashboard界面白屏或功能异常常源于CDN资源加载失败。将前端静态资源映射到本地可解决此问题。
1. 进入ClawBot安装目录的resources/static/子目录，确认存在dashboard.bundle.js、styles.css等文件。
2. 在openclaw.json的"ui"节点下添加配置：
"static_base": "file:///home/username/.jvs/.openclaw/resources/static/"
请将路径中的`username`替换为您的实际用户名。
3. 保存后，执行命令：clawdbot ui reload，刷新前端资源加载策略。
五、启用本地会话快照自动保存
此功能提供最终保障。启用后，ClawBot会定期将对话上下文、历史消息及会话状态加密保存至本地。即使遭遇进程崩溃或意外断电，也能从最近快照快速恢复。
1. 在openclaw.json根层级添加：
"session_snapshot": {"enabled": true, "interval_min": 2, "path": "~/.jvs/.openclaw/snapshots/"}
`interval_min`控制自动保存间隔。
2. 确保快照目录存在且具有读写权限。若不存在，执行：mkdir -p ~/.jvs/.openclaw/snapshots。
3. 重启ClawBot客户端以激活自动快照功能。
完成上述五项配置后，ClawBot便具备了应对网络波动的本地化韧性，其核心工作流将不再受制于远程连接质量。