——
OpenClaw v2026.5.10-beta.3 发布：5 大核心更新与 Slack 集成优化实战
OpenClaw 作为开源 AI Agent 自动化平台的领先方案，在 2026.5.10-beta.3 版本中带来了多项关键改进。本次更新聚焦本地模型服务启动、Slack 消息增强、Plugin SDK 重构三大方向，同时强化了 TypeScript 工程规范与构建流程。无论你是构建企业级自动化工作流，还是开发自定义插件，这些更新都将显著提升开发体验。
本文将逐一拆解 5 大核心变化，并提供可直接落地的配置示例。
—
一、本地模型服务按需启动：降低云成本的关键能力
核心改进
新版本在模型层（Models）引入了 localService 启动机制，允许在发送 OpenAI 兼容请求前，按需启动本地模型服务器。这一设计解决了以下痛点：
- 资源浪费：无需 24/7 运行本地模型容器
- 冷启动延迟：通过 one-shot 模型探针（model probes）预检测服务状态
- 多模型切换：不同 Agent 可动态绑定不同本地后端
配置示例
// openclaw.config.ts
export default {
models: {
provider: 'local-llama',
localService: {
// 服务启动命令（支持 Docker 或本地进程）
startupCommand: 'docker run -p 8080:8080 -v ./models:/models ghcr.io/ggml-org/llama.cpp:server',
// 探针配置：启动后验证模型就绪
probe: {
endpoint: 'http://localhost:8080/health',
maxRetries: 30,
intervalMs: 1000
},
// 请求超时与重试
requestTimeout: 60000,
shutdownAfterIdleMs: 300000 // 5分钟空闲后自动关闭
}
}
}
> 适用场景：需要间歇性使用 Llama.cpp、Ollama 或 vLLM 本地部署的团队，可节省 60% 以上的 GPU 计算成本。
—
二、Slack 集成深度优化：消息控制与线程管理
本次更新对 Slack 连接器进行了 4 项关键修复，显著提升企业场景下的机器人交互体验。
2.1 链接预览精细化控制
新增 unfurlLinks 与 unfurlMedia 配置，支持按账户覆盖默认行为：
// slack.config.ts
export const slackConfig = {
accounts: [
{
name: 'production-bot',
token: process.env.SLACK_BOT_TOKEN,
// 全局关闭链接/媒体预览
unfurlLinks: false,
unfurlMedia: false
},
{
name: 'marketing-bot',
token: process.env.SLACK_MARKETING_TOKEN,
// 营销场景保留预览
unfurlLinks: true,
unfurlMedia: true
}
]
}
2.2 线程回复广播机制
通过 replyBroadcast 参数，Agent 可选择将线程回复同步到父频道：
// 在 Agent 技能中调用
await slack.sendMessage({
channel: 'C1234567890',
threadTs: '1234567890.123456',
text: '分析完成，关键结论如下...',
replyBroadcast: true // 同时显示在频道主时间线
});
2.3 提及元数据保留
修复了 Issue #79025：Agent 现在能区分”直接 @机器人”与”线程中提及他人”两种场景，避免误唤醒。
2.4 DM 会话路由规范化
修复了 Issue #80091：向 D... 格式的原生 DM 频道 ID 发送消息时，系统会自动映射到对等用户会话，防止同一对话被拆分为多个会话上下文。
—
三、Plugin SDK 重构：面向未来的插件架构
3.1 废弃公共子路径
开发团队对 SDK 进行了大规模清理，废弃无生产引用的公共子路径，同时保持向后兼容：
| 变更类型 | 说明 | 迁移建议 |
|———|——|———|
| 完全移除 | provider-auth-login | 使用各 provider 自有模块 |
| 标记废弃 | 单/双插件使用的子路径 | 迁移至共享 SDK seams |
| 保留兼容 | barrel/test/zod 导出 | 继续使用，但关注后续公告 |
3.2 运行时模型元数据暴露
插件工具工厂现在可获取当前激活模型的元数据，用于诊断与策略决策：
// my-plugin/tools/diagnostics.ts
import { createTool } from '@openclaw/plugin-sdk';
export const modelInfoTool = createTool({
name: 'getModelDiagnostics',
handler: async ({ runtime }) => {
// 新增：获取运行时模型信息
const modelMeta = runtime.activeModel;
return {
provider: modelMeta.provider, // 'openai' | 'anthropic' | 'local'
modelId: modelMeta.id, // 'gpt-5' | 'claude-sonnet-4' ...
contextWindow: modelMeta.contextWindow,
supportsToolCalling: modelMeta.capabilities.tools
};
}
});
—
四、工程规范升级：TypeScript 与构建流程
4.1 更严格的类型检查
// tsconfig.json 新增检查项
{
"compilerOptions": {
"noImplicitReturns": true, // 禁止隐式返回
"noUncheckedSideEffectImports": true, // 检查副作用导入
"noImplicitOverride": true, // 要求显式 override
"allowUnusedLabels": false // 禁止未使用标签
}
}
4.2 pnpm 11 迁移
工作区全面迁移至 pnpm 11，Docker 与 CI/CD 流程同步更新：
升级本地环境
corepack enable
corepack prepare pnpm@11.0.0 --activate
验证安装
pnpm --version # 应输出 11.x.x
重新安装依赖
rm -rf node_modules pnpm-lock.yaml
pnpm install
4.3 Vitest 严格规则
测试配置启用更严格的 lint 规则，防止常见测试隐患：
// vitest.config.ts
export default {
test: {
lint: {
focused: 'error', // 禁止 .only
disabled: 'error', // 禁止 .skip
conditional: 'warn', // 警告条件测试
hook: 'error', // 规范 hook 使用
matcher: 'error', // 严格匹配器
expectation: 'error' // 验证断言存在
}
}
}
—
五、上下文可视化：/context map 新命令
新增 CLI 命令快速生成会话上下文贡献者树图：
在运行中的 Agent 会话中执行
openclaw context map --format png --output ./context-map.png
输出示例：
Session: deploy-agent-2026-05-10
├── system-prompt (2.3k tokens)
├── slack-history:#devops (8.7k tokens)
├── github-pr:openclaw#80145 (12.1k tokens)
├── mcp-server:postgres-schema (5.4k tokens)
└── memory:deployment-patterns (3.2k tokens)
└── [recalled] 2026-05-08 production incident
> 该功能帮助开发者快速识别上下文膨胀问题，优化 token 使用效率。
—
常见问题 FAQ
Q1: 本地模型服务启动失败如何排查？
检查探针配置的 endpoint 路径是否与本地服务实际暴露的健康检查端点一致。常见本地服务路径：
- Llama.cpp:
/health - Ollama:
/api/tags - vLLM:
/health
Q2: Slack 的 replyBroadcast 与直接发频道消息有何区别？
replyBroadcast 保持消息在线程内的回复关系，同时镜像到父频道；直接发频道消息会创建独立对话，丢失线程上下文。前者适合”结论同步”，后者适合”新开话题”。
Q3: Plugin SDK 废弃的子路径会影响现有插件吗？
不会立即中断。被标记废弃的子路径仍保持可导入，但会在运行时输出警告。建议在未来 2-3 个版本周期内完成迁移，具体替代方案参考 OpenClaw Plugin 迁移指南。
Q4: 如何验证 pnpm 11 迁移成功？
执行 pnpm config get store-dir，确认输出路径包含 pnpm/11 版本标识。同时检查 CI 日志中的 Setup pnpm 步骤版本号。
Q5: /context map 生成的图片可以自定义样式吗？
当前版本仅支持默认样式。如需自定义，可通过 --format json 导出原始数据，使用 D3.js 或 ECharts 自行渲染。
—
总结与下一步
OpenClaw v2026.5.10-beta.3 的核心价值在于：更智能的资源管理（本地模型按需启动）、更精细的平台集成（Slack 消息控制）、更清晰的架构边界（Plugin SDK 重构）。
建议开发者：
1. 立即尝试：本地模型 localService 配置，评估成本优化空间
2. 规划迁移：审查现有插件的 SDK 导入路径，制定废弃项替换计划
3. 关注后续：Telegram 自动化测试框架（QA/Mantis）的完整文档即将发布
—
相关阅读
—
参考来源
