Mural

Mural

Mural

Mural is a collaborative whiteboard platform for visual thinking and team collaboration. This integration provides managed OAuth through ClawLink, so you can browse workspaces, rooms, murals, and widgets without handling API keys or tokens yourself.

Setup in 3 Steps

How It Works

┌─────────────────┐     ┌──────────────┐     ┌──────────────────┐
│   OpenClaw      │────▶│   ClawLink   │────▶│   Mural API      │
│   (User Chat)   │     │   (OAuth)    │     │                  │
└─────────────────┘     └──────────────┘     └──────────────────┘

Install

openclaw plugins install clawhub:clawlink-plugin
openclaw config set tools.alsoAllow '["clawlink-plugin"]' --strict-json
openclaw gateway restart

Quick Start

List your workspaces and browse murals:

clawlink_execute_tool --integration mural --tool mural_get_workspaces

Search for a specific mural by name:

clawlink_execute_tool --integration mural --tool mural_search_murals --args '{"query": "sprint retro", "workspaceId": "ws-123"}'

Add a sticky note to a mural:

clawlink_execute_tool --integration mural --tool mural_create_sticky_note --args '{"muralId": "mur-456", "stickies": [{"x": 100, "y": 200, "text": "Action item: Update docs"}]}'

Authentication

Mural uses OAuth 2.0 managed by ClawLink. No API keys are needed. When you connect Mural through the ClawLink dashboard, you authorize access via a standard OAuth login flow. The connection is stored securely and refreshed automatically.

Connect at: https://claw-link.dev/dashboard?add=mural

Connection Management

List connections:

clawlink_list_integrations

Verify connection:

clawlink_execute_tool --integration mural --tool mural_get_current_user

Reconnect: If a connection expires, visit the dashboard URL above and reconnect Mural.

Security & Permissions

• Read operations (browsing workspaces, rooms, murals, widgets, templates, tags) are safe and require no confirmation.
• Write operations (creating sticky notes) modify mural content and require explicit confirmation before execution.
• All operations respect the permissions of the authenticated Mural user.

Tool Reference

User & Authentication

Workspace Operations

Room Operations

Mural Operations

Folder Operations

Template Operations

Tag Operations

Code Examples

List workspaces and get murals:

{
  "tool": "mural_get_workspaces",
  "args": {}
}

Search for murals containing "roadmap":

{
  "tool": "mural_search_murals",
  "args": {
    "query": "roadmap",
    "workspaceId": "workspace-uuid-here"
  }
}

Add sticky notes to a mural:

{
  "tool": "mural_create_sticky_note",
  "args": {
    "muralId": "mural-uuid-here",
    "stickies": [
      {"x": 100, "y": 200, "text": "First note"},
      {"x": 300, "y": 400, "text": "Second note", "shape": "circle"}
    ]
  }
}

Get all widgets in a mural:

{
  "tool": "mural_get_mural_widgets",
  "args": {
    "muralId": "mural-uuid-here"
  }
}

Browse room members:

{
  "tool": "mural_list_room_users",
  "args": {
    "roomId": "room-uuid-here"
  }
}

Discovery Workflow

1. Call clawlink_list_integrations to confirm mural is connected.
2. Call clawlink_list_tools --integration mural to see the live catalog.
3. Start with mural_get_workspaces to discover available workspaces.
4. Use mural_list_rooms to navigate rooms within a workspace.
5. Use mural_list_room_murals or mural_search_murals to find specific murals.

Execution Workflow

Read Flow:
  get_workspaces → get_room / list_rooms → list_room_murals → get_mural_widgets

Write Flow:
  get_workspaces → search_murals → create_sticky_note (confirm required)

Notes

• Sticky notes require proper x/y coordinates. Always provide a direct array of objects for the stickies parameter, not strings or nested objects.
• Workspaces, rooms, and murals follow a hierarchy: Workspace > Room > Mural. Navigate top-down.
• The mural_search_murals tool returns murals the user owns or is a member of, not all murals in the workspace.

Error Handling

Troubleshooting

Tools Not Visible

Run clawlink_list_tools --integration mural to verify the integration is active. If empty, reconnect at https://claw-link.dev/dashboard?add=mural.

Invalid Tool Call

Ensure you pass valid UUIDs for workspaceId, roomId, and muralId. These are obtained from parent-level listing tools.

Sticky Note Creation Fails

Verify the stickies parameter is a flat array of objects with x, y, and text fields. Do not wrap in extra objects or pass as strings.

Resources

• Mural API Docs: https://developers.mural.co/public/docs
• ClawLink: https://claw-link.dev/?utm_source=clawhub&utm_medium=referral&utm_content=mural
• ClawLink Docs: https://docs.claw-link.dev/openclaw

---

Powered by ClawLink -- an integration hub for OpenClaw

ClawLink Logo