Using the Indream OpenClaw Plugin: A Friendly Walkthrough

At Indream, we've spent a lot of time thinking about where video creation fits into the way people actually work today. More and more of that work happens inside AI agents. You describe what you want in plain language, and something gets built. So we asked ourselves: why should making a video be any different?

That's why we built the Indream OpenClaw plugin. Install it once, and the AI agents you already use inside OpenClaw can talk to Indream directly. Upload your photos, plan scenes, render an MP4, all without leaving the conversation.

This post walks you through everything: installing the plugin, getting your API key, topping up your account, setting it up, and making your first video. We've kept the explanations plain, so you don't need to be a developer to follow along.

What you'll need before starting

• An OpenClaw gateway running version 2026.4.2 or later
• An Indream account (we'll create an API key and top up in Step 2)
• An AI agent inside OpenClaw that you'd like to let drive the plugin

That's it.

Step 1: Install the plugin

Open your OpenClaw terminal and run these two commands:

openclaw plugins install @indreamai/openclaw-plugin
openclaw gateway restart

The first command installs the plugin. The second restarts your gateway so the new plugin is picked up. If the restart finishes without errors, you're ready for the next step.

Step 2: Get your API key and top up your account

Before the plugin can talk to Indream, it needs a key. Here's how to get one:

1. Visit API Keys and sign in with your Indream account.

2. Click Create API key. Give it a name you'll recognize later, for example "OpenClaw workstation".
3. Copy the key right away. For security reasons, we only show the full key once. If you lose it, just create a new one.

One important note on billing. Indream's video services run on a credit balance, so you'll need to top up your account before your first render. You can add credit from the same developer area. If you try to kick off a render with an empty balance, the request will fail politely and ask you to top up first.

With your API key in hand and some credit in the account, you're ready to configure the plugin.

Step 3: Add your key and basic settings

The plugin's configuration lives under plugins.entries.indream.config in your OpenClaw configuration. A complete, healthy setup looks like this:

{
  plugins: {
    entries: {
      indream: {
        enabled: true,
        config: {
          apiKey: "indream_xxx",
          baseURL: "https://api.indream.ai",
          timeoutMs: 60000,
          pollIntervalMs: 2000,
          uploads: {
            allowLocalPaths: true,
            allowRemoteUrls: true,
          },
        },
      },
    },
  },
}

What each setting means, in plain language:

• apiKey: the key you just created in Step 2. Paste it here. Nothing works until this is set.
• baseURL: the Indream service address. Leave it at the default unless our support team asks you to change it.
• timeoutMs and pollIntervalMs: how long operations are allowed to run, and how often the plugin checks in on them. The defaults work well for most people.
• uploads.allowLocalPaths: lets the plugin read files from your computer. Set to true if you want to hand it local photos or videos.
• uploads.allowRemoteUrls: lets the plugin fetch files from web URLs. Same idea, for online sources.

Step 4: Decide what the plugin is allowed to do

When the plugin is enabled, your agent can read things by default. It can check capabilities, search illustrations, and look up stored assets. But actions that create real resources on your account (uploading files, saving a project, starting an export) are opt-in. You grant them explicitly.

To let your agent use everything the plugin offers, add this to your tools settings:

{
  tools: {
    allow: ["indream"],
  },
}

Or if you'd prefer finer control, allow only the specific write actions you need:

{
  tools: {
    allow: [
      "indream_assets_upload",
      "indream_video_projects_create",
      "indream_video_projects_sync",
      "indream_video_exports_create"
    ],
  },
}

You can always adjust this later.

Step 5: Assets and illustrations

Once the plugin is active, your agent has two ways to bring visual materials into a video.

Uploads. You can hand it files from your computer, or give it web URLs. Each upload is stored and can be reused in later steps, so you only upload once. Indream also runs a quick analysis on each image, so your agent has a rough idea of what's inside (faces, logos, clean backgrounds, text) and can place it thoughtfully.

Built-in illustrations. Indream ships with a library of ready-to-use illustrations such as chat bubbles, rockets, and sparkles. Every one of them can be recolored to match your brand. Your agent can search the library and drop any of them into a scene.

Step 6: Making your first video

Now the fun part. With the plugin installed, your key pasted in, your account topped up, and write permissions granted, you don't need to think about the technical pipeline at all. You just tell your OpenClaw agent what you want, and the plugin takes care of the rest in the background.

Here's the kind of thing you can say:

"Use Indream to create a 30-second product teaser. Upload these three photos I just took. Build five scenes. Save the project, then export an MP4."

One sentence is enough. You can step away and come back to a finished preview.

Troubleshooting the common cases

A few of the most common things that can go wrong, and how to handle them:

• Missing credentials. Requests fail until apiKey is set in your config. Double-check that you pasted the key correctly.
• Empty balance. If your Indream account has no credit, renders and exports will fail. Top up at Billing and try again.

• Agent can read but can't upload or export. The write tools aren't in your allow list yet. Add the plugin ID, or the specific tool names, to tools.allow.
• OPEN_API_RUNTIME_ACCESS_FORBIDDEN. Your key is valid, but the resource you're trying to reach is outside its scope. Check with whoever manages your Indream account.
• A step reports something's missing. The plugin is strict about not shipping broken output. If it says something needs finishing, let your agent resolve it and continue.

That's the whole thing

Install the plugin, grab your API key, top up your account, grant the permissions that fit your comfort level, and start chatting with your agent. From there, making a video is just a conversation.

If you want to dig deeper, the full technical reference lives at Video Editor API. Otherwise, go make something.