@upclaw/cli

Command-line interface for UpClaw marketplace - buy and sell OpenClaw agent skills.

Installation

npm install -g @upclaw/cli

Quick Start

# Login with your wallet
upclaw login

# Search for skills
upclaw search "web scraping"

# Install a skill
upclaw install skill-name

# Publish your own skill
cd my-skill-directory
upclaw publish

Commands

upclaw login

Authenticate with your wallet private key.

# Interactive prompt
upclaw login

# With private key
upclaw login --private-key 0x...

# With keystore file
upclaw login --keystore ./wallet.json

upclaw whoami

Show current authentication status.

upclaw whoami

upclaw search <query>

Search the marketplace for skills.

# Basic search
upclaw search "data analysis"

# With filters
upclaw search "automation" --category automation --max-price 50

# Limit results
upclaw search "web" --limit 10

upclaw info <skill-name>

View detailed information about a skill.

upclaw info web-scraper-pro

upclaw install <skill-id>

Purchase and install a skill.

# Install to default directory (~/.upclaw/skills)
upclaw install abc123

# Install to custom directory
upclaw install abc123 --output ./my-skills

upclaw list

List your owned skills.

# Table format
upclaw list

# JSON format
upclaw list --format json

upclaw publish

Publish current directory as a skill.

# Interactive mode
upclaw publish

# With options
upclaw publish \
  --name "My Awesome Skill" \
  --description "Does amazing things" \
  --category automation \
  --price 25.00 \
  --version 1.0.0

Skill Structure

Your skill directory must include:

my-skill/
├── SKILL.md          # Documentation (required)
├── package.json      # Dependencies (required)
├── src/
│   └── index.js      # Main code
├── tests/
│   └── test.spec.js
└── README.md         # Overview

Configuration

The CLI stores configuration in ~/.config/upclaw-cli/config.json

To use a custom API endpoint:

export UPCLAW_API_URL=http://localhost:3000/api

Agent Integration

Use the CLI in your agent scripts:

import { spawn } from 'child_process';

async function installSkill(skillName) {
  return new Promise((resolve, reject) => {
    const proc = spawn('upclaw', ['install', skillName]);
    proc.on('close', (code) => {
      if (code === 0) resolve();
      else reject();
    });
  });
}

// Install required skill
await installSkill('data-processor-v2');

// Load the skill
import(process.env.HOME + '/.upclaw/skills/data-processor-v2');

Troubleshooting

"Not authenticated"

Run upclaw login to authenticate first.

"Skill not found"

Use upclaw search to find the correct skill ID.

"Access denied"

You must purchase the skill before installing it.

Support

• Documentation: https://upclaw.ai/docs
• Issues: https://github.com/upclaw/upclaw/issues
• Twitter: https://x.com/up_claw

License

MIT