openclawmp 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 OpenClaw
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,179 @@
+# 🐟 openclawmp
+
+**OpenClaw Marketplace CLI** — 水产市场命令行工具
+
+A command-line client for the [OpenClaw Marketplace](https://openclawmp.cc), allowing you to search, install, publish, and manage agent assets (skills, plugins, triggers, channels, and more).
+
+## Installation
+
+```bash
+npm install -g openclawmp
+```
+
+Requires **Node.js 18+** (uses built-in `fetch`).
+
+## Quick Start
+
+```bash
+# Search for assets
+openclawmp search "web search"
+
+# Install a skill
+openclawmp install skill/@cybernova/web-search
+
+# List installed assets
+openclawmp list
+
+# View asset details
+openclawmp info skill/web-search
+
+# Publish your own skill
+openclawmp publish ./my-skill
+```
+
+## Commands
+
+### `openclawmp search <query>`
+
+Search the marketplace for assets.
+
+```bash
+openclawmp search "文件监控"
+openclawmp search weather
+```
+
+### `openclawmp install <type>/@<author>/<slug>`
+
+Install an asset from the marketplace.
+
+```bash
+# Full format with author scope
+openclawmp install trigger/@xiaoyue/fs-event-trigger
+openclawmp install skill/@cybernova/web-search
+
+# Legacy format (no author)
+openclawmp install skill/web-search
+
+# Force overwrite existing
+openclawmp install skill/@cybernova/web-search --force
+```
+
+**Supported asset types:** `skill`, `config`, `plugin`, `trigger`, `channel`, `template`
+
+### `openclawmp list`
+
+List all assets installed via the marketplace.
+
+```bash
+openclawmp list
+```
+
+### `openclawmp uninstall <type>/<slug>`
+
+Remove an installed asset.
+
+```bash
+openclawmp uninstall skill/web-search
+openclawmp uninstall trigger/fs-event-trigger
+```
+
+### `openclawmp info <type>/<slug>`
+
+View detailed information about an asset from the registry.
+
+```bash
+openclawmp info skill/web-search
+openclawmp info trigger/fs-event-trigger
+```
+
+### `openclawmp publish [path]`
+
+Publish a local asset directory to the marketplace. Defaults to current directory.
+
+```bash
+# Publish current directory
+openclawmp publish
+
+# Publish a specific directory
+openclawmp publish ./my-skill
+
+# Skip confirmation prompt
+openclawmp publish ./my-skill --yes
+```
+
+The command will auto-detect the asset type from:
+1. `SKILL.md` frontmatter (for skills)
+2. `openclaw.plugin.json` (for plugins/channels)
+3. `package.json` (fallback)
+4. `README.md` (fallback)
+
+### `openclawmp login`
+
+Show device authorization information. Your OpenClaw device identity is used for publishing.
+
+```bash
+openclawmp login
+```
+
+### `openclawmp whoami`
+
+Show current user/device info and configuration status.
+
+```bash
+openclawmp whoami
+```
+
+## Global Options
+
+| Option | Description |
+|--------|-------------|
+| `--api <url>` | Override the API base URL |
+| `--version`, `-v` | Show version |
+| `--help`, `-h` | Show help |
+
+## Environment Variables
+
+| Variable | Description |
+|----------|-------------|
+| `OPENCLAWMP_API` | Override the default API base URL (`https://openclawmp.cc`) |
+| `OPENCLAW_STATE_DIR` | Override the OpenClaw state directory (default: `~/.openclaw`) |
+| `NO_COLOR` | Disable colored output |
+
+## Configuration
+
+Configuration files are stored in `~/.openclawmp/`:
+
+- `auth.json` — Authentication token
+
+Install metadata is tracked in `~/.openclaw/seafood-lock.json` (shared with the OpenClaw ecosystem).
+
+## Asset Types
+
+| Type | Icon | Description |
+|------|------|-------------|
+| `skill` | 🧩 | Agent skills and capabilities |
+| `config` | ⚙️ | Configuration presets |
+| `plugin` | 🔌 | Gateway plugins |
+| `trigger` | ⚡ | Event triggers |
+| `channel` | 📡 | Communication channels |
+| `template` | 📋 | Project templates |
+
+## Development
+
+```bash
+# Clone and run locally
+git clone https://github.com/openclaw/openclawmp.git
+cd openclawmp
+
+# Run directly
+node bin/openclawmp.js --help
+node bin/openclawmp.js search weather
+
+# Link globally for testing
+npm link
+openclawmp --help
+```
+
+## License
+
+MIT

package/bin/openclawmp.js

@@ -0,0 +1,77 @@
+#!/usr/bin/env node
+// ============================================================================
+// 🐟 OpenClaw Marketplace CLI (openclawmp)
+//
+// Pure Node.js rewrite of seafood-market.sh
+// Zero external runtime dependencies
+// ============================================================================
+
+'use strict';
+
+const path = require('path');
+const libDir = path.join(__dirname, '..', 'lib');
+const { parseArgs } = require(path.join(libDir, 'cli-parser.js'));
+const { printHelp } = require(path.join(libDir, 'help.js'));
+
+// Command handlers (lazy-loaded)
+const cmdDir = path.join(libDir, 'commands');
+const commands = {
+  install:    () => require(path.join(cmdDir, 'install.js')),
+  uninstall:  () => require(path.join(cmdDir, 'uninstall.js')),
+  search:     () => require(path.join(cmdDir, 'search.js')),
+  list:       () => require(path.join(cmdDir, 'list.js')),
+  info:       () => require(path.join(cmdDir, 'info.js')),
+  publish:    () => require(path.join(cmdDir, 'publish.js')),
+  login:      () => require(path.join(cmdDir, 'login.js')),
+  authorize:  () => require(path.join(cmdDir, 'login.js')),  // alias
+  whoami:     () => require(path.join(cmdDir, 'whoami.js')),
+  help:       () => ({ run: () => printHelp() }),
+};
+
+async function main() {
+  const { command, args, flags } = parseArgs(process.argv.slice(2));
+
+  // Handle version flag
+  if (flags.version || flags.v) {
+    const pkg = require(path.join(__dirname, '..', 'package.json'));
+    console.log(pkg.version);
+    process.exit(0);
+  }
+
+  // Handle help flag or no command
+  if (flags.help || flags.h || command === 'help' || !command) {
+    printHelp();
+    process.exit(0);
+  }
+
+  // Resolve command
+  const loader = commands[command];
+  if (!loader) {
+    const ui = require(path.join(libDir, 'ui.js'));
+    ui.err(`Unknown command: ${command}`);
+    console.log('');
+    printHelp();
+    process.exit(1);
+  }
+
+  // Override API base if --api flag or env var provided
+  if (flags.api || process.env.OPENCLAWMP_API) {
+    const config = require(path.join(libDir, 'config.js'));
+    config.setApiBase(flags.api || process.env.OPENCLAWMP_API);
+  }
+
+  try {
+    const mod = loader();
+    await mod.run(args, flags);
+  } catch (e) {
+    const ui = require(path.join(libDir, 'ui.js'));
+    if (e.code === 'ENOTFOUND' || e.code === 'ECONNREFUSED') {
+      ui.err(`Cannot reach API server. Check your connection or use --api to set a custom endpoint.`);
+    } else {
+      ui.err(e.message || String(e));
+    }
+    process.exit(1);
+  }
+}
+
+main();

package/lib/api.js

@@ -0,0 +1,162 @@
+// ============================================================================
+// api.js — HTTP request helpers for the OpenClaw Marketplace API
+//
+// Uses Node.js built-in fetch (available since Node 18)
+// ============================================================================
+
+'use strict';
+
+const config = require('./config.js');
+
+/**
+ * Build standard auth headers (token + device ID)
+ */
+function authHeaders() {
+  const headers = {};
+  const token = config.getAuthToken();
+  if (token) headers['Authorization'] = `Bearer ${token}`;
+  const deviceId = config.getDeviceId();
+  if (deviceId) headers['X-Device-ID'] = deviceId;
+  return headers;
+}
+
+/**
+ * Make a GET request to the API
+ * @param {string} apiPath - API path (e.g., '/api/assets')
+ * @param {object} [params] - Query parameters
+ * @returns {Promise<object>} Parsed JSON response
+ */
+async function get(apiPath, params = {}) {
+  const url = new URL(apiPath, config.getApiBase());
+  for (const [k, v] of Object.entries(params)) {
+    if (v !== undefined && v !== null && v !== '') {
+      url.searchParams.set(k, String(v));
+    }
+  }
+
+  const res = await fetch(url.toString(), { headers: authHeaders() });
+  if (!res.ok) {
+    const body = await res.text().catch(() => '');
+    throw new Error(`API error ${res.status}: ${body || res.statusText}`);
+  }
+  return res.json();
+}
+
+/**
+ * Make a POST request with JSON body
+ * @param {string} apiPath
+ * @param {object} body
+ * @param {object} [extraHeaders]
+ * @returns {Promise<{status: number, data: object}>}
+ */
+async function post(apiPath, body, extraHeaders = {}) {
+  const url = new URL(apiPath, config.getApiBase());
+
+  const headers = {
+    'Content-Type': 'application/json',
+    ...authHeaders(),
+    ...extraHeaders,
+  };
+
+  const res = await fetch(url.toString(), {
+    method: 'POST',
+    headers,
+    body: JSON.stringify(body),
+  });
+  const data = await res.json().catch(() => ({}));
+  return { status: res.status, data };
+}
+
+/**
+ * POST multipart form data (for publish with file upload)
+ * Node 18+ supports FormData natively in fetch
+ * @param {string} apiPath
+ * @param {FormData} formData
+ * @param {object} [extraHeaders]
+ * @returns {Promise<{status: number, data: object}>}
+ */
+async function postMultipart(apiPath, formData, extraHeaders = {}) {
+  const url = new URL(apiPath, config.getApiBase());
+
+  const headers = {
+    ...authHeaders(),
+    ...extraHeaders,
+  };
+
+  const res = await fetch(url.toString(), {
+    method: 'POST',
+    headers,
+    body: formData,
+  });
+  const data = await res.json().catch(() => ({}));
+  return { status: res.status, data };
+}
+
+/**
+ * Download a file (returns Buffer or null if 404)
+ * @param {string} apiPath
+ * @returns {Promise<Buffer|null>}
+ */
+async function download(apiPath) {
+  const url = new URL(apiPath, config.getApiBase());
+
+  const res = await fetch(url.toString(), { headers: authHeaders() });
+  if (!res.ok) return null;
+  const arrayBuffer = await res.arrayBuffer();
+  return Buffer.from(arrayBuffer);
+}
+
+/**
+ * Search assets
+ * @param {string} query
+ * @param {object} [opts] - { type, limit }
+ * @returns {Promise<object>}
+ */
+async function searchAssets(query, opts = {}) {
+  const params = { q: query, limit: opts.limit || 20 };
+  if (opts.type) params.type = opts.type;
+  return get('/api/assets', params);
+}
+
+/**
+ * Find an asset by type and slug (with optional author filter)
+ * @param {string} type
+ * @param {string} slug
+ * @param {string} [authorFilter]
+ * @returns {Promise<object|null>}
+ */
+async function findAsset(type, slug, authorFilter) {
+  const result = await get('/api/assets', { q: slug, limit: 50 });
+  const assets = result?.data?.assets || [];
+
+  // Exact match on type + name
+  let matches = assets.filter(a => a.type === type && a.name === slug);
+  if (authorFilter) {
+    const authorMatches = matches.filter(a => (a.author?.id || '') === authorFilter);
+    if (authorMatches.length > 0) matches = authorMatches;
+  }
+
+  // Fallback: partial match
+  if (matches.length === 0) {
+    matches = assets.filter(a => a.type === type && a.name.includes(slug));
+    if (authorFilter) {
+      const authorMatches = matches.filter(a => (a.author?.id || '') === authorFilter);
+      if (authorMatches.length > 0) matches = authorMatches;
+    }
+  }
+
+  if (matches.length === 0) return null;
+
+  // Prefer the one with an author ID
+  matches.sort((a, b) => (b.author?.id || '').localeCompare(a.author?.id || ''));
+  return matches[0];
+}
+
+module.exports = {
+  get,
+  post,
+  postMultipart,
+  download,
+  searchAssets,
+  findAsset,
+};

package/lib/auth.js

@@ -0,0 +1,42 @@
+// ============================================================================
+// auth.js — Authentication / token management
+// ============================================================================
+
+'use strict';
+
+const config = require('./config.js');
+
+/**
+ * Check if the user is authenticated
+ */
+function isAuthenticated() {
+  return config.getAuthToken() !== null;
+}
+
+/**
+ * Get the current device ID
+ */
+function getDeviceId() {
+  return config.getDeviceId();
+}
+
+/**
+ * Get auth token
+ */
+function getToken() {
+  return config.getAuthToken();
+}
+
+/**
+ * Save auth token
+ */
+function saveToken(token, extra = {}) {
+  config.saveAuthToken(token, extra);
+}
+
+module.exports = {
+  isAuthenticated,
+  getDeviceId,
+  getToken,
+  saveToken,
+};

package/lib/cli-parser.js

@@ -0,0 +1,61 @@
+// ============================================================================
+// cli-parser.js — Lightweight argument parser (no dependencies)
+//
+// Parses: command, positional args, and --flag / --key=value / --key value
+// ============================================================================
+
+'use strict';
+
+/**
+ * Parse process.argv-style arguments
+ * @param {string[]} argv - Arguments (without node and script path)
+ * @returns {{ command: string|null, args: string[], flags: object }}
+ */
+function parseArgs(argv) {
+  const flags = {};
+  const positional = [];
+
+  let i = 0;
+  while (i < argv.length) {
+    const arg = argv[i];
+
+    if (arg === '--') {
+      // Everything after -- is positional
+      positional.push(...argv.slice(i + 1));
+      break;
+    }
+
+    if (arg.startsWith('--')) {
+      const eqIndex = arg.indexOf('=');
+      if (eqIndex !== -1) {
+        // --key=value
+        const key = arg.slice(2, eqIndex);
+        flags[key] = arg.slice(eqIndex + 1);
+      } else {
+        const key = arg.slice(2);
+        // Check if next arg is a value (not a flag)
+        if (i + 1 < argv.length && !argv[i + 1].startsWith('-')) {
+          flags[key] = argv[i + 1];
+          i++;
+        } else {
+          flags[key] = true;
+        }
+      }
+    } else if (arg.startsWith('-') && arg.length === 2) {
+      // Short flag: -h, -v, etc.
+      const key = arg.slice(1);
+      flags[key] = true;
+    } else {
+      positional.push(arg);
+    }
+
+    i++;
+  }
+
+  const command = positional[0] || null;
+  const args = positional.slice(1);
+
+  return { command, args, flags };
+}
+
+module.exports = { parseArgs };

package/lib/commands/info.js

@@ -0,0 +1,56 @@
+// ============================================================================
+// commands/info.js — View asset details from the registry
+// ============================================================================
+
+'use strict';
+
+const api = require('../api.js');
+const config = require('../config.js');
+const { info, err, c } = require('../ui.js');
+
+async function run(args) {
+  if (args.length === 0) {
+    err('Usage: openclawmp info <type>/<slug>');
+    process.exit(1);
+  }
+
+  const spec = args[0];
+  const parts = spec.split('/');
+  const type = parts[0];
+  const slug = parts[parts.length - 1];
+
+  info(`Looking up ${type}/${slug}...`);
+
+  const asset = await api.findAsset(type, slug);
+  if (!asset) {
+    err(`Not found: ${type}/${slug}`);
+    process.exit(1);
+  }
+
+  const authorName = asset.author?.name || 'unknown';
+  const authorId = asset.author?.id || '';
+  const tags = (asset.tags || []).join(', ');
+
+  console.log('');
+  console.log(`  🐟 ${c('bold', asset.displayName || asset.name)}`);
+  console.log(`  ${'─'.repeat(40)}`);
+  console.log(`  Type:      ${asset.type}`);
+  console.log(`  Package:   ${asset.name}`);
+  console.log(`  Version:   ${asset.version}`);
+  console.log(`  Author:    ${c('cyan', authorName)} ${c('dim', `(${authorId})`)}`);
+  console.log(`  Score:     ${asset.hubScore || 0}`);
+  console.log(`  Downloads: ${asset.downloads || 0}`);
+  if (tags) {
+    console.log(`  Tags:      ${tags}`);
+  }
+  if (asset.description) {
+    console.log('');
+    console.log(`  ${asset.description}`);
+  }
+  console.log('');
+  console.log(`  Install:   openclawmp install ${asset.type}/@${authorId}/${asset.name}`);
+  console.log(`  Registry:  ${config.getApiBase()}/asset/${asset.id}`);
+  console.log('');
+}
+
+module.exports = { run };