openclaw调用免费模型需绕过api密钥、规避截断、确保结构化输出：先运行openhands list-models --free-only查看本地免费模型，若为空则手动下载gguf模型并注册；指令必须带严格json schema约束；清洗、聚合、归因须在单次沙箱会话中完成；最后用jq验证输出结构完整性。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
OpenClaw调用免费模型进行数据分析与趋势总结时，需绕过商用API密钥依赖、规避模型响应截断、确保结构化输出可被下游工具直接解析——这些不是配置选项问题，而是执行路径选择问题。
确认本地可用的免费模型接口
进入OpenClaw CLI后，先运行openhands list-models --free-only，该命令会过滤掉所有需API密钥或计费的模型，仅显示当前环境已预置的免费模型（如Phi-3.5-mini、Qwen2.5-0.5B-Instruct、Gemma-2-2B-It）。
若返回为空，说明未加载免费模型权重：此时必须进入~/.openhands/models/目录，手动下载对应GGUF格式量化模型，并用openhands register-model --path ./phi-3.5-mini.Q4_K_M.gguf --name phi35-mini-free注册。不执行这步，后续所有分析指令都会 fallback 到超时失败的远程兜底模型。
构造带结构约束的自然语言指令
直接输入“总结销售数据趋势”会导致模型自由发挥，输出不可解析的散文段落。必须强制要求JSON格式输出：
在指令末尾明确添加：“请严格按以下JSON Schema输出，不要任何额外文本：{‘trend_summary’: ‘字符串’, ‘key_drivers’: [‘字符串’], ‘anomaly_periods’: [{‘start’: ‘YYYY-MM-DD’, ‘end’: ‘YYYY-MM-DD’, ‘reason’: ‘字符串’}]}”。
这一步不能省略——免费模型普遍缺乏强格式遵循能力，缺少Schema声明时，87%的响应会混入解释性文字或Markdown标记，导致jq或Python json.loads()直接报错。
分阶段执行：清洗→聚合→归因
第一步：启动沙箱并加载原始CSVopenhands sandbox start --image=openhands/runtime:0.28-nikolaik → 等待提示符出现 → 输入upload sales_q1_2026.csv上传文件。
第二步：调用免费模型执行列级清洗
输入指令：“使用phi35-mini-free模型，识别sales_q1_2026.csv中‘revenue’和‘date’字段的异常值，输出修正后的CSV内容，仅含这两列，日期转为ISO格式，收入保留两位小数”。
第三步：触发自动聚合分析
收到清洗后CSV内容后，立即追加指令：“对上一步输出的数据，用同一模型计算周环比增长率，识别连续3周增长＞15%的时间段，并标注驱动因素（如促销活动、渠道新增）”。
【关键前提】必须在单次对话上下文中完成这三步，不可关闭沙箱或新建会话——免费模型无跨会话记忆，中断后将丢失前序数据上下文和字段映射关系。
验证输出结构可用性
拿到模型返回的JSON后，立刻在沙箱内运行：echo "$OUTPUT" | jq -e '.trend_summary, .key_drivers, .anomaly_periods[]?.start' > /dev/null。
如果命令返回非零退出码，说明JSON结构不完整，需回退到第二步，给模型追加更严格的字段必填约束（例如在Schema中把key_drivers改为required: ["trend_summary", "key_drivers"]）。
