Figma OpenClaw Skill

Figma 集成。浏览团队项目与文件,读取设计结构、页面、节点,导出图片,管理评论,查看版本历史,检查组件/组件集/样式,获取设计变量(Token)。通过 MorphixAI 代理安全访问 Figma API。

v0.1.1 Updated 1 mo ago

Installation

clawhub install figma-2

Requires npm i -g clawhub

663

Downloads

0

Stars

2

current installs

3 all-time

2

Versions

EU EU-Hosted Inference API

Power your OpenClaw skills with the best open-source models.

Drop-in OpenAI-compatible API. No data leaves Europe.

Explore Inference API

GLM

GLM 5

$1.00 / $3.20

per M tokens

Kimi

Kimi K2.5

$0.60 / $2.80

per M tokens

MiniMax

MiniMax M2.5

$0.30 / $1.20

per M tokens

Qwen

Qwen3.5 122B

$0.40 / $3.00

per M tokens

Figma

通过 mx_figma 工具访问 Figma 工作区:浏览项目文件、读取设计结构、导出图片、管理评论、查看组件库/组件集/样式、获取设计变量(Design Token)。

前置条件

  1. 安装插件: openclaw plugins install openclaw-morphixai
  2. 获取 API Key: 访问 morphix.app/api-keys 生成 mk_xxxxxx 密钥
  3. 配置环境变量: export MORPHIXAI_API_KEY="mk_your_key_here"
  4. 链接账号: 访问 morphix.app/connections 链接 Figma 账号,或通过 mx_link 工具链接(app: figma

核心操作

查看当前用户

mx_figma:
  action: get_me

浏览团队项目

mx_figma:
  action: list_team_projects
  team_id: "123456789"

列出项目中的文件

mx_figma:
  action: list_project_files
  project_id: "987654321"

获取文件结构

mx_figma:
  action: get_file
  file_key: "abc123DEF456"
  depth: 2  # 1=仅页面, 2=页面+Frame, 省略=完整树

file_key 从 Figma URL 中提取:figma.com/design/{file_key}/...

获取指定节点

mx_figma:
  action: get_file_nodes
  file_key: "abc123DEF456"
  node_ids: ["1:2", "3:4"]
  depth: 1

导出图片

mx_figma:
  action: export_images
  file_key: "abc123DEF456"
  node_ids: ["1:2"]
  format: "png"   # jpg / png / svg / pdf
  scale: 2        # 0.01–4, 默认 1

返回 node_id → 图片 URL 的映射。

评论操作

列出评论:

mx_figma:
  action: list_comments
  file_key: "abc123DEF456"

发表评论:

mx_figma:
  action: post_comment
  file_key: "abc123DEF456"
  message: "这个按钮的圆角需要改为 8px"

回复评论:

mx_figma:
  action: post_comment
  file_key: "abc123DEF456"
  message: "已修改,请确认"
  comment_id: "12345"

删除评论:

mx_figma:
  action: delete_comment
  file_key: "abc123DEF456"
  comment_id: "12345"

版本历史

mx_figma:
  action: list_versions
  file_key: "abc123DEF456"

组件

文件内组件:

mx_figma:
  action: get_file_components
  file_key: "abc123DEF456"

团队组件库:

mx_figma:
  action: get_team_components
  team_id: "123456789"
  page_size: 30

组件集(变体)

组件集是包含多个变体的容器,例如 Button 组件集包含 Primary、Secondary 等变体。

文件内组件集:

mx_figma:
  action: get_file_component_sets
  file_key: "abc123DEF456"

团队组件集:

mx_figma:
  action: get_team_component_sets
  team_id: "123456789"

样式

文件内样式:

mx_figma:
  action: get_file_styles
  file_key: "abc123DEF456"

团队样式库:

mx_figma:
  action: get_team_styles
  team_id: "123456789"

设计变量(Design Token)

获取文件中定义的变量(颜色、数值、字符串、布尔值),对应 MCP 的 get_variable_defs 功能。

本地变量:

mx_figma:
  action: get_local_variables
  file_key: "abc123DEF456"

返回 variables(变量定义)和 variableCollections(变量集合/分组)。
变量包含 resolvedType(COLOR/FLOAT/STRING/BOOLEAN)和 valuesByMode(各模式下的值)。

发布的变量(跨文件共享):

mx_figma:
  action: get_published_variables
  file_key: "abc123DEF456"

常见工作流

设计走查

1. mx_figma: get_file, file_key: "xxx", depth: 1  → 查看页面列表
2. mx_figma: get_file_nodes, file_key: "xxx", node_ids: ["page_id"]  → 查看页面详情
3. mx_figma: list_comments, file_key: "xxx"  → 查看设计评论
4. mx_figma: post_comment  → 添加走查反馈

设计资产导出

1. mx_figma: get_file, file_key: "xxx", depth: 2  → 找到目标 Frame
2. mx_figma: export_images, node_ids: ["frame_id"], format: "svg", scale: 2  → 导出 SVG

设计系统检查

1. mx_figma: get_file_components, file_key: "xxx"  → 查看文件组件
2. mx_figma: get_file_component_sets, file_key: "xxx"  → 查看组件变体
3. mx_figma: get_file_styles, file_key: "xxx"  → 查看文件样式
4. mx_figma: get_local_variables, file_key: "xxx"  → 查看设计变量/Token
5. mx_figma: get_team_components, team_id: "xxx"  → 查看团队组件库

开发阶段:获取图层和组件信息

1. mx_figma: get_file, file_key: "xxx", depth: 2  → 获取页面和 Frame 结构
2. mx_figma: get_file_nodes, file_key: "xxx", node_ids: ["target_node"]  → 获取指定节点详细属性
3. mx_figma: get_file_components, file_key: "xxx"  → 获取可复用组件列表
4. mx_figma: get_file_component_sets, file_key: "xxx"  → 获取组件变体(Primary/Secondary 等)
5. mx_figma: get_local_variables, file_key: "xxx"  → 获取颜色/间距/字体等设计 Token
6. mx_figma: export_images, file_key: "xxx", node_ids: ["icon_id"], format: "svg"  → 导出图标资源

版本对比

1. mx_figma: list_versions, file_key: "xxx"  → 查看历史版本
2. mx_figma: list_comments, file_key: "xxx"  → 查看相关讨论

注意事项

  • file_key 从 Figma URL 获取:https://figma.com/design/{file_key}/...
  • node_id 格式为 "1:2"(冒号分隔),从 Figma URL 的 node-id 参数获取(URL 中用 - 分隔,需转为 :
  • get_file 不带 depth 参数会返回完整文件树,大文件可能很慢,建议使用 depth: 1depth: 2
  • 导出图片返回的是临时 URL,有效期有限
  • account_id 参数通常省略,工具自动检测已链接的 Figma 账号
  • 变量 API 可能需要 Figma Enterprise 计划才能完整使用

与 Figma MCP 的关系

Figma 官方 MCP 提供了一些本 skill 无法通过 REST API 实现的功能:

MCP 专有功能 说明
get_design_context 返回参考代码 + 截图 + 上下文(设计转代码核心)
get_code_connect_map 设计节点→代码组件映射
generate_figma_design 网页截图导入 Figma
generate_diagram FigJam 中生成 Mermaid 图表

本 skill 覆盖了 Figma REST API 的全部核心能力,适用于项目管理、设计系统检查和开发资源获取。对于设计转代码等高级工作流,建议配合 Figma MCP 使用。

Statistics

Downloads 663
Stars 0
Current installs 2
All-time installs 3
Versions 2
Comments 0
Created Mar 4, 2026
Updated Mar 6, 2026

Latest Changes

v0.1.1 · Mar 6, 2026

- 添加详细的前置条件说明,包括插件安装、API Key 获取与环境变量配置流程 - 指定需在 [morphix.app/connections](https://morphix.app/connections) 或通过 mx_link 工具链接 Figma 账号 - 前置条件列表更加清晰,用户上手流程更完善 - 其他核心功能、操作方法及用法说明保持不变

Quick Install

clawhub install figma-2
EU Made in Europe

Chat with 100+ AI Models in one App.

Use Claude, ChatGPT, Gemini alongside with EU-Hosted Models like Deepseek, GLM-5, Kimi K2.5 and many more.

Customer Support