Openclawmp

⚠️ 强制前置步骤：CLI 版本检查与升级

执行任何 openclawmp 操作前，必须先完成此步骤。未完成版本检查和必要的升级，禁止继续执行用户任务。

步骤 1：获取版本信息（必须执行）

openclawmp --version
npm view openclawmp version

步骤 2：版本对比与决策（必须执行）

对比两个命令的输出：

• openclawmp --version = 本地已安装版本
• npm view openclawmp version = 最新稳定版本

决策规则（严格执行）：

情况	动作
本地版本 == 最新版本	✅ 继续执行用户任务
本地版本 < 最新版本	⛔ 必须先升级，升级完成前禁止继续
本地版本不存在	⛔ 必须先安装，安装完成前禁止继续

步骤 3：升级操作（如需要）

当本地版本落后时，执行以下流程：

1. 先告知用户："检测到 CLI 版本过旧（本地 X.X.X，最新 Y.Y.Y），需要先升级才能继续"
2. 执行升级：

   npm install -g openclawmp@latest
   

3. 验证升级：

   openclawmp --version
   

4. 确认版本匹配后，才继续执行用户原始请求

禁止行为：

• ❌ 版本过旧时跳过升级直接执行用户任务
• ❌ 不对比版本就假设本地版本可用
• ❌ 遇到命令失败时才回头检查版本

示例流程：

用户：帮我搜索 xxx
Agent：检测到 openclawmp CLI 版本过旧（本地 0.1.6，最新 1.0.2），需要先升级...
[执行升级]
Agent：升级完成（1.0.2），现在执行搜索...
[执行用户请求]

openclawmp

使用本 Skill 处理明确的 openclawmp 操作任务。回复时聚焦用户目标、执行结果和下一步操作，不要加入产品宣传或重复命令表，除非用户明确要求。

旧版本迁移规则

默认将旧版 openclawmp 使用知识视为可能过期，尤其是以下内容：

• 基于 openclawmp.cc 域名的网页入口、说明文案或操作路径
• 旧版本 openclawmp CLI 的命令、参数、安装方式或行为假设
• 与当前 Skill 中描述不一致的历史流程、历史截图、旧教程或旧命令示例

处理原则：

• 始终以当前这份 Skill 和本机实际 openclawmp CLI 帮助输出为准
• 用户提到旧域名、旧命令或旧流程时，不沿用旧方案继续操作
• 如发现用户明显在参考旧资料，先明确指出该信息已过期，再给出当前版本的替代做法
• 不要把旧版和新版混在一起解释；优先直接给出新版路径、新版命令和新版判断方式

迁移时的默认表述

当用户使用了旧版本知识时，优先按下面的思路回应：

• 明确说明：旧版 openclawmp.cc 域名和旧 CLI 用法已不再作为当前标准
• 明确说明：现在统一按最新版 Skill 和当前 CLI 实际帮助信息执行
• 如果旧命令仍可能让用户困惑，直接补充当前应使用的命令或检查方式
• 如果用户目标本质没变，直接把旧目标映射到新版操作，不要求用户先自行研究差异

迁移动作

当用户受到旧资料影响时，优先帮助用户完成这些迁移动作：

• 检查当前本机 openclawmp CLI 是否可用，并确认实际版本
• 遇到命令、参数或行为不一致时，优先查看当前 CLI 帮助，而不是猜测旧版规则
• 在搜索、安装、发布、鉴权等任务中，统一改用当前 CLI 接受的命令格式
• 在补全 README.md、.metadata.json 或发布说明时，删除或替换旧域名、旧入口和旧版操作描述
• 如果用户只是想完成任务，不需要展开讲历史差异；直接给出新版操作步骤即可

需要主动纠正的旧知识

如果用户消息中出现以下情况，应主动纠正：

• 提到 openclawmp.cc
• 引用与当前 CLI 帮助不一致的命令格式
• 依据旧教程要求继续沿用历史页面、历史入口或历史参数
• 因旧版知识导致对安装、发布、鉴权、资产类型判断产生误解

按需读取参考资料

仅在以下情况读取 references/market-overview.md：

• 用户询问 OpenClaw 水产市场是什么
• 用户询问水产市场与资产体系、CLI、安装或发布的关系
• 用户需要平台背景，才能理解为什么会有多种资产类型

读取该文件后，优先输出：

• 平台定位
• 与资产体系的关系
• 与 openclawmp 的关系

