Hedra

Name: Hedra
Rating: 3.5 (1 reviews)
Author: mattstvartak

By mattstvartak 👁 72 views ▲ 0 votes

Hedra AI video and image generation plugin for OpenClaw

GitHub

Install

npm install
npm

Configuration Example

{
  "plugins": {
    "entries": {
      "hedra": {
        "enabled": true,
        "config": {
          "apiKey": "sk_h_your-key-here"
        }
      }
    }
  }
}

README

# Hedra Plugin for OpenClaw

AI video and image generation plugin for [OpenClaw](https://openclaw.ai) powered by [Hedra](https://www.hedra.com). Generate talking avatars, videos from text prompts, and images — all from your agent.

Built by **OneNomad LLC**.

## Features

- **Image generation** — create images from text prompts with configurable aspect ratios and resolutions
- **Video generation** — text-to-video and image-to-video with optional start/end keyframes
- **Talking avatars** — lip-synced avatar videos from a portrait image + audio or text-to-speech
- **Voice listing** — browse available TTS voices for avatar generation
- **Model listing** — discover available Hedra models and their capabilities
- **Credit tracking** — check your Hedra credit balance

## Requirements

- [Hedra](https://www.hedra.com) Creator plan or above
- Hedra API key from https://www.hedra.com/api-profile

## Installation

### From ClawHub

```bash
openclaw plugins install clawhub:@onenomad/openclaw-hedra
```

### Manual install

```bash
git clone https://github.com/mattstvartak/openclaw-hedra.git
cd openclaw-hedra
npm install
npm run build
openclaw plugins install ./
```

## Configuration

Set your API key in `openclaw.json`:

```json
{
  "plugins": {
    "entries": {
      "hedra": {
        "enabled": true,
        "config": {
          "apiKey": "sk_h_your-key-here"
        }
      }
    }
  }
}
```

Or use the `HEDRA_API_KEY` environment variable.

| Setting | Default | Description |
|---------|---------|-------------|
| `apiKey` | | Hedra API key (falls back to HEDRA_API_KEY env var) |
| `defaultVideoModel` | | Default model for video generation |
| `defaultImageModel` | | Default model for image generation |

## Registered Tools

| Tool | Description |
|------|-------------|
| `hedra_generate_image` | Generate images from text prompts |
| `hedra_generate_video` | Generate videos from text prompts, optionally with a start image |
| `hedra_generate_avatar` | Generate talking avatar videos from a portrait + audio/TTS |
| `hedra_generation_status` | Check generation status and get result URLs |
| `hedra_list_models` | List available Hedra AI models |
| `hedra_list_voices` | List available TTS voices for avatars |
| `hedra_credits` | Check credit balance |

## Usage Examples

### Generate an image
> "Generate a photo-realistic image of a mountain lake at sunset"

The agent calls `hedra_generate_image` with the prompt and returns the result URL.

### Generate a video
> "Create a 5 second video of ocean waves crashing on a beach"

The agent calls `hedra_generate_video` with the prompt and duration.

### Create a talking avatar
> "Make this portrait say 'Hello, welcome to our product demo'"

The agent calls `hedra_list_voices` to pick a voice, then `hedra_generate_avatar` with the portrait asset ID, TTS text, and voice ID.

## Security

- API key can be set in plugin config or as an environment variable
- The plugin only contacts `https://api.hedra.com` — no other endpoints
- No telemetry or analytics

## License

MIT

tools