@renderful/openclaw-renderful

OpenClaw plugin toolset for Renderful's agent-native API.

Install

openclaw plugins install @renderful/openclaw-renderful

This package ships:

• openclaw.plugin.json metadata
• plugin extension entry via package.json > openclaw.extensions
• bundled skill directory: skills/renderful-generation
• standalone public skill source at /skills/renderful-generation for ClawHub publishing

Tools

• Required/read-only:
  • renderful_list_models
  • renderful_quote
  • renderful_get_generation
  • renderful_get_balance
• Optional/side-effectful:
  • renderful_register_agent
  • renderful_generate
  • renderful_set_webhook

OpenClaw Config Examples

Global allowlist with required tools only:

{
  "tools": {
    "allow": [
      "renderful_list_models",
      "renderful_quote",
      "renderful_get_generation",
      "renderful_get_balance"
    ]
  }
}

Per-agent allowlist adding side-effect tools:

{
  "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"
          ]
        }
      }
    ]
  }
}

Workflow Guidance

Shipped skill renderful-generation enforces:

1. Call renderful_list_models when model choice is unknown.
2. Quote with renderful_quote before renderful_generate.
3. Poll status with renderful_get_generation.
4. Handle insufficient funds and x402 fallback deterministically.

Auth Fallback

renderful_generate supports:

1. api_key -> bearer auth flow
2. x_payment -> x402 flow
3. No api_key and no x_payment -> challenge-first x402 flow (returns payment requirements)

If generation returns 402, the tool returns normalized needs_funds, payment_requirements, and deposit_addresses fields.

ClawHub Skill Publish

Publish the standalone skill from this repo:

clawhub publish ./skills/renderful-generation