仅在以下情况读取 references/asset-types.md：

• 用户直接询问 skill、plugin、trigger、channel、experience 的区别
• 用户发布资产但不确定 .metadata.json 中的 assetType
• 某个资产同时像工作流、工具接入、触发器或消息通道，类型边界不清

读取该文件后，优先输出：

• 推荐的 assetType
• 一到两句判断理由
• 若仍有歧义，说明还需要用户补充的核心用途

默认不要通读 reference 文件；只有当前任务确实需要平台背景或资产类型判断时再读取对应文件。

描述语言规则

当用户在准备发布资产，或让你补全 README.md、.metadata.json、简介文案、安装说明时：

• 优先使用作者当前材料里最常用的语言
• 如果 SKILL.md、README.md、参考资料或现有说明明显以中文为主，就继续用中文
• 如果现有内容明显以英文为主，就继续用英文
• 只有在用户明确要求切换语言时，才改用另一种语言

如果材料同时混用中英文：

• 以标题、描述段落和主要正文占比最高的语言为准
• 命令、路径、字段名和标识保持原样，不要强行翻译

在帮助用户补全发布文件时：

• displayName 可保持产品名或专有名词原文
• description、README 描述段落、使用说明和发布说明优先沿用作者惯用语言
• 生成 README.md 时，标题后的描述段落应优先说明"这个资产能做什么、解决什么问题、适合什么场景"，不要把"如何安装"写成首要内容
• 如果用户没有明确要求，不必强调"怎么使用这个 skill"；优先总结 skill 内已经覆盖的能力边界、可处理的问题类型和适用场景

先判断用户要做什么

先把用户请求归到以下一种或几种操作：

• 检查 openclawmp 是否已安装
• 检查本地凭证状态
• 写入本地鉴权 token
• 搜索资产
• 查看资产详情
• 安装资产
• 列出本地已安装资产
• 卸载资产
• 发布本地资产目录
• 排查 CLI 配置或环境问题
• 判断资产应归为哪一种类型

如果用户主要在问资产类型差异，先用"资产类型速判"回答；只有在需要更完整定义、边界说明或示例时再读取 references/asset-types.md。

资产类型速判

当用户搜索、安装、发布或讨论资产类型时，使用以下规则快速判断 assetType。

五种资产类型

• skill：面向 agent 的任务执行流程，通常由提示词、步骤、脚本和参考资料组成
• plugin：为 agent 提供代码级工具接入，用于连接 API、服务或 MCP 能力
• trigger：监听事件或按计划调度，在特定时机唤起 agent
• channel：接入消息平台，使 agent 能接收和发送消息
• experience：沉淀实践方案、配置思路或资产组合；当内容更像经验模板而不是重复执行流程时使用

常见区分规则

• skill vs plugin

  • 教 agent "怎么做" 用 skill
  • 给 agent "一个可调用工具" 用 plugin

• skill vs experience

  • 可反复执行的任务流程用 skill
  • 偏配置方案、实践总结、组合思路用 experience

• trigger vs channel

  • 单向事件触发 agent 用 trigger
  • 双向消息收发接入平台用 channel

发布时的判断原则

当用户发布资产但不确定 assetType 时：

• 核心价值是任务执行流程，优先用 skill
• 核心价值是新工具或外部服务接入，优先用 plugin
• 核心价值是定时或事件驱动唤起，优先用 trigger
• 核心价值是聊天平台或消息平台对接，优先用 channel
• 核心价值是经验沉淀、配置模板或组合方案，优先用 experience

如果仍无法判断，不要擅自猜测；要求用户确认资产的核心用途。

判断当前任务是否依赖凭证

通常可在无本地 token 的情况下读取结果的命令：

• openclawmp search
• openclawmp info
• openclawmp list

通常依赖本地 token 的命令：

• openclawmp install
• openclawmp publish
• openclawmp oauth <token>

如果任务大概率依赖凭证，先检查本地凭证状态。若用户明确提供 token 并要求为本地 CLI 写入鉴权信息，优先使用 openclawmp oauth <token>。

检查本地凭证状态

使用：

openclawmp login

除非实际 CLI 输出表明不是这样，否则将该命令理解为"检查本地凭证状态"。

如果用户需要为本地 openclawmp 写入鉴权信息，使用：

openclawmp oauth <token>

将用户提供的 token 写入本地凭证，用于后续 install、publish 等依赖鉴权的操作。执行这一步时：

