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 SkillAgent Skill 即由维护者持续更新的技能包的形式独立演进只是不再随 OpenClaw 一起分发。你的.prose源文件始终归你所有。被移除的捆绑插件并不在 OpenClaw 的 SQLite 数据库中存放状态因此无需任何数据库迁移。迁移的本质是换载体不换资产把对捆绑插件 斜杠命令的依赖切换为对上游 Skill Agent 会话内命令的依赖。第一步用 doctor 清理残留的捆绑插件配置升级到 v2026.8.1 之后旧配置中可能仍残留与捆绑插件相关的条目。在 OpenClaw 中执行openclaw doctor --fixdoctor --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 自带命令参数作用openprose/prose指定上游技能仓库与技能名--skill open-prose以open-prose作为安装后的技能名称--agent codex写入共享的.agents/skills布局详见下文说明--copy以复制方式将技能内容拷贝到目标目录-y自动确认所有交互提示为什么必须保留--agent codex该参数值决定了技能写入的目录布局它会把技能写到共享的.agents/skills目录。OpenClaw 正是读取这一布局来加载项目级 Agent Skill 的——尽管标志名指向另一个 agent但写入路径是 OpenClaw 认可的标准位置。安装完成后技能被复制到.agents/skills/open-prose目录OpenClaw 会将其作为项目级 Agent Skill加载它不会恢复被移除的捆绑插件也不会恢复/prose斜杠命令——此前的斜杠命令工作流已永久切换为 Agent 会话内对话式命令。第三步用prose upgrade升级旧版源文件如果你需要升级旧版捆绑插件时代的 OpenProse 源文件请按以下流程操作在工作区中启动一个新的 OpenClaw Agent 会话在会话中发送注意这是 Agent Skill 内的对话命令不是 shell 可执行程序不要在终端直接运行prose upgrade --dry-run查看--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 正文的指令文件加载时按下表从高到低的优先级合并优先级来源路径1 — 最高工作区技能workspace/skills2项目级 Agent 技能workspace/.agents/skills3个人级 Agent 技能~/.agents/skills仅默认状态4托管/本地技能state-dir/skills5Workshop 技能state-dir/agents/agentId/agent/workshop-skills6捆绑技能随安装自带6Custodian 技能随安装自带仅配置了 Custodian Agent 时使用7 — 最低额外目录skills.load.extraDirs 插件技能这解释了第二步的关键设计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/变成全局捆绑技能源——技能加载始终以工作区为准。迁移要点速查与注意事项事项说明版本前提迁移流程针对 v2026.8.1 及之后版本该版本起不再捆绑 OpenProse数据库无需迁移捆绑插件不写 SQLite 状态配置清理openclaw doctor --fix移除open-prose的 allowlist/denylist/插件条目技能安装npx skills add openprose/prose --skill open-prose --agent codex --copy -y第三方 CLI工作区根目录执行技能位置复制到.agents/skills/open-prose按项目级 Agent Skill 加载命令变化/prose斜杠命令不再可用改为在 Agent 会话内发送prose upgrade --dry-run/prose upgrade数据资产.prose源文件保留自持上游 upgrade 不迁移旧运行时台账需从干净状态目录开始相关文档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创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
