核心用法
figma-design 技能通过 ClawLink 托管服务与 Figma REST API 建立安全连接,为 OpenClaw 用户提供完整的设计资产管理能力。核心工作流分为三步:安装 ClawLink 插件、完成设备配对、在 Dashboard 中授权 Figma 账户。认证完成后,所有 API 调用均由 ClawLink 自动注入 OAuth Token,用户无需接触敏感凭证。
技能覆盖四大功能维度:
1. 设计文件解析:通过 figma_get_file_json 读取完整设计文件结构,figma_get_file_nodes 提取特定节点,figma_discover_figma_resources 从任意 Figma URL 解析 file_key 与 node_id;
2. 资产导出:支持 PNG/SVG/JPG/PDF 多格式图片下载(figma_download_figma_images、figma_render_images_of_file_nodes),以及 image fills 临时 URL 获取;
3. 协作与评论:完整的评论生命周期管理,包括读取、添加、删除评论及表情反应(reactions),适用于设计评审场景;
4. 设计系统与自动化:提取设计令牌(figma_extract_design_tokens)并直接转换为 Tailwind CSS 配置,同时支持文件/项目/团队级 Webhook 创建,实现设计变更事件推送。
显著优点
- 零配置集成:ClawLink 托管 OAuth 流程,消除 API Key 管理负担,降低泄露风险;
- Tailwind 原生支持:设计令牌到 Tailwind 配置的自动转换,打通设计-开发链路;
- 细粒度权限控制:读取操作开箱即用,写入操作(评论、Webhook、删除)强制要求用户显式确认;
- 资源发现智能化:URL 自动解析功能让用户无需手动查找 file_key 和 node_id。
潜在缺点与局限性
- 文件类型限制:仅支持 Design 文件(
figma.com/design/),FigJam 画板与 Slides 文件会返回 400 错误; - 设计令牌覆盖不全:未编码为 Figma Styles 或 Variables 的设计元素会被静默忽略;
- Webhook 权限门槛:团队级 Webhook 需管理员权限,项目/文件级需编辑权限;
- 图片 URL 时效性:下载链接 14 天过期,需立即消费;
- 评论结构限制:回复不支持嵌套,仅可附加于根评论。
适合人群
- 前端开发者需要从 Figma 提取设计令牌并生成 Tailwind 配置;
- 产品经理与设计师需要批量导出设计资源或自动化设计评审流程;
- 工程团队需要建立设计变更监听与 CI/CD 联动(通过 Webhook)。
常规风险
- OAuth 范围风险:授权后 ClawLink 可访问用户所有可访问的 Figma 文件,需信任托管方安全能力;
- 写入误操作:评论删除、Webhook 删除等破坏性操作需严格遵循确认流程,避免不可逆数据丢失;
- 文件权限漂移:共享文件权限变更可能导致后续 API 调用 403/404,需保持连接状态监控。