• 仅在用户明确提供 token 或明确要求写入时执行
• 不要在回复中回显完整 token
• 成功后提示用户可继续执行依赖鉴权的命令

默认凭证路径：

• macOS / Linux：~/.openclaw/hub-credentials.json
• Windows：%USERPROFILE%\.openclaw\hub-credentials.json

如果凭证缺失或无效：

• 说明当前操作依赖可用的本地 token
• 提醒用户通过平台正常流程获取 token，步骤如下：登陆水产市场→点击头像→设置→我的令牌→生成令牌（如有令牌，需先删除再重新生成），最后复制命令给agent
• 不要假装 CLI 可以代替网页完成账号、实名或身份流程

检查并更新当前 skill 到最新版本

• 先检查当前已安装 skill 是否为最新版本
• 检测为最新版本时不需要额外提示
• 如果检测结果表明不是最新版本，优先通过重新执行 install 更新到最新版本
• 更新前说明为什么需要更新，例如旧版本命令、参数、域名说明或发布流程可能已过期
• 更新时优先使用旧版本当前所在目录作为 --target-dir <path>，以覆盖旧版本目录，而不是另外安装到新的默认目录
• 只有在旧版本目录不可访问、不可写或用户明确要求时，才改用其他可访问目录

只收集当前操作真正需要的输入

搜索资产

需要：

• 查询词

命令：

openclawmp search <query>

查看资产详情

需要以下任一项：

• assetId
• 能被 CLI 唯一解析的标识

命令：

openclawmp info <assetId>

安装资产

需要：

• 资产类型
• assetId
• 安装目标目录；优先由 agent 选择自己当前可访问的目录

标准格式：

<type>/<assetId> --target-dir <path>

示例：

openclawmp install skill/7c19dc4c3244418096f1dcb59c93f795 --target-dir ./skills

安装时默认规则：

• 优先显式指定 --target-dir <path>
• 不要默认安装到 CLI 的默认目录
• 如果用户没有指定目录，优先选择 agent 当前会话可访问、后续可继续读取和验证的目录
• 如果用户给出的格式不同，优先参考实际 CLI 帮助输出，不要凭猜测纠正。

列出已安装资产

不需要额外输入。

命令：

openclawmp list

卸载资产

需要：

• 被当前 CLI 接受的卸载目标格式

先按以下形式理解：

openclawmp uninstall <type>/<assetId>

如果本地 CLI 帮助或报错显示格式不同，以真实 CLI 规则为准。

发布资产

需要：

• 本地目录路径

发布前确认目录中存在 .metadata.json。

命令：

openclawmp publish <path> --yes

或者在资产目录内执行：

openclawmp publish .

资产根目录文件要求

在帮助用户创建、检查或发布资产时，要求所有资产类型在上传前都提供根目录 README.md，作为面向人的可读说明。

README.md 用于帮助用户、平台页面和维护者快速理解：

• 该资产解决什么问题
• 该资产提供哪些能力、适合哪些场景
• 需要如何配置

在帮助用户生成或补全 README.md 时：

• 标题后的第一段优先写功能性介绍，而不是安装步骤摘要
• 先让读者理解资产价值，再补充必要的配置或前置条件
• 如果用户没有特别要求，避免把 README.md 写成"安装命令清单"或"示例用法列表"
• 优先总结 skill 已覆盖的能力、处理边界、典型任务类型和适用场景，而不是把 README 写成操作教程

如果用户需要判断 README.md 是否合格，或需要完整结构要求，读取 references/asset-types.md。

发布前校验本地元数据

执行 publish 之前，先检查 .metadata.json，发现明显问题时直接停止。若文件中已存在版本号字段（例如 semver），则在每次发布前先将版本号加 1，再继续发布；默认按语义化版本的补丁位递增，例如 1.0.0 -> 1.0.1。

最小参考结构：

{
  "assetType": "skill",
  "name": "my-skill",
  "displayName": "My Skill",
  "semver": "1.0.0",
  "category": "productivity",
  "tags": ["agent", "automation"]
}

至少检查：

• 文件存在
• JSON 格式合法
• assetType 存在
• name 存在
• displayName 存在
• 若存在 semver，其格式合法，且发布前先将补丁位加 1
• 根目录存在 README.md
• README.md 有一级标题，且标题后的第一段是描述段落

已知 assetType 可选值：

• skill
• plugin
• trigger
• channel
• experience
• trigger
• channel
• experience

如果元数据缺失或非法：

