Skip to content
maskostudioDocs

All pages

  • Overview/docs/use-cases
  • Mobile app/docs/use-cases#mobile
  • Website/docs/use-cases#website
  • Desktop/docs/use-cases#desktop
  • AI agents/docs/use-cases#agents
  • Videos/docs/use-cases#videos
  • Brand/docs/use-cases#brand
  • Start building/docs/ai-agents
  • Set up once/docs/ai-agents#set-up-once
  • Ask in plain words/docs/ai-agents#ask-in-plain-words
  • What your agent does/docs/ai-agents#what-your-agent-does
  • MCP server/docs/mcp
  • Masko for Cursor/docs/ai-tools/cursor
  • Masko in ChatGPT/docs/ai-tools/chatgpt
  • Masko in Lovable/docs/ai-tools/lovable
  • Masko in Devin/docs/ai-tools/devin
  • Masko in n8n/docs/ai-tools/n8n
  • Masko in Hermes Agent/docs/ai-tools/hermes
  • Masko in OpenClaw/docs/ai-tools/openclaw
  • Start here/docs/tutorials#start-here
  • All tutorials/docs/tutorials
  • Create your first mascot/docs/tutorials/first-mascot
  • Create an animated character/docs/tutorials/first-animation
  • Make a character talk/docs/tutorials/make-it-talk
  • Put your mascot on your website/docs/tutorials/mascot-on-your-website
  • Guide onboarding with a talking mascot/docs/tutorials/web-onboarding-mascot
  • Add a mascot that celebrates progress and welcomes users back/docs/tutorials/web-progress-companion
  • Add a talking support mascot in the bottom right/docs/tutorials/web-support-mascot
  • Show a mascot while your AI thinks/docs/tutorials/ai-loading-mascot
  • Give your AI agent a face/docs/tutorials/ai-agent-face
  • Animate the mascot you already have/docs/tutorials/animate-your-mascot
  • How to make Telegram stickers/docs/tutorials/telegram-stickers
  • How to make Discord stickers/docs/tutorials/discord-stickers
  • Quickstart: your first animation/docs/quickstart
  • Terminal quickstart/docs/terminal
  • API keys and workspaces/docs/authentication
  • CLI browser login/docs/authentication/cli
  • How mascots work/docs/how-mascots-work
  • Credits and costs/docs/credits
  • From text/docs/create/from-text
  • From an image/docs/create/from-image
  • From a website/docs/create/from-website
  • From a brand book/docs/create/from-brand-book
  • Reference images/docs/manage/references
  • What you can generate/docs/generation
  • Pose-to-animation walkthrough/docs/generate/workflow
  • Images and poses/docs/generate/images
  • Animations/docs/generate/animations
  • Talking animations/docs/generate/talking
  • Logos, backgrounds and stickers/docs/generate/design-assets
  • Cursor follower/docs/generate/cursor-follower
  • Batch generation/docs/generate/batch
  • Image and video exports/docs/manage/media-exports
  • Canvases and releases/docs/canvas
  • Build a canvas/docs/canvas/build
  • Canvas templates/docs/canvas/templates
  • Generate canvas assets/docs/canvas/generate-all
  • Export a canvas/docs/canvas/export
  • Overview and demo/docs/player
  • Play one animation/docs/player/one-animation
  • Play a canvas/docs/player/canvas
  • Hosting and file formats/docs/generate/cdn
  • File sizes/docs/generate/file-sizes
  • Float a mascot on your Mac/docs/integrations/desktop
  • Jobs and polling/docs/manage/jobs
  • Webhooks/docs/manage/webhooks
  • Manage mascots and assets/docs/manage/collections
  • All endpoints/docs/reference
  • Requests and responses/docs/reference/conventions
  • Errors and recovery/docs/reference/errors
  • Command line reference/docs/terminal/commands
  • TypeScript SDK/docs/sdk/typescript
  • Changelog/docs/reference/changelog
  • Migrate to mascots and canvases/docs/manage/studio-migration
Get an API key
Documentation

Masko in OpenClaw

OpenClaw connects to Masko's MCP server and can then create a mascot, animate it and export the files, from any chat app OpenClaw answers in.

Connect Masko

OpenClaw signs in to Masko, so nobody copies a key.

  1. Save the server:
openclaw mcp set masko '{"url":"https://masko.ai/api/mcp","transport":"streamable-http","auth":"oauth"}'
  1. Sign in:
openclaw mcp login masko

Open the link it prints, choose the workspace whose credits OpenClaw will use and click Connect Masko. The page then says Authorization received.

  1. Check the connection:
openclaw mcp probe masko

OpenClaw prints masko: followed by the number of tools it found.

  1. Restart the gateway so your chats get the tools: openclaw gateway restart.

OpenClaw waits for Masko's answer on the computer that runs it, so open the link there. On a machine without a browser, run openclaw mcp login masko --code <code> with the code from the address the browser lands on.

Generation spends the credits of the workspace you chose. Only a team owner or admin can connect a team workspace.

Use an API key instead

  1. On masko.ai, open Developers → API keys, choose Create API key, name it OpenClaw and keep Read + Write. Copy the key: it is shown once.
  2. Add MASKO_API_KEY=masko_YOUR_KEY to ~/.openclaw/.env, the file OpenClaw reads its secrets from.
  3. Save the server with a header that points at the key, so the key never sits in your config:
openclaw mcp set masko '{"url":"https://masko.ai/api/mcp","transport":"streamable-http","headers":{"Authorization":"Bearer ${MASKO_API_KEY}"}}'

Use openclaw mcp set rather than openclaw mcp add here: add checks the server before it fills in ${MASKO_API_KEY}, so Masko refuses the check and the server is not saved.

Choose the tools

Hide tools you do not want OpenClaw to use, for example everything that buys credits:

openclaw mcp tools masko --exclude 'create_credit_checkout,get_credit_checkout'

openclaw mcp tools masko --clear brings them all back.

Try it

From the terminal:

openclaw agent --local -m "Show my Masko credit balance. Don't generate anything."

Or ask in any chat OpenClaw answers in:

  • "Show my Masko credit balance. Don't generate anything."
  • "Create a cat mascot for my bakery's chat. Tell me the cost before generating."
  • "Animate the cat waving and send me the video link."

What OpenClaw can do

  • Create a mascot, its poses and its animations.
  • Make talking animations and backgrounds.
  • Build a canvas, the mascot's states and the moments that switch between them.
  • Check a job until its files are ready, then export and publish them.
  • Read your credit balance and open a credit checkout link.

Costs

Generation uses credits from the Masko workspace you connected. Ask for the estimated cost before generating: the estimate tools return it before anything is spent. Reading, listing and checking jobs are free.

Limits

  • The connection allows 120 requests per minute.
  • New mascots made through the MCP server start with public CDN hosting off. Publish the mascot's assets before sharing CDN links.

Security

  • OpenClaw keeps its Masko sign-in in its own state folder, and openclaw mcp show hides credentials. With a key, create one just for OpenClaw, so you can revoke it on its own.
  • To remove access, run openclaw mcp unset masko, then disconnect OpenClaw in Connected apps or revoke its key in Developers → API keys.