3.28

OpenClaw 3.28

版本更新详解 — 2026年3月29日

2
重大变更
10
更新与改进
ClawHub
插件安装优先来源
xAI
Responses API + x_search搜索

github.com/openclaw/openclaw · Released 2026-03-29

Qwen Portal Auth — REMOVED Migrate to Model Studio Doctor Auto-Migration — CUT Configs >2 months old now FAIL

重大变更

Qwen Portal认证已移除

The qwen-portal-auth OAuth integration for portal.qwen.ai is gone. 如果您使用Qwen，必须迁移：

openclaw onboard --auth-choice modelstudio-api-key

Model Studio API密钥是新的标准方式。
Doctor配置迁移断崖

OpenClaw Doctor不再自动重写超过2个月的配置键。 Very old legacy keys now 验证失败 而不是被静默修复。

Run openclaw doctor --fix before upgrading if you haven't touched your config recently.
如果您使用Qwen或超过2个月未运行doctor，需要手动操作。
xAI Responses API x_search + auto-enable No manual plugin toggles

xAI / Grok 全面升级

Responses API 迁移
内置xAI提供商现在使用Responses API，而非旧的completions路径。流式传输更好，工具调用更稳定。
x_search — 一等公民
Grok's web search is now a first-class tool: x_search. Auto-enabled from your existing web-search and tool config. 无需再手动开关插件。
新用户引导集成
The Grok web-search plugin now offers optional x_search setup during:
openclaw onboard
openclaw configure --section web

流程中包含x_search模型选择器。
如果您使用Grok：更新后即可享受零配置网络搜索，无需任何额外操作。
ClawHub npm ✓ FIRST fallback only if not on ClawHub

ClawHub优先的插件安装

openclaw plugins install <package> 现在在npm之前优先检查ClawHub for npm-safe package names. 仅在ClawHub没有该包时才回退到npm。
为什么重要

ClawHub packages are OpenClaw-native — they're built against the plugin SDK, tested with the runtime, and follow the skills standard. npm packages may work but aren't guaranteed compatible.

This makes plugins install smarter by default.
对您有什么影响
  • Installing a skill from ClawHub: works the same, just faster
  • Installing an npm-only package: still works, falls back automatically
  • Ambiguous names: ClawHub wins — check clawhub.ai first
Docs: docs.openclaw.ai/tools/clawhub
Slack Teams GChat upload-file

文件上传统一

A single upload-file action now handles file sends across Slack, Microsoft Teams, Google Chat, and BlueBubbles.
Slack
New explicit upload-file action routes through Slack's upload transport. Supports optional filename, title, and comment overrides for channels and DMs.
Microsoft Teams + Google Chat
Both now have explicit upload-file support on the unified file-first send path.
BlueBubbles
File sends exposed through upload-file. Legacy sendAttachment alias kept for backward compatibility.
为什么重要
Previously each channel had its own file send path with different quirks. Now one action works everywhere — simplifies skills and plugins that need to send files cross-platform.
rootless user ~/.local/bin/ openclaw --container ...

Podman — 无根容器简化

变更内容
  • Container setup simplified for the current rootless user
  • Launch helper now installs under ~/.local/bin
  • No more dedicated openclaw service user required
  • Documented workflow: openclaw --container ... host-CLI pattern
影响人群

Anyone running OpenClaw in a Podman rootless container — home servers, NAS boxes, Linux desktops where Docker isn't available or root access is restricted.

The setup is now closer to Docker parity without needing elevated permissions.
Matrix TTS config schema TTS auto-migrate

Matrix TTS + CLI + 配置

Matrix TTS — 语音气泡

自动TTS回复现在以原生Matrix语音气泡发送，而非普通音频文件附件。 Better UX for Matrix users — shows waveform, plays inline.
CLI：config schema命令

New command:
openclaw config schema

打印openclaw.json的完整JSON schema，适用于 openclaw.json. IDE自动补全、验证脚本和配置文档。
TTS配置自动迁移

Legacy speech config auto-migrates on normal reads and secret resolution. Runtime fallback for old bundled TTS API key shapes removed — clean up your config or run openclaw doctor --fix.
memory flush memory-core负责刷新提示

内存插件契约

预压缩内存刷新现在由活跃内存插件契约控制。 memory-core负责刷新提示 — not the agent runtime.
变更内容
  • Pre-compaction flush plan moved behind the memory plugin interface
  • memory-core插件现在控制刷新提示的时机和方式
  • 更清晰的分离：智能体运行时不再硬编码内存刷新逻辑
  • Memory plugins can now customize flush behavior per deployment
为什么重要

This is an architectural cleanup — memory management becomes a first-class plugin concern. Custom memory backends (e.g. vector DBs, remote stores) can now own the full flush lifecycle without patching the core runtime.

对大多数用户：无明显变化。对插件开发者：插件SDK新增接口。
OpenClaw Gateway /v1/models /v1/embeddings /v1/chat

OpenAI兼容层（3.24版本）

3天前发布——网关现在提供完整的OpenAI兼容API接口。
新增接口
  • GET /v1/models — list available models
  • POST /v1/embeddings — embedding generation
  • POST /v1/chat/completions — explicit model override forwarding
  • POST /v1/responses — explicit model override forwarding
解锁的能力
  • 任何OpenAI SDK客户端现在都可以指向您的OpenClaw网关
  • RAG pipelines (LangChain, LlamaIndex, etc.) work out of the box
  • Embedding-based memory and search against your local gateway
  • 在现有应用中直接替换OpenAI API
Point OPENAI_BASE_URL at your gateway. Done.

发布于OpenClaw 3.24 — 2026年3月26日

如何升级 npm i -g openclaw@latest openclaw doctor --fix

如何升级

标准升级

npm i -g openclaw@latest

Then run doctor to fix any config issues:

openclaw doctor --fix
如果您使用Qwen
Migrate to Model Studio before or immediately after upgrading:
openclaw onboard --auth-choice modelstudio-api-key
升级前检查
  • Qwen users: migrate auth first
  • Old configs: run doctor --fix — configs >2 months old will break
  • Matrix users: follow migration guide at docs.openclaw.ai/install/migrating-matrix
  • Plugin authors: migrate to describeMessageTool() for message discovery
其他用户
可以安全升级。 xAI, ClawHub, file uploads, Podman, and memory changes are backward-compatible.

github.com/openclaw/openclaw · 2026.3.28