企业官网建设流程全解析

OpenClaw v2026.8.1 OpenProse 移除与迁移指南：从捆绑插件切换到上游 Agent Skill

【免费下载链接】openclawThe AI that really does things. Any OS. Any Platform. The lobster way. 🦞项目地址: https://gitcode.com/GitHub_Trending/cl/openclaw

本指南面向所有曾在 OpenClaw 中使用过捆绑 OpenProse 插件或/prose命令的用户。自 v2026.8.1 起，OpenClaw 不再捆绑 OpenProse 插件与/prose命令，本文完整说明如何清理残留配置、通过第三方skillsCLI 安装官方维护的上游 Agent Skill，以及如何用prose upgrade升级旧版.prose源文件，并解析背后的 Skills 加载机制。

背景：为什么 OpenProse 被移除

OpenClaw 在 v2026.8.1 版本中做出了一个 breaking change：移除了捆绑的 OpenProse 插件及其/prose命令。这一点在 CHANGELOG/2026.8.1.md 的 Changes 一节有明确记载：

OpenProse migration (breaking):remove the bundled OpenProse plugin and/prosecommand; runopenclaw doctor --fixto clean stale configuration and follow the upstream Agent Skill migration, keeping existing.prosesource files. (#128494)

移除的核心理由与迁移方向：

• OpenProse 并未消亡，它继续以上游 Agent Skill（Agent Skill 即由维护者持续更新的技能包）的形式独立演进，只是不再随 OpenClaw 一起分发。
• 你的.prose源文件始终归你所有。被移除的捆绑插件并不在 OpenClaw 的 SQLite 数据库中存放状态，因此无需任何数据库迁移。
• 迁移的本质是"换载体不换资产"：把对捆绑插件 + 斜杠命令的依赖，切换为对上游 Skill + Agent 会话内命令的依赖。

第一步：用 doctor 清理残留的捆绑插件配置

升级到 v2026.8.1 之后，旧配置中可能仍残留与捆绑插件相关的条目。在 OpenClaw 中执行：

openclaw doctor --fix

doctor --fix会自动完成以下清理工作：

• 从**插件允许列表（allowlists）**中移除open-prose；
• 从**插件拒绝列表（denylists）**中移除open-prose；
• 移除残留的插件条目（plugin entries）。

关键点：这一步只动配置、不动数据库。由于捆绑插件不写 OpenClaw SQLite 状态，清理完成后不需要执行任何数据库迁移，你的会话、记忆与历史数据不会受到影响。

第二步：从工作区根目录安装上游 OpenProse Skill

清理完成后，在你的工作区根目录（workspace root）执行以下命令安装上游技能：

npx skills add openprose/prose --skill open-prose --agent codex --copy -y

逐项拆解这条命令（注意：skills是npm 生态的第三方 CLI，不是 OpenClaw 自带命令）：

为什么必须保留--agent codex？该参数值决定了技能写入的目录布局：它会把技能写到共享的.agents/skills目录。OpenClaw 正是读取这一布局来加载项目级 Agent Skill 的——尽管标志名指向另一个 agent，但写入路径是 OpenClaw 认可的标准位置。

安装完成后：

• 技能被复制到.agents/skills/open-prose目录，OpenClaw 会将其作为项目级 Agent Skill加载；
• 它不会恢复被移除的捆绑插件，也不会恢复/prose斜杠命令——此前的斜杠命令工作流已永久切换为 Agent 会话内对话式命令。

第三步：用prose upgrade升级旧版源文件

如果你需要升级旧版（捆绑插件时代）的 OpenProse 源文件，请按以下流程操作：

1. 在工作区中启动一个新的 OpenClaw Agent 会话；
2. 在会话中发送（注意：这是 Agent Skill 内的对话命令，不是 shell 可执行程序，不要在终端直接运行）：

prose upgrade --dry-run

3. 查看--dry-run生成的升级计划，确认无误后，在同一个会话中发送：

prose upgrade

重要限制：上游的 upgrade 命令不会迁移旧的运行时台账（runtime ledgers）或状态。因此请务必：

• 保留你的.prose源文件（它们是你的资产，也是升级的唯一输入）；
• 从一个干净的状态目录（clean state directory）开始新的升级流程，避免新旧状态互相干扰。

深入理解：OpenClaw 的 Skills 加载机制与优先级

要理解"复制到.agents/skills即可生效"这一行为，需要回到 OpenClaw 的 Skills 加载机制。根据 docs/tools/skills.md 的说明，OpenClaw 的 Skill 是"目录中存放一份带 YAML frontmatter 的SKILL.md+ Markdown 正文"的指令文件，加载时按下表从高到低的优先级合并：

这解释了第二步的关键设计：npx skills add ... --agent codex --copy把 OpenProse 写入<workspace>/.agents/skills，即上表中的优先级 2（项目级 Agent 技能），远高于优先级 6 的捆绑技能。因此即使未来再次安装包含技能的插件，OpenProse 的加载优先级也不会被覆盖。

补充几点与迁移直接相关的加载行为（同样出自 docs/tools/skills.md）：

• 当会话使用不同的执行工作区时，OpenClaw 同样会加载该工作区的skills/与.agents/skills/目录；在同一执行工作区内，skills/的优先级高于.agents/skills/；
• 沙箱化运行读取的是物化副本，而非宿主机原始路径；
• 从仓库安装 OpenClaw 本身，不会让该仓库的.agents/skills/变成全局捆绑技能源——技能加载始终以工作区为准。

迁移要点速查与注意事项

相关文档

• Skills 机制详解：加载顺序、优先级、gating 与 allowlist 配置
• Slash 命令：了解为何/prose被移除后斜杠命令体系仍可用
• Lobster 工作流：与 Agent Skill 配套的编排工作流
• v2026.8.1 版本变更记录：OpenProse 移除（#128494）及其他 breaking change 的完整说明

一句话总结：升级到 OpenClaw v2026.8.1 后，先openclaw doctor --fix清理旧配置，再在工作区安装上游open-proseSkill（写入.agents/skills由 OpenClaw 自动加载），最后在 Agent 会话内用prose upgrade --dry-run预览并执行源文件升级——你的.prose资产全程保留，只是运行载体从捆绑插件切换到了社区维护的上游 Skill。

【免费下载链接】openclawThe AI that really does things. Any OS. Any Platform. The lobster way. 🦞项目地址: https://gitcode.com/GitHub_Trending/cl/openclaw