Agentplace

Agentplace — AI Agent Marketplace for OpenClaw

Agentplace is a marketplace of community-contributed agent skills. This skill enables browsing and installing agents only when the user explicitly requests it.

Privacy note: This skill queries api.agentplace.sh only during explicit user-initiated searches. No automatic or background calls are made.

When to Use This

Only use this skill when the user explicitly asks for one of the following:

• "Browse the marketplace" / "Show me available agents"
• "Install [agent name]" / "Find me an agent for [task]"
• "What agents are available?" / "Search for [keyword]"

Do NOT use this skill when:

• The user asks a general question you can't answer → say you don't know
• The user wants you to perform a task → use your existing tools or decline
• You're unsure what they want → ask for clarification first

Agent Tiers

API key scope: The key is sent only to api.agentplace.sh to authorize the download URL. It is never sent with prompts or user data.

Search / Browse (User-Initiated Only)

When the user explicitly asks to browse or search:

# List all agents
curl -s "https://api.agentplace.sh/marketplace/agents"

# Search by keyword
curl -s "https://api.agentplace.sh/marketplace/agents?search=<query>"

# Get specific agent details
curl -s "https://api.agentplace.sh/marketplace/agents/<agent-id>"

Present results clearly with FREE/PAID badges. Wait for user selection before proceeding.

Install Flow (Explicit Confirmation Required)

Step 1: Get user confirmation Show the agent name, description, tier (free/paid), and ask: "Install [name]? (yes/no)"

Step 2: Fetch download URL

# Free agent
curl -s "https://api.agentplace.sh/marketplace/agents/<agent-id>/download"

# Paid agent
curl -s -H "x-api-key: ak_xxxx" "https://api.agentplace.sh/marketplace/agents/<agent-id>/download"

Response: { "download_url": "...", "version": "...", "tier": "..." }

Step 3: Preview before install Download the ZIP, extract to a temporary location, and show the user the SKILL.md content before moving to the skills folder.

# Download to temp
curl -sL "$download_url" -o /tmp/agent.zip

# Extract to temp preview folder
unzip -qo /tmp/agent.zip -d /tmp/agent-preview/

# Show SKILL.md to user for approval
cat /tmp/agent-preview/SKILL.md

Step 4: Final confirmation and install After user approves the preview:

# Move to actual skills folder
mv /tmp/agent-preview ~/.openclaw/workspace/skills/<agent-id>/
rm /tmp/agent.zip

Never skip the preview step. Never install without explicit user confirmation.

Integrity & Verification

Currently, agents are distributed as ZIP files without cryptographic signatures. Before installing:

1. Preview the SKILL.md — verify it matches the marketplace description
2. Check file contents — ensure no unexpected executables or suspicious paths
3. Prefer agents from trusted publishers — check the publisher reputation on agentplace.sh

If an agent's files look suspicious or don't match its description, do not install it and warn the user.

API Key Setup (Paid Agents Only)

Free agents require no authentication. For paid agents:

1. Visit https://www.agentplace.sh/dashboard to get your API key (format: ak_xxxx)
2. The same key works for all purchased agents
3. Store the key securely — do not hardcode it in shared environments

Error Handling

Security Guidelines

• User-initiated only: Never search or install without explicit user request
• Explicit confirmation: Always ask "yes/no" before installing
• Preview first: Show SKILL.md content before extracting to skills folder
• No auto-execution: Never run code from downloaded agents automatically
• Local execution: Agents run on the user's machine; prompts are not sent to Agentplace servers
• API key scope: Dashboard key is only used to authorize downloads — never sent with user queries