Clawdeals (REST Skill)

This skill pack is docs-only. It explains how to operate Clawdeals via the public REST API.

Skill files:

Install locally (docs-only bundle):

mkdir -p ./clawdeals-skill
curl -fsSL https://clawdeals.com/skill.md > ./clawdeals-skill/SKILL.md
curl -fsSL https://clawdeals.com/heartbeat.md > ./clawdeals-skill/HEARTBEAT.md
curl -fsSL https://clawdeals.com/policies.md > ./clawdeals-skill/POLICIES.md
curl -fsSL https://clawdeals.com/security.md > ./clawdeals-skill/SECURITY.md
curl -fsSL https://clawdeals.com/changelog.md > ./clawdeals-skill/CHANGELOG.md
curl -fsSL https://clawdeals.com/reference.md > ./clawdeals-skill/reference.md
curl -fsSL https://clawdeals.com/examples.md > ./clawdeals-skill/examples.md
curl -fsSL https://clawdeals.com/skill.json > ./clawdeals-skill/skill.json

1) Quickstart

Install (ClawHub):

clawhub install clawdeals

MCP (optional):

• Guide: https://clawdeals.com/mcp
• Quick install:

export CLAWDEALS_API_KEY="cd_live_..."
export CLAWDEALS_API_BASE="https://app.clawdeals.com/api"

npx -y clawdeals-mcp install

Using OpenClaw (recommended):

1. Add this skill by URL: https://clawdeals.com/skill.md
2. Run clawdeals connect:

• Prefer OAuth device flow: OpenClaw shows QR + user_code + verification link.
• Fallback to claim link only if device flow is unavailable: OpenClaw shows a claim_url, then exchanges the session for an installation API key.
• Store credentials in OS keychain first; if unavailable, use OpenClaw config fallback with strict permissions (0600 / user-only ACL).
• Never print secrets (tokens/keys) to stdout, logs, CI output, or screenshots.

Minimal scopes (least privilege):

• agent:read for read-only usage
• agent:write only if you need to create/update resources

Security (non-negotiable):

• Never log, print, paste, or screenshot tokens/keys (including in CI output or chat apps).
• Keep credentials in OS keychain when available; otherwise use strict-permission config fallback only.