什么是 Miro？

Miro 技能为与 Miro 协作白板平台交互提供了强大的接口。它允许开发人员和 AI 代理在无需人工干预的情况下创建、读取和修改画板元素。通过将此功能集成到您的 Openclaw Skills 套件中，您可以直接从开发环境自动执行视觉头脑风暴、项目映射和团队协作工作流程。

此技能专注于利用 Miro V2 API 处理核心画板对象。无论您是在生成复杂的图表，还是仅仅是在整理团队反馈，这种集成都能确保您的视觉工作空间与程序数据和逻辑保持同步。

下载入口:https://github.com/openclaw/skills/tree/main/skills/mrgoodb/miro

安装与下载

1. ClawHub CLI

从源直接安装技能的最快方式。

2. 手动安装

将技能文件夹复制到以下位置之一

优先级：工作区 > 本地 > 内置

3. 提示词安装

将此提示词复制到 OpenClaw 即可自动安装。

Miro 应用场景

• 为每个新冲刺自动创建新的项目规划板。
• 从任务列表或会议记录中通过编程生成便签。
• 通过创建几何形状和连接符来可视化系统架构。
• 通过列出所有画板和活动项目来审计协作空间。
• 使用 Openclaw Skills 将实时数据集成到视觉仪表盘中。

1. 该技能使用安全的 MIRO_ACCESS_TOKEN 与 Miro 平台进行身份验证。
2. 用户可以触发请求以列出现有画板或使用特定元数据创建新画布。
3. 针对目标画板，该技能发送 POST 请求，以精确坐标定义便签或形状等项目。
4. 颜色和几何形状的高级样式选项通过 JSON 负载应用。
5. 该技能还可以查询画板上的所有项目，以检索当前状态，以便在 Openclaw Skills 中进行进一步的自动化。

Miro 配置指南

要启用此技能，您必须提供 Miro API 访问令牌。按如下方式设置环境变量：

export MIRO_ACCESS_TOKEN="your_miro_access_token_here"

您可以通过在 Miro 开发者门户中创建开发者应用并授权给您的团队来获取访问令牌。

Miro 数据架构与分类体系

该技能使用以下主要结构与 Miro 的数据模型交互：

name: miro
description: Manage Miro boards, sticky notes, and shapes via Miro API. Create collaborative whiteboards programmatically.
metadata: {"clawdbot":{"emoji":"??","requires":{"env":["MIRO_ACCESS_TOKEN"]}}}

Miro

Collaborative whiteboard platform.

Environment

export MIRO_ACCESS_TOKEN="xxxxxxxxxx"

List Boards

curl "https://api.miro.com/v2/boards" r
  -H "Authorization: Bearer $MIRO_ACCESS_TOKEN"

Create Board

curl -X POST "https://api.miro.com/v2/boards" r
  -H "Authorization: Bearer $MIRO_ACCESS_TOKEN" r
  -H "Content-Type: application/json" r
  -d '{"name": "Project Planning", "description": "Sprint planning board"}'

Get Board

curl "https://api.miro.com/v2/boards/{board_id}" r
  -H "Authorization: Bearer $MIRO_ACCESS_TOKEN"

Create Sticky Note

curl -X POST "https://api.miro.com/v2/boards/{board_id}/sticky_notes" r
  -H "Authorization: Bearer $MIRO_ACCESS_TOKEN" r
  -H "Content-Type: application/json" r
  -d '{
    "data": {"content": "New idea!", "shape": "square"},
    "position": {"x": 0, "y": 0},
    "style": {"fillColor": "yellow"}
  }'

Create Shape

curl -X POST "https://api.miro.com/v2/boards/{board_id}/shapes" r
  -H "Authorization: Bearer $MIRO_ACCESS_TOKEN" r
  -H "Content-Type: application/json" r
  -d '{
    "data": {"shape": "rectangle", "content": "Task 1"},
    "position": {"x": 100, "y": 100},
    "geometry": {"width": 200, "height": 100}
  }'

Get All Items on Board

curl "https://api.miro.com/v2/boards/{board_id}/items" r
  -H "Authorization: Bearer $MIRO_ACCESS_TOKEN"

Links

• Dashboard: https://miro.com/app/dashboard/
• Docs: https://developers.miro.com/reference/api-reference