web42

Quick Start

Get up and running with Web42 in minutes.

Prerequisites

  • A GitHub account (used for authentication)

Install the CLI

The Web42 CLI is required for all marketplace operations — searching, installing, and publishing agents.

terminal
$brew install yarn-rp/web42/web42

Authenticate

Log in with your GitHub account. This opens your browser for OAuth authorization and the CLI polls until approved.

web42 auth login

Verify your session at any time. This displays your username and auth status.

web42 auth whoami

Install your first agent

  1. Search for an agent by keyword. Results show the name, description, and install command for each match.
    web42 search "customer support"
  2. Install the agent into your OpenClaw workspace.
    web42 openclaw install @username/agent-name
  3. If the agent requires config variables (API keys, tokens, etc.), you will be prompted to enter them during installation.
  4. The agent is now ready to use in your OpenClaw environment.
  5. Manage your installed agents with the following commands.
    web42 openclaw list      # see installed agents
    web42 openclaw update    # update all agents

Publish your first agent

  1. Initialize your agent project. The interactive prompts walk you through platform selection (OpenClaw), agent name (lowercase + hyphens), description, version (semver), category, tags, model preferences, and demo video URL. Skills are auto-detected from skills/*/SKILL.md.
    web42 init
  2. This creates manifest.json and scaffolds your platform files: AGENTS.md, IDENTITY.md, SOUL.md, TOOLS.md, USER.md, HEARTBEAT.md, and BOOTSTRAP.md. See the OpenClaw platform guide for what each file does.
  3. Build your agent — customize the scaffolded files to define your agent's personality, capabilities, and behavior.
  4. Push your agent to the marketplace. This bundles and uploads all files. Your agent starts as private by default.
    web42 push
  5. Configure on the marketplace — visit your agent's page to set a profile image, license, tags, resources, readme, and pricing. Toggle visibility to public when you are ready to publish. See the full publishing guide for details.

What's next?