安装指南

1. ClawHub CLI 从源直接安装技能的最快方式。
   npx clawhub@latest install nexus-repository-skill
2. 手动安装 将技能文件夹复制到以下位置之一
   全局模式
   ~/.openclaw/skills/
   工作区
   /skills/
   优先级：工作区 > 本地 > 内置
3. 提示词安装 将此提示词复制到 OpenClaw 即可自动安装。
   请帮我使用 Clawhub 安装 nexus-repository-skill。如果尚未安装 Clawhub，请先安装（npm i -g clawhub）。
   更倾向于下载？
   获取包含原生技能文件的ZIP压缩包。
   下载技能 (.zip)

什么是

Nexus Skills 通过 REST API 和独立的 Python CLI 连接到 Sonatype Nexus Repository Manager 3。可使用它列出仓库、搜索组件和资产、浏览仓库中的组件、将文件上传到 raw hosted 仓库、下载资产以及删除组件。
作为 Openclaw Skills 的一部分，它将常见的制品管理任务转化为可执行的 CLI 操作，并提供 JSON 输出和明确的失败信号。它支持 Nexus Repository 3.0 及更高版本；不支持 Nexus Repository 2。

应用场景

列出可用的 Nexus 仓库，或查看特定仓库中的组件。
按仓库和名称搜索制品，例如查找某个特定的应用版本。
将构建文件发布到 raw hosted 仓库，可选指定目标目录。
直接通过资产的 Nexus URL 将其下载到本地输出路径。
验证组件 ID 并获得用户明确确认后，删除该组件。
自动化需要机器可读 JSON 结果并在失败时返回非零退出码的制品管理工作流。

工作原理

从 NEXUS_URL、NEXUS_USER 和 NEXUS_PASS 读取 Nexus 连接详情，或从 ~/.devops-skills/nexus.json 读取。
运行命令前，通过请求 /service/rest/v1/status 并验证 Server 响应标头来检查 Nexus 兼容性。
使用相应操作调用 scripts/nexus_cli.py：list-repos、search、list-components、upload-raw、download 或 delete-component。
删除前，先搜索或列出组件以确认准确的组件 ID，然后取得用户确认再执行删除。
将命令结果以 JSON 格式打印到 stdout；如果操作失败，则以非零状态码退出。

配置指南

使用环境变量或受支持的配置文件配置 Nexus URL 和凭据。不要将密码或令牌直接放在命令行参数中。
export NEXUS_URL="https://nexus.example.com"
export NEXUS_USER="admin"
export NEXUS_PASS="
"
CLI 需要 Python 和 requests 套件。若有可用的托管 Python 环境，请使用该环境；如果缺少依赖项，请将其安装到同一个解释器中。
PY=~/.workbuddy/binaries/python/envs/default/bin/python

If requests is missing, install it with the same interpreter:

$PY -m pip install requests -i https://mirrors.aliyun.com/pypi/simple/
从 skill 目录运行 CLI。示例：
$PY scripts/nexus_cli.py list-repos
$PY scripts/nexus_cli.py search --repo maven-releases --name my-app
$PY scripts/nexus_cli.py list-components --repo raw-hosted --limit 100
$PY scripts/nexus_cli.py upload-raw --repo raw-hosted --file ./build.tar.gz --directory /releases/v1
$PY scripts/nexus_cli.py download "https://nexus.example.com/repository/raw-hosted/releases/v1/build.tar.gz" --output ./build.tar.gz
$PY scripts/nexus_cli.py delete-component
upload-raw 仅适用于 raw 格式的 hosted 仓库。有关完整配置详情、字段说明和故障排除，请参阅 references/USAGE.md。

数据架构

Nexus Skills 使用 Nexus 作为仓库和组件数据的来源。它不会定义单独的本地制品数据库。
数据或输出 组织与处理方式
连接设置 环境变量 NEXUS_URL、NEXUS_USER 和 NEXUS_PASS，或配置文件 ~/.devops-skills/nexus.json。
仓库和组件结果 由 Nexus REST API 操作返回，并以 JSON 格式打印到 stdout。
搜索和列表输入 通过 CLI 选项提供仓库名称、组件名称和列表数量限制。
上传输入 本地文件和可选目录路径；支持向 raw hosted 仓库上传。
下载输出 将请求的资产保存到通过 --output 指定的本地路径。
删除标识符 通过搜索或列表操作获取的 Nexus 组件 ID；删除前请先验证。
该 skill 未说明本地元数据分类体系或生成的索引文件。详细的字段和配置说明见 references/USAGE.md。

