OpenClaw Integration

Install Plugin

openclaw plugins install @renderful/openclaw-renderful

Recommended Tool Allowlist

{
  "tools": {
    "allow": [
      "renderful_list_models",
      "renderful_quote",
      "renderful_get_generation",
      "renderful_get_balance"
    ]
  },
  "agents": {
    "list": [
      {
        "id": "renderful-operator",
        "tools": {
          "allow": [
            "renderful_list_models",
            "renderful_quote",
            "renderful_get_generation",
            "renderful_get_balance",
            "renderful_register_agent",
            "renderful_generate",
            "renderful_set_webhook"
          ]
        }
      }
    ]
  }
}

Keep side-effect tools optional and only allow them on agents that should create outputs or change webhook settings.

Install standalone skill (ClawHub)

clawhub install renderful-generation

Users can install this skill directly even before installing the plugin.

Publish skill updates (maintainers)

source ~/.nvm/nvm.sh
nvm use 20.20.0
clawhub whoami
cd packages/openclaw-renderful
clawhub publish ./skills/renderful-generation

Use Node 20+ for clawhub CLI. Node 18 may fail with regex flag errors.

First-run workflow

1. Call renderful_register_agent to get an rf_ key (or use x402 without a key).
2. Call renderful_list_models when model selection is unknown.
3. Call renderful_quote before every renderful_generate request.
4. Call renderful_generate with type, model, and inputs.
5. Poll with renderful_get_generation until completed.
6. If status=402, surface payment_requirements and deposit_addresses, then retry.

Expected responses

{
  "renderful_register_agent": {
    "ok": true,
    "agent_id": "agt_123",
    "api_key": "rf_...",
    "starting_balance": "1.00",
    "trial_credit_applied": true
  },
  "renderful_generate": {
    "ok": true,
    "status": 202,
    "generation": {
      "id": "gen_123",
      "status": "queued",
      "poll_url": "/api/v1/generations/gen_123"
    }
  }
}

OpenAPI and discovery

• https://api.renderful.ai/api/v1/openapi.json
• https://api.renderful.ai/.well-known/agents.json
• https://api.renderful.ai/llms.txt