# How to connect HeyGen to OpenClaw (paste one key, 71 tools) > Connect HeyGen to OpenClaw with ClawLink: paste your HeyGen key once and 71 tools work from chat. No MCP server to run, nothing stored on your machine. Web version: https://claw-link.dev/openclaw/heygen The usual route to HeyGen access for OpenClaw is an MCP server you configure and keep running, plus your own OAuth app or API keys. ClawLink gives OpenClaw a more practical HeyGen setup: install one ClawHub skill, connect HeyGen in the browser, and OpenClaw can call real HeyGen actions from any chat surface with no auth, token refresh, or tool wiring to build yourself. **Start here:** install the ClawLink plugin (`openclaw plugins install clawhub:clawlink-plugin`), pair it in the browser, then connect the app in the ClawLink dashboard. The interactive install prompt is on the web version of this page: https://claw-link.dev/openclaw/heygen ## Setup It takes three steps to connect OpenClaw to HeyGen. 1. **Install ClawLink** — add the plugin to OpenClaw once. 2. **Connect HeyGen** — one-click OAuth in the ClawLink dashboard. 3. **Use it from chat** — ask OpenClaw in plain English. **Alternative for any agent (no plugin needed):** if the OpenClaw plugin route isn't available or doesn't work, any AI agent with shell access can use the ClawLink CLI instead: ```bash npx -y @useclawlink/cli login # sign in via browser — no API key to paste npx -y @useclawlink/cli connect heygen # connect HeyGen (browser OAuth) npx -y @useclawlink/cli actions heygen # list available actions npx -y @useclawlink/cli run heygen --input '' # execute (add --confirm for writes) ``` ### Install by command The setup prompt above does all of this in one paste. By hand, it is one install command plus a browser approval: ```bash openclaw plugins install clawhub:clawlink-plugin ``` Then ask OpenClaw to set up ClawLink. It starts browser pairing and prints an approval link — open it, approve the device, return to the chat, and say `done`. Finally, connect HeyGen in the [ClawLink dashboard](https://claw-link.dev/dashboard) — paste your HeyGen API key once. Verify the connection by asking OpenClaw: > Use HeyGen to add looks to photo avatar group and walk me through the result in plain English. ### Using a different agent? The OpenClaw plugin is one client of ClawLink's MCP server. Claude Code, Cursor, Codex, or any agent that can run a shell command pairs with the same ClawLink account through the CLI: ```bash npx -y @useclawlink/cli login ``` `login` opens the same browser approval and stores a credential locally. Once HeyGen is connected in the dashboard, that agent calls the same 71 HeyGen tools over MCP. Full setup for MCP clients and shell agents: [connect apps to any AI agent](https://claw-link.dev/learn/connect-apps-to-any-ai-agent). ## HeyGen MCP for OpenClaw Looking for a HeyGen MCP server for OpenClaw? ClawLink connects HeyGen to OpenClaw and exposes 71 HeyGen tools your agent can call over [MCP](https://claw-link.dev/learn/what-is-an-mcp-server), with [hosted auth](https://claw-link.dev/learn/oauth-for-ai-agents) and nothing to run or maintain yourself. Using Hermes instead? The [Hermes HeyGen integration](https://claw-link.dev/hermes/heygen) works the same way. ## What the OpenClaw HeyGen integration can do 71 HeyGen tools are ready for OpenClaw once the account is connected. The 30 below are the ones people reach for most; your agent can call all 71. ### 30 of 71 HeyGen tools for OpenClaw | Tool | What it does | |---|---| | **Add looks to photo avatar group** `heygen_add_looks_to_photo_avatar_group` | Tool to add additional looks (images) to an existing photo avatar group. Use when you need to expand an avatar group with new image variations. Maximum 4 image keys can be added per request. | | **Add motion** `heygen_add_motion` | Tool to add natural motion or animation to an existing photo avatar, turning a still image into a moving, lifelike one. | | **Check photo look generation status** `heygen_check_photo_look_generation_status` | Tool to retrieve the current status and details of a photo avatar or look generation by its ID. Use when you need to check if a photo avatar generation is complete or monitor generation progress. | | **Create folder** `heygen_create_folder` | Tool to create a new folder under your HeyGen account. Use when you need to organize content by creating a new folder. | | **Create knowledge base** `heygen_create_knowledge_base` | Tool to create a new knowledge base with a specified name, opening line, and custom prompt for Interactive Avatar streaming sessions. | | **Create photo avatar group** `heygen_create_photo_avatar_group` | Tool to create an avatar group which can include both AI-generated and user-uploaded photos of the avatar. Use when you need to create a new avatar group for training or managing avatar photos. | | **Create webm video** `heygen_create_webm_video` | Tool to create a WebM format video with transparent background featuring an avatar speaking text or audio. | | **Get current user information** `heygen_get_current_user_information` | Retrieve the profile information of the currently authenticated user | | **Get training job status** `heygen_get_training_job_status` | Retrieve the current training status and details of a photo avatar training job by group ID | | **List all avatar groups** `heygen_list_all_avatar_groups` | Retrieve a list of all available avatar groups in your HeyGen account | | **List all locales for voices** `heygen_list_all_locales_for_voices` | Retrieve available locales for multilingual voices | | **List assets** `heygen_list_assets` | Retrieve a paginated list of all assets (images, audios, videos) created under your account | | **List brand voices** `heygen_list_brand_voices` | Retrieve a list of brand glossaries created under your account | | **List folders** `heygen_list_folders` | Retrieve a paginated list of folders created under your account | | **List group avatars** `heygen_list_group_avatars` | Retrieve all avatars that belong to a specific avatar group | | **List knowledge bases** `heygen_list_knowledge_bases` | Retrieve a list of all existing knowledge bases associated with your account | | **List session history** `heygen_list_session_history` | Retrieve a paginated history of all streaming sessions with metadata including session | | **List streaming avatars** `heygen_list_streaming_avatars` | Retrieve a list of public and custom interactive avatars for streaming | | **List tts voices** `heygen_list_tts_voices` | Retrieve a list of public and custom voices compatible with HeyGen's Starfish TTS model | | **Personalized video project detail** `heygen_personalized_video_project_detail` | Retrieves detailed information about a specific personalized video project in HeyGen, including | | **Photo avatar details** `heygen_photo_avatar_details` | Retrieve detailed information about a photo avatar or look using its unique ID | | **Retrieve avatar details** `heygen_retrieve_avatar_details` | Retrieve detailed information about a specific avatar by its ID | | **Retrieve template details v3** `heygen_retrieve_template_details_v3` | Retrieve comprehensive details about a specific template including all available variables for | | **Retrieve video status details** `heygen_retrieve_video_status_details` | Retrieve the current processing status and metadata for a specific video by ID | | **Search public avatar groups** `heygen_search_public_avatar_groups` | Search and retrieve public avatar groups with optional filters and pagination | | **Streaming list** `heygen_streaming_list` | Retrieves a list of active or available streaming sessions or content within the HeyGen platform | | **V1 avatar list** `heygen_v1_avatar_list` | Retrieves a list of available avatars from the Heygen platform | | **V1 talking photo list** `heygen_v1_talking_photo_list` | Retrieves a list of talking photos created using the HeyGen platform | | **V1 video list** `heygen_v1_video_list` | Retrieves a list of videos associated with the user's account on the HeyGen platform | | **V1 voice list** `heygen_v1_voice_list` | Retrieves a comprehensive list of all available voices in the HeyGen platform | ## Example prompts **Add Looks To Photo Avatar Group** > Use HeyGen to add looks to photo avatar group and walk me through the result in plain English. **Add Motion** > Use HeyGen to add motion and walk me through the result in plain English. **Check Photo Look Generation Status** > Use HeyGen to check photo look generation status and walk me through the result in plain English. **Create Folder** > Create it in HeyGen for me, then confirm the important fields before you finish. ## ClawLink vs. building it yourself The alternative to ClawLink is usually manual API key setup plus your own token handling, permission troubleshooting, and tool plumbing for OpenClaw. That is fine if you want to build and maintain the integration yourself. Most teams just want HeyGen working from chat. | | Manual | ClawLink | |---|---|---| | **Credential handling** | Collect, validate, store, and rotate the HeyGen API key yourself, then make sure every tool call uses the right account. | Users complete the hosted ClawLink setup once and the connected HeyGen account becomes available to the agent without you building credential management. | | **Ongoing maintenance** | You own refresh logic, permission debugging, environment config, and every provider-specific edge case for HeyGen. | ClawLink handles the repetitive integration plumbing so your team can focus on the workflow instead of the infrastructure. | | **Agent usability** | You still need to expose the right HeyGen actions to the runtime in a format your agent can reliably use. | 71 tools for HeyGen are already exposed through ClawLink, so the agent can read and act from chat immediately. | ## ClawLink vs. Composio Composio also exposes HeyGen to AI agents. It is developer infrastructure: Python and TypeScript SDKs, an MCP server, and a catalog past 1,000 apps, aimed at teams shipping agent products. ClawLink is built for OpenClaw users instead. You install the plugin once, connect HeyGen in the browser, and the 71 tools above work from chat. There is no SDK and no config file, and the HeyGen key you paste at setup is stored server-side rather than kept in your environment. Choosing between them? Read the full [Composio alternatives](https://claw-link.dev/hub/composio-alternatives) comparison. ### OpenClaw installed the HeyGen skill but can't call the tools The ClawHub skill teaches OpenClaw about HeyGen, but the calls run through the ClawLink plugin and your connected account. Make sure HeyGen is connected in the dashboard, then start a fresh chat so OpenClaw reloads the tool catalog. If OpenClaw runs as a persistent gateway, restart it so the new tools register. ### Connection succeeds but no tools appear Reconnect HeyGen from the dashboard, then start a fresh chat if the runtime still has the old tool catalog loaded. ### "Tool schema not loaded yet" error when calling HeyGen tools HeyGen tool schemas load on demand the first time a tool runs and are cached after that, so this error usually clears on its own: wait a few seconds and retry the same request. If every HeyGen call keeps failing with it in a fresh chat, reconnect from the dashboard, and contact support if it still persists — that pattern points to a configuration problem on our side, not something you can fix by reconnecting again. ### HeyGen returns 403 or "permission denied" on one action while others work Two usual causes. The connected account may not have access to the specific workspace, inbox, store, or project in the request — check that first. If access looks right, the agent may have sent a placeholder value (like "YOUR_ID" or an example id from documentation) instead of a real one: ask it to run a list or search tool first, then retry the action with a real id from those results. Most failures at this stage are one of these two, not ClawLink bugs. ### API key setup works but results look incomplete Double-check that the API key for HeyGen has the right scopes or account access. A valid key can still be too limited for some reads or writes. ### Is there a OpenClaw HeyGen integration? Yes. ClawLink is the fastest way to connect OpenClaw to HeyGen: link your HeyGen account once in the browser and OpenClaw can call the HeyGen API through 71 ready-made tools — no custom code or token handling. ### How do I add HeyGen to OpenClaw with ClawLink? Paste the setup prompt from this page into OpenClaw. It installs the ClawLink HeyGen skill from ClawHub, then you click Connect in the dashboard to authorize HeyGen. OpenClaw calls the tools from the next message — no config files, and the HeyGen key you paste is stored server-side instead of in your environment. ### How long does it take to connect HeyGen to OpenClaw? About two minutes. Sign in, click Connect next to HeyGen in the dashboard, authenticate, and OpenClaw can use it from the next chat message. ### Why use ClawLink instead of wiring HeyGen up myself? The alternative to ClawLink is usually manual API key setup plus your own token handling, permission troubleshooting, and tool plumbing for OpenClaw. That is fine if you want to build and maintain the integration yourself. Most teams just want HeyGen working from chat. ### OpenClaw installed the HeyGen skill but can't call the tools The ClawHub skill teaches OpenClaw about HeyGen, but the calls run through the ClawLink plugin and your connected account. Make sure HeyGen is connected in the dashboard, then start a fresh chat so OpenClaw reloads the tool catalog. If OpenClaw runs as a persistent gateway, restart it so the new tools register. ## Related - [OpenClaw DataRobot integration](https://claw-link.dev/openclaw/datarobot) — DataRobot is a machine learning platform that automates model building, deployment, and monitoring, enabling organizations to derive predictive insights from large datasets. - [Chatbotkit tools](https://claw-link.dev/openclaw/chatbotkit) — ChatBotKit is a platform that enables developers to build and manage AI-powered chatbots, offering comprehensive APIs and SDKs for seamless integration into applications. - [ElevenLabs](https://claw-link.dev/openclaw/elevenlabs) — Generate speech and voice cloning