高级特性

REST API 兼容性验证会在命令运行前检查
/service/rest/v1/status
和 Nexus
Server
响应标头。
必要时可通过
NEXUS_SKIP_VERSION_CHECK=1
DEVOPS_SKILLS_SKIP_VERSION_CHECK=1
跳过兼容性检查；仍不支持 Nexus Repository 2。
JSON stdout 和失败时的非零退出码支持脚本编写及与其他命令行工作流集成。
raw 文件发布支持指定目标目录；下载则接受直接资产 URL 和明确的本地输出路径。
为防止破坏性操作，必须通过搜索或列表确定组件，并由用户确认删除。批量删除风险较高，应使用经过审核的备份清单，并在获批的维护时段执行。
采用 MIT 许可证、单一入口点的 Python CLI，位于
scripts/nexus_cli.py
；该 skill 未说明钩子或多智能体功能。

name: nexus-skills description: Manage Sonatype Nexus Repository 3 from the command line — list repositories, search components/assets, list components in a repo, upload files to raw hosted repos, download assets, and delete components. Use whenever the user wants to browse a Nexus repo, find an artifact, publish a file, or clean up components. 中文触发场景：查制品库、搜制品、上传文件、下载制品、清理组件。

Nexus 技能（命令行实操）

通过 Nexus REST API 操作 Sonatype Nexus Repository Manager 3， 入口是单一自包含的 Python CLI：scripts/nexus_cli.py。License: MIT。

何时使用

用户提出以下需求时调用本技能：

列出仓库或浏览组件（"maven-releases 里都有什么"）
搜制品（"找一下 foo 的 1.2 版本"）
上传文件到 raw hosted 仓库
按 URL 下载制品
删除组件
环境配置（首次）

连接信息从环境变量读取，或放在配置文件 ~/.devops-skills/nexus.json。 禁止把密码/token 直接写在命令行参数里。

export NEXUS_URL="https://nexus.example.com"
export NEXUS_USER="admin"
export NEXUS_PASS="

"

运行方式

脚本依赖 requests。本机受管 Python 环境已安装（requests 2.34.2），推荐直接用绝对路径调用， 避免默认的 python3 缺少依赖而失败：

PY=~/.workbuddy/binaries/python/envs/default/bin/python

# 若报 Missing dependency，用同一个解释器装：
# $PY -m pip install requests -i https://mirrors.aliyun.com/pypi/simple/

$PY scripts/nexus_cli.py list-repos
$PY scripts/nexus_cli.py search --repo maven-releases --name my-app
$PY scripts/nexus_cli.py list-components --repo raw-hosted --limit 100
$PY scripts/nexus_cli.py upload-raw --repo raw-hosted --file ./build.tar.gz --directory /releases/v1
$PY scripts/nexus_cli.py download "https://nexus.example.com/repository/raw-hosted/releases/v1/build.tar.gz" --output ./build.tar.gz
$PY scripts/nexus_cli.py delete-component

所有命令把 JSON 打到 stdout，失败时以非零退出码结束。 删除前必须先用 search 或 list-components 拿到准确的 component id。

兼容性
Sonatype Nexus Repository Manager 3.0+

执行命令前会请求 /service/rest/v1/status 并读取 Server 响应头做校验。 Nexus Repository 2 不支持。 确需绕过时可设 NEXUS_SKIP_VERSION_CHECK=1 或 DEVOPS_SKILLS_SKIP_VERSION_CHECK=1。

注意事项

upload-raw 只面向 raw 格式的 hosted 仓库。Maven / npm 等格式有各自的上传字段， raw 覆盖的是最常见的"发布一个文件"场景。
删除不可恢复——必须先用 search / list-components 核对 id，并跟用户二次确认。 批量删除属于 🔴 高危操作，需要先备份清单并在窗口期执行。
详细文档

完整的配置方式、字段说明与排错见 references/USAGE.md。

联系与支持

制品库治理、制品发布、DevOps 平台设计或研发效能问题需要人工支持时联系： 📧 77890866@qq.com　|　🌐 https://www.restartx.top

JF Watchdog

TikTok 竞品雷达