OpenClaw Figma Plugin

This plugin integrates OpenClaw with Figma, exposing tools to inspect files, pages, components, frames, and design metadata.

Features

• Test Figma API connectivity and authentication
• Retrieve file document trees and metadata
• List pages, components, component sets, and styles
• Get individual nodes by ID with full properties
• Export nodes as JPG, PNG, SVG, or PDF images
• List team-level libraries (components, component sets, styles)
• Browse projects and project files
• Read, create, and delete comments and reactions
• Version history for files

Installation

# 1. Install the plugin
openclaw plugins install @kvasar/openclaw-figma

# 2. Restart the gateway
openclaw gateway restart


# 3. Update the plugin

openclaw plugins update openclaw-figma

Configuration

The plugin will not load unless the apiToken config value is present.

Generate a Personal Access Token in Figma Settings → Account → Personal Access Tokens.

OpenClaw config path:

{
  "plugins": {
    "entries": {
      "openclaw-figma": {
        "config": {
          "apiToken": "${FIGMA_API_TOKEN}",
          "defaultTeamId": "",
          "requestTimeoutMs": 30000
        }
      }
    }
  }
}

Required keys:

| Key | Description | | --- | --- | | apiToken | Figma Personal Access Token (starts with figd_...) | | defaultTeamId | Default team ID for team-scoped queries (optional) | | requestTimeoutMs | Request timeout in milliseconds (default: 30000) |

If apiToken is missing, plugin registration fails.

Tools

All tools are namespaced with figma_. See tool descriptions in the agent for detailed parameters.

Connection

• figma_health — Test the Figma API connection

Files

• figma_file — Retrieve file document tree and metadata
• figma_file_meta — Lightweight file metadata
• figma_file_images — Download links for image fills
• figma_file_versions — File version history
• figma_pages — List pages in a file

Components & Styles

• figma_components — List published components in a file
• figma_styles — List published styles in a file
• figma_team_components — List published components in a team library
• figma_team_component_sets — List component sets in a team library
• figma_file_component_sets — List component sets in a file
• figma_component_get — Get component metadata by key
• figma_component_set_get — Get component set metadata by key
• figma_team_styles — List published styles in a team library
• figma_style_get — Get style metadata by key

Nodes & Export

• figma_node — Get a specific node by ID
• figma_export — Export a node as JPG/PNG/SVG/PDF

Projects

• figma_team_projects — List projects in a team
• figma_project_files — List files in a project
• figma_project_meta — Get project metadata

Comments

• figma_comments_get — Get comments on a file
• figma_comments_create — Post a comment
• figma_comments_delete — Delete a comment
• figma_comment_reactions_get — Get reactions on a comment
• figma_comment_reactions_create — Post a reaction
• figma_comment_reactions_delete — Delete a reaction

Dev Resources

• figma_dev_resources_get — Get dev resources in a file
• figma_dev_resources_create — Bulk create dev resources
• figma_dev_resources_update — Bulk update dev resources
• figma_dev_resources_delete — Delete a dev resource

Webhooks

• figma_webhook_create — Create a webhook subscription
• figma_webhook_get — Get a webhook by ID
• figma_webhook_list — List webhooks filtered by context/plan
• figma_webhook_update — Update a webhook subscription
• figma_webhook_delete — Delete a webhook subscription
• figma_webhook_requests — Get webhook request history

Token Scopes

All tools in this plugin work with a Personal Access Token (PAT) that includes the appropriate scopes. Below is the mapping of tool categories to required scopes.

| Category | Required Scopes | Token Type | |----------|----------------|------------| | Connection | current_user:read | PAT | | Files (metadata & images) | file_metadata:read, file_versions:read | PAT | | Files (document tree) | file_content:read | PAT | | Nodes & Export | file_content:read | PAT | | Components & Styles | library_assets:read, library_content:read, team_library_content:read | PAT | | Projects | projects:read, project_metadata:read | PAT | | Comments | file_comments:read, file_comments:write | PAT | | Dev Resources | file_dev_resources:read, file_dev_resources:write | PAT | | Webhooks | webhooks:read, webhooks:write | PAT |

Enterprise-only features (not yet implemented)

The following Figma API categories require an Enterprise plan and work with Plan Access Tokens (PLANTs) or OAuth, not PATs:

| Category | Required Scopes | Notes | |----------|----------------|-------| | Variables | file_variables:read, file_variables:write | Enterprise plan | | Library Analytics | library_analytics:read | Enterprise plan | | Activity Logs | org:activity_log_read | Enterprise, org admin only | | AI Usage | org:ai_metering_usage_read | Enterprise, org admin only | | Discovery | org:discovery_read | Enterprise + Governance+, org admin | | Developer Logs | org:developer_log_read | Enterprise + Governance+, org admin |

These will be implemented in a future release once a suitable auth mechanism is available for non-PAT token types.

Notes

• The plugin uses the Figma REST API (https://api.figma.com).
• Rate limits are handled automatically with retries and exponential backoff.
• When generating a Personal Access Token in Figma Settings, select the scopes you need based on the table above. The token only grants access to the scopes you explicitly select.
• Configure the token via the FIGMA_API_TOKEN environment variable or apiToken in config.

Model Evaluation Matrix

| Model | Expected Performance | |---------|---------------------| | Claude Opus 4.8 | very High | | Claude Opus 4.7 | High | | GPT-5.5 | very High | | GPT-5.4 | High | | DeepSeek v4 Flash| High | | stepfun-ai/step-3.5-flash | Low | | stepfun-ai/step-3.7-flash | Medium | | z-ai/glm-5.1 | Medium |

Brought with ❤️ by Kvasar Technologies