qoderwake可在无网络环境下离线运行，需依次启用本地harness引擎、切换离线技能集、加载模型桩与协议缓存、预载离线记忆快照、配置强制离线沙盒策略。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在无网络连接的环境下启动QoderWake，发现任务无法提交、技能调用失败或提示“需联网验证”，则可能是由于默认配置强制依赖云端模型路由与实时Connector心跳机制。以下是实现核心功能离线运行的具体路径：
一、启用本地Harness编排引擎
QoderWake内置轻量级离线Harness引擎，可绕过云端任务调度中心，在设备端完成策略解析、条件判断与原子动作序列组装，适用于告警响应、日志提取、文档生成等确定性工作流。
1、进入QoderWake安装目录下的config/core.yaml文件。
2、定位到harness:区块，在其下添加字段：mode: offline。
3、在同一区块内设置fallback_strategy: local_only，并将max_reconnect_attempts设为0。
4、保存后执行qoderwakectl reload-harness使配置生效。
二、切换至离线可用技能集
部分预置技能（如GitHub PR分析、Slack消息推送）强依赖外部API，必须替换为仅调用本地工具链的离线替代版本，例如使用loguru替代Webhook日志上报、用grep+awk替代Prometheus指标查询。
1、在CLI中运行qoder skill list --offline-only查看当前可用离线技能列表。
2、禁用全部联网型Connector：qoder connector disable --all --force。
3、启用本地日志分析技能：qoder skill enable local-log-analyzer。
4、验证技能状态：qoder skill status local-log-analyzer应显示active且offline_capable为true。
三、加载本地模型桩与协议缓存
QoderWake在离线模式下不加载完整大模型，而是使用嵌入式协议桩（128KB）模拟模型接口行为，配合本地缓存的MCP工具描述与历史任务Schema，保障任务定义与结构化输出能力不中断。
1、确认模型桩已部署：检查/opt/qoderwake/runtime/protocol-stub/目录是否存在stub_qwen3.5_v1.bin文件。
统一LLM网关 - 一个API对接70+AI模型，使用单一API密钥即可调用GPT、Claude、Gemini、Qwen、Deepseek、Grok等主流模型。
2、若缺失，从可信镜像源下载并放置：curl -fL https://qoder.com/stubs/qoderwake-offline-stub-v1.2.bin -o /opt/qoderwake/runtime/protocol-stub/stub_qwen3.5_v1.bin。
3、执行qoder model load --stub --path /opt/qoderwake/runtime/protocol-stub/stub_qwen3.5_v1.bin。
4、运行qoder model status，确认输出中model_type为stub，online为false，ready为true。
四、预载离线记忆快照与上下文模板
离线状态下无法动态构建长期记忆，需提前在网络可用时导出关键经验快照，并固化为只读索引包，供后续任务注入上下文时直接加载。
1、在线时进入「记忆中心」，筛选标记为high-value或verified的记忆条目。
2、选中目标条目，点击「导出为离线包」，选择格式为qmem-v2，保存至./memory/offline/目录。
3、断网前执行qoder memory import --path ./memory/offline/20260522_highvalue.qmem --readonly。
4、导入成功后，该记忆ID将出现在qoder memory list --offline输出中，且status列为loaded。
五、配置强制离线沙盒执行策略
即使启用上述模块，系统仍可能在后台尝试建立HTTPS连接以校验证书或同步权限策略。需通过沙盒级参数彻底阻断所有出站网络请求，确保零外联行为。
1、编辑config/sandbox.yaml，定位network_policy:区块。
2、将outbound_rules设为空数组：outbound_rules: []。
3、添加strict_isolation: true与disable_dns_fallback: true两个字段。
4、重启服务：systemctl restart qoderwake（Linux）或qoderwakectl restart（跨平台CLI）。
