QClaw纯文本配置文件粘贴兼容详解

QClaw粘贴JSON配置不生效，很多用户都遇到过。根本原因在于JSON解析器对格式要求极为严格。哪怕一个肉眼很难发现的中文全角标点，或者末尾多了一个逗号，都可能导致整段配置被静默丢弃——界面上不会报错，看起来“粘贴成功”，但设置没有任何变化。

因此，如果你从论坛或群聊复制了一段纯文本配置，粘贴后发现无效，不妨按下面几层原因逐一排查。

确认配置片段是否为合法JSON结构

首先，打开记事本或VS Code，把复制的文本粘贴进去，仔细检查：是否有缺失引号？逗号是否放错了位置？有没有混入中文标点？末尾是否多了一个逗号？这些都是最容易出错的地方。

任何非法字符或结构，都会导致整段配置被解读器直接忽略，且不给出任何提示。 你可以用在线JSON校验工具（比如jsonlint.com）快速验证一下，修复后再尝试。

这一步虽然基础，但能帮你省掉后面绝大部分的排查时间。

在QClaw中正确执行粘贴操作

操作路径并不复杂，但有几个容易忽略的关键点。

第一步：打开QClaw，点击左上角的「设置」，进入「大模型配置」页面，找到目标模型条目右侧的「编辑」按钮并点击。

第二步：在弹出的编辑窗口中找到「高级配置（JSON）」文本框。注意：不是「API Key」或「Base URL」输入框，必须是那个专门标注为JSON格式的区域。

第三步：先把文本框里的原有内容清空，然后将校验通过的纯文本配置完整粘贴进去。确保开头是{、结尾是}，并且没有多余的空行或空格包裹。

第四步：点击右下角的「保存」按钮。此时QClaw会立即解析并应用这些字段。如果配置是合法的，对应的参数（比如temperature、max_tokens）就会同步更新到上方的表单控件中。如果保存后参数毫无变化，说明配置仍然存在隐藏的格式问题。

处理跨版本字段兼容性

这是另一个容易被忽视的环节。不同版本的QClaw对配置字段的识别能力并不完全相同。

方法一：手动剥离实验性字段
内测版导出的配置经常会包含一些非标准字段，比如"stream_timeout_ms"、"retry_strategy"等。官方版遇到这类字段通常会直接忽略，但某些旧版QClaw可能会因为无法识别这些字段而拒绝加载整个配置块。遇到保存失败的情况，可以打开JSON文本，删掉所有非api_key、base_url、model、temperature、max_tokens、top_p的字段，只保留这最核心的六项即可。

方法二：利用「粘贴配置」快捷入口
在「大模型配置」列表页，直接点击某条目的「⋯」→「粘贴配置」。这个快捷入口内置了字段白名单过滤功能，比手动粘贴到JSON框里更稳定——它会自动跳过所有当前版本无法识别的字段，只保留QClaw能处理的核心参数。如果手动粘贴反复不成功，不妨试试这个入口，往往能一举解决问题。