OpenClaw plugin
Create editable videos, save projects, and export files through an OpenClaw agent.
The Indream OpenClaw plugin 0.5.0 gives an OpenClaw agent tools for video authoring, asset uploads, project saves, and cloud exports. It includes the indream-video-workflow skill.
Install
Use Node.js 22 or later and OpenClaw gateway 2026.4.2 or later.
openclaw plugins install @indreamai/openclaw-plugin@0.5.0
openclaw gateway restartConfigure the API key
Set the plugin configuration at plugins.entries.indream.config:
{
plugins: {
entries: {
indream: {
enabled: true,
config: {
apiKey: '<YOUR_API_KEY>',
baseURL: 'https://api.indream.ai',
timeoutMs: 60000,
pollIntervalMs: 2000,
uploads: {
allowLocalPaths: true,
allowRemoteUrls: true,
},
},
},
},
},
}An empty configuration is sufficient for installation. API operations require a valid key for the workspace you want to use. The upload options control whether the upload tool can read local files or fetch remote URLs.
Enable the writes you need
Uploads, project creation and sync, export creation, and cancellation are optional tools. Allow them explicitly in your OpenClaw configuration:
{
tools: {
allow: [
'indream_assets_upload',
'indream_video_projects_create',
'indream_video_projects_sync',
'indream_video_exports_create',
'indream_exports_cancel',
],
},
}You can also use allow: ["indream"] to allow this plugin's optional tools. Enable writes according to what your agent should be able to do. Cloud exports consume workspace credits.
Ask for a video
Give the agent a concrete outcome, audience, duration, and available media:
Use indream-video-workflow to create a 30-second introduction to our product for new customers. Use the three images I provided, keep the text readable on a phone, save an editable project, and export an MP4.The workflow develops the design, script, and storyboard, then builds and reviews the scenes. Resolve blocking review issues before committing the video. State whether you want a saved project, an exported file, or both.
Workflow tools
| Step | Tools |
|---|---|
| Start and plan | indream_video_workflow_init, indream_video_workflow_set_design, indream_video_workflow_set_script, indream_video_workflow_set_storyboard. |
| Build scenes | indream_video_workflow_scene_submit, indream_video_workflow_build. Submit every storyboard scene before building. |
| Review | indream_video_workflow_review and indream_video_workflow_revise. Review identifies structural issues; it does not provide rendered preview frames. |
| Save the result | indream_video_workflow_commit, followed by indream_video_projects_create or indream_video_projects_sync. |
| Export | indream_video_exports_create, indream_exports_get, and indream_exports_wait. Use indream_exports_cancel to cancel server work. |
Commit returns the compiled artifact ID used by the project and export tools. Use the returned ID rather than a draft or scene ID.
The agent saves or syncs a project by default. Ask explicitly for a cloud export. indream_exports_wait returns the completed task and its URL; it does not save a file or cancel work when waiting stops. Download the result with a separate file-transfer step.
Bring your own media
indream_assets_upload accepts a local path or remote HTTP/HTTPS URL when enabled. Reuse its returned asset binding in the workflow. indream_assets_get retrieves an uploaded asset; indream_asset_analyze inspects media when available.
indream_illustrations_search finds built-in illustrations. Use the returned illustration names. The plugin's authoring tools and the HTTP API are separate interfaces; the API reference lists the routes available to direct integrations.
Resolve common problems
- An API call cannot authenticate: Check
plugins.entries.indream.config.apiKeyand the key's workspace. - A write tool is unavailable: Add the required tool to
tools.allowand confirm the plugin is enabled. - Build is blocked: Submit every storyboard scene, review the diagnostics, and revise the affected scene.
- A project or export requires an artifact: Commit the completed workflow and pass its compiled artifact ID.
- An export reaches a limit: Inspect its error code. Workspace concurrency, output entitlement, credit balance, and API-key usage caps require different actions; see Errors and retries.
Source and issues: indream-openclaw-plugin on GitHub. Package: @indreamai/openclaw-plugin.
Last updated on