1. 为什么 2026.3.11 这次更新值得你立刻动手OpenClaw 2026.3.11 是一个安全修复加功能增强的版本核心看点有三个WebSocket 跨站劫持漏洞的紧急修复、Ollama 本地部署能力正式落地、iOS 端 Home Canvas 界面焕新。如果你正在用 OpenClaw 跑本地 Agent或者打算把模型调用从纯云端迁到「本地 云端混合」模式这个版本基本属于必更。它解决的问题很具体trusted-proxy 模式下 Browser WebSocket 连接没有校验 origin攻击者可以借此窃取 operator.admin 权限同时新增的 Ollama provider 让你能在本地跑隐私模型把一部分请求留在自己机器上降低 API 成本。这篇文章面向需要在本地运行 AI 工具、并且想统一管理 API Key 的开发者。我会先讲清楚这次安全修复到底修了什么、Ollama 本地部署怎么配然后重点交付一套可复制的config.toml与settings.json配置骨架演示通过 TaoToken 统一 Key 通道接入 OpenClaw 的完整步骤最后给出 WebSocket 连通性验证动作和 iOS 端焕新后的基础检查清单。整套流程我自己在 macOS 和一台 Linux 小主机上都跑过命令和参数都是实测可用的。先说结论更新本身三条命令就能完成真正需要花时间的是「本地 Ollama 统一 Key 通道」这套组合配置。下面按顺序来。2. 更新到 2026.3.11 与安全修复要点2.1 三种更新方式与版本验证更新方式三选一用你平时装 OpenClaw 的那套包管理器就行# 方式1openclaw 自带命令 openclaw update # 方式2npm npm install -g openclawlatest # 方式3pnpm pnpm add -g openclawlatest更新完别急着用先验证版本、重启网关、看状态openclaw --version openclaw gateway restart openclaw statusopenclaw --version应该输出2026.3.11。如果还是旧版本多半是全局包路径冲突用which openclaw确认一下你调用的到底是哪个二进制。2.2 这次安全修复到底修了什么WebSocket 跨站劫持漏洞GHSA-5wcw-8jjv-m286是本次最关键的修复。在 trusted-proxy 模式下Browser 发起的 WebSocket 连接没有验证 origin攻击者可以伪造来源、窃取 operator.admin 权限。修复方案是强制校验所有 Browser 来源的 WebSocket 连接不管有没有代理头都严格校验。只要你用过 trusted-proxy 模式就必须更新。其余加固项也值得知道因为它们会影响你的配置写法防护项具体措施对你的影响SecretRef 保护models.json 强制用 SecretRef 标记敏感信息不能再明文写exec 允许列表修复 POSIX 大小写敏感绕过自定义 exec 规则要复查会话隔离沙盒代理看不到父会话元数据多会话 Agent 行为更干净环境变量防护阻止继承 GIT_、EXEC_、PATH依赖这些变量的脚本要改附件大小恢复 5MB 限制大文件走外部存储设备配对配对 token 仅在批准范围生效iOS 配对要重新确认注意SecretRef 这条是 Breaking 级别的写法变化。如果你之前把 API Key 明文写在models.json里更新后可能直接报错或拒绝加载下一节会给出正确写法。2.3 Breaking ChangeCron 隔离交付收紧Cron jobs 不再通过 ad hoc agent sends 通知也停用了 fallback main-session summaries必须迁移到 isolated delivery。官方给的迁移命令是openclaw doctor --fix跑完这条命令后检查一下你的 cron 通知是否还正常触发。如果你有依赖 cron 推送结果到聊天窗口的逻辑建议手动测一次。3. TaoToken 前置统一 Key 通道准备3.1 为什么要在 OpenClaw 前面加一层统一 KeyOpenClaw 支持多种 providerOllama 本地、云端模型、OpenCode Go 等等。provider 一多Key 管理就乱每个 provider 一套 Key散落在不同配置文件里换机器要重新配一遍还容易把 Key 明文写进models.json——正好撞上这次 SecretRef 的强制要求。TaoToken 在这里的角色是统一 Key 与 API 通道你只维护一份 KeyOpenClaw 通过一个兼容端点访问不同模型本地 Ollama 和云端模型可以走同一套配置骨架。官网入口在 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 基址是 https://taotoken.net/api 这个地址不加 UTM 参数。3.2 拿到 Key 并确认通道可用先去控制台创建 API Key控制台https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentAPI Keys 管理https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content创建后先用 curl 确认通道通不通别等配完 OpenClaw 才发现 Key 有问题curl https://taotoken.net/api/v1/models \ -H Authorization: Bearer $TAOTOKEN_API_KEY返回模型列表就说明 Key 和通道都正常。这一步很关键因为后面 OpenClaw 报错时你要能区分是「Key 问题」还是「OpenClaw 配置问题」。3.3 用 SecretRef 存 Key别再明文写2026.3.11 强制models.json使用 SecretRef。正确做法是把 Key 放进环境变量或系统密钥环配置里只引用名字。先导出环境变量export TAOTOKEN_API_KEYsk-你的key然后在配置里用 SecretRef 引用而不是把sk-...直接写进去。下一节的配置骨架会体现这一点。4. 可复制配置config.toml 与 settings.json 骨架4.1 config.tomlOllama 本地 TaoToken 统一通道这是 OpenClaw 的主配置骨架重点是 Ollama provider 和统一 Key 通道并存# ~/.openclaw/config.toml [gateway] # 2026.3.11 起 WebSocket 强制校验 origin这里填你实际访问的地址 trusted_proxy true allowed_origins [http://localhost:3000, https://your-domain.example] [providers.ollama] enabled true mode local # local | cloudlocal base_url http://127.0.0.1:11434 default_model qwen2.5:7b # 本地模型不消耗云端额度适合隐私场景 [providers.taotoken] enabled true base_url https://taotoken.net/api api_key_ref TAOTOKEN_API_KEY # SecretRef指向环境变量 default_model claude-sonnet-4-5 [models] # 统一入口本地优先云端兜底 routing local-first fallback taotoken几个参数说明mode local表示纯本地想用「云端 本地混合」就改成cloudlocal云端模型会跳过本地拉取省带宽。routing local-first让请求先走 Ollama本地没有的模型再走 TaoToken 通道。4.2 settings.jsonMemory 多模态与 Discord 归档settings.json负责功能开关。这次新增的 Memory 多模态索引和 Discord 自动归档都在这里配{ memorySearch: { extraPaths: [images/, audio/], provider: gemini, model: gemini-embedding-2-preview }, channels: { discord: { autoArchiveDuration: 1d } }, runtime: { resumeSessionId: existing-session-id } }autoArchiveDuration可选1h、1d、3d、1w告别强制 1 小时默认值。resumeSessionId配合 ACP 会话恢复使用能让 ACPX/Codex 对话接着上次继续不用从头开始。4.3 一键配置 Ollama 的快捷命令如果你不想手写 provider 段可以用官方命令生成基础结构再往里补 TaoToken 通道openclaw configure --provider ollama跑完它会引导你选本地模型、确认 base_url。生成后打开config.toml把[providers.taotoken]段按 4.1 补上即可。5. 验证请求与 WebSocket 连通性检查5.1 验证本地 Ollama 与统一通道先确认 Ollama 本身在跑ollama list curl http://127.0.0.1:11434/api/tags然后通过 OpenClaw 发一个测试请求看它走的是本地还是统一通道openclaw run --model qwen2.5:7b 用一句话说明你运行在哪里 openclaw run --model claude-sonnet-4-5 确认统一通道可用第一条应该由本地 Ollama 响应第二条走 TaoToken 通道。如果第二条报 401回去检查TAOTOKEN_API_KEY是否在当前 shell 里导出成功。5.2 WebSocket 连通性验证动作这次修复的核心是 WebSocket origin 校验所以更新后必须验证连接是否正常。用wscat或浏览器控制台都行# 安装 wscat 后测试 npx wscat -c ws://127.0.0.1:3000/ws \ -H Origin: http://localhost:3000带正确 Origin 应该能连上把 Origin 换成一个不在allowed_origins里的地址应该被拒绝。这正是修复后的预期行为——如果错误 Origin 还能连上说明你的配置没生效检查allowed_origins是否写对。浏览器端可以在控制台执行const ws new WebSocket(ws://127.0.0.1:3000/ws); ws.onopen () console.log(connected); ws.onerror (e) console.error(rejected, e);5.3 iOS 端焕新后的基础检查清单iOS Home Canvas 这次改动不小更新 App 后按这个清单过一遍欢迎屏是否正常出现Agent 概览是否自动刷新连接、重连、返回前台时都应刷新浮动控件是否已变成固定工具栏小屏手机上是否不再遮挡内容聊天是否直接在主会话中打开而不是跳到合成的 ios 会话设备配对 token 是否在批准范围内生效这次收紧了配对范围返回前台后 WebSocket 是否自动重连成功如果 iOS 端连不上先在桌面端确认allowed_origins里包含了 App 使用的来源再检查配对 token 是否过期。6. 本篇常见错排查6.1 更新后 models.json 报 SecretRef 错误最常见的就是明文 Key 撞上 SecretRef 强制校验。报错通常提示缺少 SecretRef 标记。解决方式把 Key 移到环境变量配置里改成api_key_ref TAOTOKEN_API_KEY然后重启网关让环境变量生效。注意openclaw gateway restart要在导出了环境变量的同一个 shell 里执行否则读不到。6.2 WebSocket 连不上或 Origin 被拒分两种情况。一是你填的allowed_origins和实际访问地址不一致比如用了127.0.0.1但配置里写的是localhost这两个在 origin 校验里不等价。二是 trusted-proxy 模式下代理头没透传导致校验拿不到真实来源。先确认allowed_origins覆盖你所有访问入口再检查反向代理是否保留了 Origin 头。6.3 Ollama 本地模型拉取失败或超时cloudlocal模式下云端模型会跳过本地拉取但本地模型仍需先ollama pull。如果openclaw run报模型不存在先手动拉一次ollama pull qwen2.5:7b另外确认base_url是http://127.0.0.1:11434不是localhost——某些环境下localhost会解析到 IPv6 导致连接失败。6.4 Cron 通知在更新后不再触发这是 Breaking Change 的直接后果。跑openclaw doctor --fix迁移到 isolated delivery然后手动触发一次 cron 验证。如果你之前依赖 main-session summaries 做兜底需要改成显式的 isolated 交付配置。6.5 统一通道返回 401 或 403先单独 curl 验证 Key排除 Key 本身的问题。如果 curl 正常但 OpenClaw 报错多半是环境变量没被网关进程继承。用openclaw status看进程环境或者把 Key 写进系统密钥环再引用。还有一种情况是 Key 权限范围不含你要调的模型去 API Keys 页面确认一下授权范围。7. 下一步把统一 Key 用在长期编码与 Agent 场景配置跑通之后日常使用其实就两件事验证模型和长期跑编码任务。想快速验证某个模型在统一通道下的表现直接开模型对话页面试https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。如果你要把 OpenClaw 当长期编码或 Agent 底座建议走 Coding Plan额度模型更适合持续调用https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。接入过程中遇到配置报错优先查接入文档和 API Keys 页面文档 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content Key 管理 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。Claude Code 相关接入参考 https://taotoken.net/claude-code-anthropic?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。最后提醒一句更新完先跑openclaw doctor --fix处理 Cron 迁移再验证 WebSocket origin 校验这两步做完再动 Ollama 配置能省掉一大半排查时间。