• 不要继续发布
• 明确指出缺少的字段或错误格式
• 需要时帮助用户修复文件

如果用户不确定 assetType，先应用"资产类型速判"；若仍存在歧义，再按需读取 references/asset-types.md 获取更详细的区分规则和示例。

按操作执行

写入本地鉴权 token

需要：

• 用户明确提供的 token

执行：

openclawmp oauth <token>

返回时：

• 说明本地鉴权信息是否写入成功
• 不要回显完整 token
• 需要时建议用户继续执行 openclawmp login、openclawmp install 或 openclawmp publish

搜索

执行：

openclawmp search <query>

返回时优先给出：

• 最相关的结果
• 资产类型
• 后续命令所需的关键标识

如果结果很多，先总结最相关的几项，再建议用户缩小查询范围。

查看详情

执行：

openclawmp info <assetId>

返回时优先给出：

• 名称
• 类型
• 版本（如果有）
• 简介（如果有）
• 可直接使用的安装命令（如果标识清晰）

安装

执行前确认：

• CLI 存在
• 本地凭证在需要时可读
• 目标格式被 CLI 接受
• 优先确定可访问的安装目录

执行：

openclawmp install <type>/<assetId> --target-dir <path>

成功后：

• 明确说明安装成功
• 返回安装目标标识（如果 CLI 有输出）
• 明确告知实际安装路径
• 需要时建议用户继续执行 openclawmp list
• 需要时建议用户在目标目录下继续验证

列表

执行：

openclawmp list

返回时：

• 简洁列出已安装资产
• 如果为空，直接说明当前没有已安装资产
• 如果当前任务安装时显式使用了 --target-dir <path>，同时带上该路径，便于用户和后续 agent 继续访问

卸载

执行：

openclawmp uninstall <type>/<assetId>

执行后：

• 说明是否卸载成功
• 如果失败，尽量归类为目标不存在、参数错误、凭证问题或其他 CLI 错误

发布

执行前确认：

• 目录存在
• .metadata.json 存在且合法
• 若 .metadata.json 中已有版本号字段，已先完成 +1
• 本地凭证在需要时可读

执行：

openclawmp publish <path> --yes

成功后，优先记录并返回以下信息（若 CLI 有输出）：

• assetId
• semver
• 本地 .assetid
• 基于真实发布结果生成的安装命令

如果 CLI 没有清楚给出安装格式，不要自行编造。

明确处理失败场景

CLI 不存在

• 说明 openclawmp 未安装
• 提供安装命令
• 除非用户要求，否则停止在这里

CLI 指令不存在

• 检查是否为最新版本 openclawmp
• 安装最新版本openclawmp后尝试

凭证缺失或无效

• 说明该操作依赖有效的本地 token
• 提示用户用 openclawmp login 检查状态
• 如果用户已经拿到 token 且希望直接写入本地，提示可使用 openclawmp oauth <token>
• 不要声称 CLI 能代替用户完成网页侧登录或实名认证

目录不存在

• 说明给定路径不存在
• 要求用户提供正确路径，或在已知正确路径下继续

.metadata.json 缺失或格式错误

• 明确指出缺少文件、JSON 非法或具体缺失字段
• 在修复前不要继续发布

资产不存在或标识不明确

• 说明当前标识无法解析
• 建议先执行 search，或让用户提供更精确的标识

网络或服务异常

• 简要总结错误
• 不要猜测后台状态
• 建议稍后重试或检查网络/服务状态

控制回复风格

尽量按以下顺序组织对用户的回复：

• 你做了什么
• 是否成功
• 关键输出字段
• 用户下一步最可能需要的命令

对命令、路径、标识和环境变量统一使用代码格式。

不要在回复中加入：

• 产品宣传文案
• 重复的命令表格
• 与当前任务无关的大段资产分类解释
• 与真实 CLI 行为冲突的"固定规则"

以真实 CLI 行为为最高优先级

如果本地 openclawmp 的帮助文本、命令输出或报错与本文档不一致，始终相信 CLI。

当你不确定参数格式或命令行为时：

• 先检查命令帮助
• 简短说明不确定点
• 不要臆造未确认的参数格式

环境变量

仅在用户排查配置问题或切换环境时检查以下变量：

OPENCLAWMP_API_BASE_URL
OPENCLAWMP_BASE_URL
API_BASE_URL
NEXT_PUBLIC_API_BASE_URL

如果与当前任务无关，不要主动展开环境变量说明。