—# OpenClaw 2026.5.9-beta.1 发布：12 项核心更新与 AI Agent 开发实战指南
一句话总结：本次更新聚焦开发者体验与多平台集成，通过增强的插件系统、统一的模型目录管理、以及更智能的 CLI 错误提示，让 AI Agent 的构建和部署更加高效。
无论你是正在搭建企业级 LLM 工作流，还是优化 Discord/Telegram 机器人交互，这篇指南将帮你快速掌握关键变更。
—
一、Chat 命令增强：更灵活的会话控制
1.1 快速切换思考模式
新版本新增了 /think default 和 /fast default 命令，用于清除会话级别的覆盖设置，恢复为配置或提供商的默认值。
清除当前会话的 think 模式覆盖，继承默认配置
/think default
清除 fast 模式覆盖，恢复 provider 默认行为
/fast default
适用场景：当你在调试复杂 Agent 工作流时，可能需要临时切换推理深度，结束后快速回归标准配置，避免手动重置每个参数。
—
二、插件系统重大升级
2.1 统一模型目录注册（Plugin SDK）
这是本次更新的核心架构改进。OpenClaw 现在支持文本、图像、视频、音乐四类提供商的统一注册：
| 能力类型 | 注册方式 | 关键特性 |
|———|———|———|
| 文本模型 | providerCatalogEntry | 动态上下文窗口检测 |
| 图像生成 | 共享媒体列表帮助 | 实时目录缓存 |
| 视频生成 | 覆盖层配置 | 按模型视频能力筛选 |
| 音乐生成 | 同上 | 多提供商并行支持 |
// 示例：providerCatalogEntry 配置片段
{
"providerCatalogEntry": {
"id": "gpt-5.5",
"capabilities": {
"text": true,
"vision": true,
"video": false // 通过覆盖层动态调整
},
"contextWindow": 128000 // 运行时从 ${baseUrl}/models 获取
}
}
2.2 ACPX 插件：安全的参数传递
ACPX（Agent Communication Protocol eXtended）现在支持可选的 args 数组，解决路径和标志值含空格时的解析问题：
agents.config.yaml
agents:
code-reviewer:
command: "node"
args: # 新增：保持含空格路径完整
- "/path with spaces/bin/acp-agent.js"
- "--flag=value with spaces"
2.3 新增 oc-path 插件
内置的 oc-path 插件提供 openclaw path 命令，支持通过 oc:// 协议精确访问工作区文件：
读取 markdown 配置
openclaw path oc://config/readme.md
解析 JSONC（支持注释的 JSON）
openclaw path oc://settings.jsonc
流式读取 JSONL 日志
openclaw path oc://logs/events.jsonl
—
三、GitHub Copilot 集成优化
3.1 动态模型目录发现
Copilot 集成现在优先从 ${baseUrl}/models 获取实时模型目录，确保：
- 按账户权限显示可用模型
- 准确的上下文窗口数值
- 新增
gpt-5.5到静态备用清单
当 API 不可达时自动回退静态配置
export OPENCLAW_COPILOT_DISCOVERY=auto # default: auto
—
四、渠道适配改进：Telegram 与飞书
4.1 Telegram 配额统一管控
grammY API 节流器现在跨轮询和临时发送客户端共享，解决同一 bot token 的多客户端配额冲突：
// 内部实现：共享 Throttler 实例
const throttler = apiThrottler({
group: { maxConcurrent: 3, minTime: 1000 },
out: { maxConcurrent: 30, minTime: 25 }
});
// 轮询客户端
const pollingBot = new Bot(token, { client: { apiRoot, throttler } });
// CLI 临时发送客户端
const cliBot = new Bot(token, { client: { apiRoot, throttler } }); // 同一节流器
4.2 推理预览可控性
Telegram 和 飞书（Feishu） 渠道现在尊重 reasoningDefault 配置，控制推理过程是否流式展示：
全局配置
channels:
telegram:
reasoningDefault: "stream" # stream | hide | collapse
按 Agent 覆盖
agents:
deep-researcher:
reasoningDefault: "hide" # 隐藏中间推理，直接输出结论
—
五、主动记忆（Active Memory）精细化
5.1 自定义记忆插件工具白名单
支持通过 toolsAllow 精确控制召回工具，同时保持向后兼容：
plugins:
entries:
active-memory:
config:
toolsAllow: ["custom_search", "vector_query"] # 自定义工具
# 未配置时默认使用 memory_search / memory_get
slots:
memory: "memory-lancedb" # 自动保留 memory_recall 兼容性
—
六、开发者体验：CLI 错误诊断
6.1 全链路错误指引
解析、启动、配置、护栏、渠道、Agent、任务、会话、MCP 失败时，CLI 现在提供：
❌ Error: MCP server connection refused at localhost:3000
📋 What happened: The configured MCP server "filesystem" is not reachable.
🔧 Recovery:
1. Check server status: openclaw mcp status filesystem
2. Restart server: openclaw mcp restart filesystem
3. Or disable temporarily: openclaw config set mcp.servers.filesystem.enabled false
—
七、依赖更新与安全
关键依赖升级清单：
| 包名 | 旧版本 | 新版本 | 影响 |
|—–|——–|——–|——|
| @openai/codex | – | 0.130.0 | 代码生成能力增强 |
| AWS SDK | – | 3.1044.0 | 新服务支持 |
| OpenTelemetry | – | 0.217.0 | 可观测性改进 |
| Vite | – | 8.0.11 | 构建性能优化 |
—
常见问题（FAQ）
Q1: 如何从旧版本迁移到 2026.5.9-beta.1？
核心变更在于插件配置格式。建议步骤：
1. 备份现有 agents.config.yaml
2. 运行 openclaw doctor 检测兼容性
3. 按 CLI 提示逐项修复
Q2: 统一模型目录对现有工作流有何影响？
现有静态配置完全兼容。新功能为增量增强：启用动态发现后，OpenClaw 会自动合并远程目录与本地覆盖，优先级为：本地配置 > 远程发现 > 静态清单。
Q3: 能否在 Docker 中测试新插件安装流程？
可以。本次更新专门增加了 Docker 按需安装和实时插件工具依赖的 E2E 测试通道：
docker run -e PLUGIN_TEST_REGISTRY=local \
-e PLUGIN_TEST_ARTIFACT=/tmp/my-plugin.tgz \
openclaw/openclaw:2026.5.9-beta.1 \
openclaw plugin install my-plugin --test-mode
Q4: Telegram 节流器共享后，高频消息会丢失吗？
不会。节流器仅控制并发请求速率，不丢弃消息。超出配额的消息会排队等待，CLI 和轮询客户端共享同一队列，确保消息顺序一致。
Q5: oc-path 插件与直接文件读取有何区别？
oc:// 协议提供：
- 跨平台路径规范化（Windows/Unix）
- 自动检测文件编码
- 内置 JSONC/JSONL 解析
- 与 OpenClaw 权限系统集成
—
总结与下一步
OpenClaw 2026.5.9-beta.1 的核心价值在于降低 AI Agent 全生命周期管理复杂度——从开发时的插件调试，到部署后的多渠道适配，再到运维阶段的故障诊断。
建议行动：
1. 升级至最新 beta 版本
2. 试用 oc-path 插件优化配置管理
3. 评估统一模型目录对现有架构的增益
—
相关阅读
—
参考来源
