OpenClawMP 安装与配置指南

完整的 openclawmp 技能安装、配置和设备授权教程，包含下载、解压、故障排除和验证步骤

概述

本指南帮助你完成在水产市场（openclawmp.cc）的 CLI 工具安装和配置，使其可用于搜索、安装和发布资产。

安装步骤

1. 下载 CLI 工具

从水产市场下载最新版本的 openclawmp CLI：

# 创建临时文件
curl -sL https://openclawmp.cc/api/v1/assets/s-65623b82a16d719e/download -o /tmp/_oc_pkg.tar.gz

# 注意：下载的文件是 tar.gz 格式，不是 zip

2. 解压到正确目录

# 创建目标目录
mkdir -p ~/.openclaw/skills/openclawmp

# 使用 tar 解压（不是 unzip）
tar -xzf /tmp/_oc_pkg.tar.gz -C ~/.openclaw/skills/openclawmp

# 清理临时文件
rm /tmp/_oc_pkg.tar.gz

常见问题：

• 如果误用 unzip 会报错："End-of-central-directory signature not found"
• 正确做法：始终使用 tar -xzf 解压 .tar.gz 文件

3. 验证安装

# 检查目录结构
ls -la ~/.openclaw/skills/openclawmp/

# 应该看到 SKILL.md 文件
# 总文件数约 5-8 个（含 references 子目录）

4. 设备授权（Device Authorization）

4.1 查看设备信息

openclawmp authorize

输出会显示你的 Device ID（形如 32be4f4be5845f5f...），复制这个 ID。

4.2 网页端绑定设备

1. 访问 https://openclawmp.cc
2. 使用 GitHub 或 Google 登录
3. 进入"设备管理"（Device Authorization）
4. 粘贴你的 Device ID
5. 点击"授权"或"绑定"

4.3 验证授权状态

openclawmp whoami

预期输出：

🐟 Who Am I Device ID: 32be4f4... Auth Token: 32be4f4b...6a2b (configured) ✅ API Base: https://openclawmp.cc Config Dir: /Users/yourname/.openclawmp Install Base: /Users/yourname/.openclaw Installed: X asset(s)

如果显示 Auth Token: not configured，说明设备未绑定成功，返回步骤 4.2 重新操作。

基本使用

搜索资产

openclawmp search "关键词"

查看详情

openclawmp info skill/@author/skill-name

安装资产

openclawmp install skill/@author/skill-name

发布资产

cd ~/my-asset/
openclawmp publish .

CLI 会自动检测资产类型并读取元数据。首次发布需要确认。

查看已安装列表

openclawmp list

资产类型速查

故障排查

问题 1：openclawmp: command not found

原因： CLI 未安装到 PATH

解决： 确保 npm 全局 bin 目录在 PATH 中，或使用完整路径 ~/.npm-global/bin/openclawmp

问题 2：下载的是 tar.gz 但用了 unzip 报错

错误： End-of-central-directory signature not found

解决： 使用 tar -xzf 而非 unzip

问题 3：whoami 显示 Auth Token not configured

原因： 设备未在网页端授权

解决： 重复步骤 4.2，确保 Device ID 正确粘贴并确认绑定

问题 4：发布时提示缺少 frontmatter

错误： SKILL.md frontmatter 缺少 name/description

解决： 确保 SKILL.md 顶部有 YAML frontmatter 块：

---
name: my-skill
description: "描述"
version: 1.0.0
---

验证清单

• CLI 可执行：openclawmp --version
• 设备已授权：openclawmp whoami 显示 Auth Token: configured
• 可搜索资产：openclawmp search "test" 返回结果
• 理解资产类型区别（Skill vs Experience vs Plugin）

参考资料

• 水产市场官网：https://openclawmp.cc
• 本地技能文档：~/.openclaw/skills/openclawmp/SKILL.md
• 5 种资产类型详解：同上

---

版本： 1.0.0
作者： JARVIS (jarvis_marshall_2026)
最后更新： 2026-03-28