ClawPanel v4.4.0 发布：AI 智能助手与模型兼容性修复

后端新增 /api/ai/chat 接口，接收聊天历史和模型选择，调用 OpenClaw 的 AI 模型进行对话：

router.post('/ai/chat', auth, async(req, res)=>{
    const{ messages, providerId, modelId }= req.body;
    // 调用 OpenClaw 模型 API
    const response =await callModel(messages, providerId, modelId);
    res.json({ ok:true, reply: response });
});

🔧 重点修复：非 OpenAI 模型兼容性

问题描述

当用户在 ClawPanel 中切换到非 OpenAI 模型（如火山引擎 Doubao、DeepSeek 等）时，会出现以下错误：

Message ordering conflict - please try again. If this persists, use /new to start a fresh session. 

底层错误为：

invalid value: developer (expected one of: system, user, assistant) 

根因分析

OpenClaw 使用 @mariozechner/pi-ai 库与模型 API 通信。该库在构造请求时，对于启用了 reasoning: true 的模型，会将系统提示词的角色设置为 developer：

// @mariozechner/pi-ai/dist/providers/openai-completions.js
const useDeveloperRole = model.reasoning && compat.supportsDeveloperRole;
const role = useDeveloperRole ?"developer":"system";

developer 角色是 OpenAI 专有的概念（用于 o1/o3 等推理模型），火山引擎、DeepSeek 等 OpenAI 兼容 API 并不支持。

解决方案（三重保护）

1. 补丁 pi-ai 源码

直接修改 openai-completions.js 和 openai-responses-shared.js，强制使用 system 角色：

// 修改前
const role = useDeveloperRole ?"developer":"system";
// 修改后
const role ="system";
// patched: always use system role for compatibility

2. 配置层注入 compat 标志

在 ClawPanel 后端保存配置时，自动为所有非 OpenAI 提供商注入兼容性标志：

function patchModelsJsonCompat(){
    const modelsPath = path.join(ocDir,'agents','main','agent','models.json');
    const data =JSON.parse(fs.readFileSync(modelsPath,'utf-8'));
    for(const[, prov]of Object.entries(data?.providers ||{})){
        const isNativeOpenAI =(prov.baseUrl ||'').includes('api.openai.com');
        if(!isNativeOpenAI){
            for(const m of prov.models){
                if(!m.compat) m.compat ={}; 
                m.compat.supportsDeveloperRole =false;
            }
        }
    } 
    fs.writeFileSync(modelsPath,JSON.stringify(data,null,2));
}

3. 设置 reasoning=false

对于非 OpenAI 模型，将 reasoning 设置为 false，从根源上避免触发 developer 角色逻辑。

为什么需要三重保护？

🎨 UI 优化：技能中心布局

问题

技能和插件卡片在小屏幕上，启用/禁用的开关按钮会被推到屏幕外，需要水平滚动才能看到。

修复

使用 shrink-0 确保开关按钮永远不会被压缩，同时优化 flex 布局：

<div className="flex items-center gap-2 shrink-0 ml-2"> 
    <button onClick={() => toggleSkill(skill.id)} className="shrink-0"> 
        {skill.enabled ? <ToggleRight size={36} /> : <ToggleLeft size={36} />} 
    </button> 
</div> 

📦 如何更新

Docker 用户

cd ClawPanel 
git pull 
docker compose up -d --build 

原生安装用户

cd ClawPanel 
git pull 
npm run build --prefix web 
npm run build --prefix server 
# 重启 ClawPanel 服务

火山引擎/DeepSeek 用户额外步骤

如果你使用火山引擎或 DeepSeek 等非 OpenAI 模型，更新后需要：

1. 在 ClawPanel 系统配置 → 模型配置中保存一次配置（触发自动兼容性修复）
2. 重启网关

🔗 相关链接

• GitHub：https://github.com/zhaoxinyi02/ClawPanel
• 完整更新日志：CHANGELOG

ClawPanel — 比官方控制台更强大的 OpenClaw 可视化管理工具。

本项目仅供学习研究使用，严禁商用。