{
  "schemaVersion": "1.0",
  "item": {
    "slug": "openclaw-menubar",
    "name": "openclaw menubar",
    "source": "tencent",
    "type": "skill",
    "category": "通讯协作",
    "sourceUrl": "https://clawhub.ai/prab002/openclaw-menubar",
    "canonicalUrl": "https://clawhub.ai/prab002/openclaw-menubar",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/openclaw-menubar",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=openclaw-menubar",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "MENUBAR-INSTALL.md",
      "README.md",
      "SKILL.md",
      "assets/openclaw-menubar/test-discovery.js",
      "assets/openclaw-menubar/MARKETPLACE.md",
      "assets/openclaw-menubar/renderer.js"
    ],
    "primaryDoc": "SKILL.md",
    "quickSetup": [
      "Download the package from Yavira.",
      "Extract the archive and review SKILL.md first.",
      "Import or place the package into your OpenClaw setup."
    ],
    "agentAssist": {
      "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
      "steps": [
        "Download the package from Yavira.",
        "Extract it into a folder your agent can access.",
        "Paste one of the prompts below and point your agent at the extracted folder."
      ],
      "prompts": [
        {
          "label": "New install",
          "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Then review README.md for any prerequisites, environment setup, or post-install checks. Tell me what you changed and call out any manual steps you could not complete."
        },
        {
          "label": "Upgrade existing",
          "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run."
        }
      ]
    },
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-30T16:55:25.780Z",
      "expiresAt": "2026-05-07T16:55:25.780Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
        "contentDisposition": "attachment; filename=\"network-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/openclaw-menubar"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    },
    "downloadPageUrl": "https://openagent3.xyz/downloads/openclaw-menubar",
    "agentPageUrl": "https://openagent3.xyz/skills/openclaw-menubar/agent",
    "manifestUrl": "https://openagent3.xyz/skills/openclaw-menubar/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/openclaw-menubar/agent.md"
  },
  "agentAssist": {
    "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
    "steps": [
      "Download the package from Yavira.",
      "Extract it into a folder your agent can access.",
      "Paste one of the prompts below and point your agent at the extracted folder."
    ],
    "prompts": [
      {
        "label": "New install",
        "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Then review README.md for any prerequisites, environment setup, or post-install checks. Tell me what you changed and call out any manual steps you could not complete."
      },
      {
        "label": "Upgrade existing",
        "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run."
      }
    ]
  },
  "documentation": {
    "source": "clawhub",
    "primaryDoc": "SKILL.md",
    "sections": [
      {
        "title": "OpenClaw Menu Bar",
        "body": "⚠️ macOS ONLY - This skill requires macOS. Menu bar apps are not supported on Windows or Linux.\n\nAdds a native macOS menu bar app for quick OpenClaw access - click the crab icon 🦀 in your menu bar to get an instant chat popup."
      },
      {
        "title": "Install & Launch",
        "body": "scripts/install.sh\nscripts/start.sh\n\nThe crab icon will appear in your menu bar. Click it to open the chat window."
      },
      {
        "title": "Stop",
        "body": "scripts/stop.sh"
      },
      {
        "title": "Check Status",
        "body": "scripts/status.sh"
      },
      {
        "title": "What It Does",
        "body": "Menu bar icon: Crab 🦀 icon appears in macOS menu bar\nQuick popup: Click icon → instant chat window (no browser needed)\nKeyboard shortcut: Cmd+Shift+O to toggle popup\nNative feel: Proper macOS vibrancy, stays on top when needed\nLightweight: Electron app, ~480x680px popup window"
      },
      {
        "title": "Icon Setup",
        "body": "The menubar app requires two icon files in assets/openclaw-menubar/icons/:\n\nicon.png (22x22 pixels, transparent PNG)\nicon@2x.png (44x44 pixels, transparent PNG)"
      },
      {
        "title": "Option 1: Auto-generate icons",
        "body": "cd assets/openclaw-menubar\n./create-icon.sh\n\nThis creates a simple crab emoji icon."
      },
      {
        "title": "Option 2: Custom icons",
        "body": "Replace the generated icons with your own 22x22 and 44x44 transparent PNGs.\n\nNote: macOS menu bar uses monochrome template mode (auto-colorizes your icon)."
      },
      {
        "title": "Window Size",
        "body": "Edit assets/openclaw-menubar/main.js:\n\nbrowserWindow: {\n  width: 480,  // Change width\n  height: 680  // Change height\n}"
      },
      {
        "title": "Keyboard Shortcut",
        "body": "Edit assets/openclaw-menubar/main.js:\n\nglobalShortcut.register('CommandOrControl+Shift+O', () => {\n  // Change 'O' to any key\n});"
      },
      {
        "title": "Architecture",
        "body": "Electron app using menubar package\nHeader: Custom HTML header (index-webchat.html) with branding\nContent: OpenClaw webchat loaded via BrowserView with auth token\nAuto-auth: Reads gateway config from ~/.openclaw/openclaw.json"
      },
      {
        "title": "Requirements",
        "body": "macOS (menu bar apps are macOS-specific)\nOpenClaw Gateway running on localhost\nNode.js (for Electron)"
      },
      {
        "title": "Icon not showing",
        "body": "Icon must be 22x22 PNG with transparent background\nmacOS menu bar uses monochrome template mode (auto-colorizes)"
      },
      {
        "title": "\"OpenClaw Not Running\" error",
        "body": "Ensure OpenClaw Gateway is running: openclaw gateway status\nCheck config: cat ~/.openclaw/openclaw.json"
      },
      {
        "title": "Window doesn't open",
        "body": "Check logs in Console.app (search \"OpenClaw\")\nTry: scripts/stop.sh && scripts/start.sh"
      },
      {
        "title": "Files",
        "body": "assets/openclaw-menubar/ - Complete Electron app\nscripts/install.sh - Install dependencies (npm install)\nscripts/start.sh - Launch the menu bar app\nscripts/stop.sh - Kill the app process\nscripts/status.sh - Check if app is running"
      }
    ],
    "body": "OpenClaw Menu Bar\n\n⚠️ macOS ONLY - This skill requires macOS. Menu bar apps are not supported on Windows or Linux.\n\nAdds a native macOS menu bar app for quick OpenClaw access - click the crab icon 🦀 in your menu bar to get an instant chat popup.\n\nQuick Start\nInstall & Launch\nscripts/install.sh\nscripts/start.sh\n\n\nThe crab icon will appear in your menu bar. Click it to open the chat window.\n\nStop\nscripts/stop.sh\n\nCheck Status\nscripts/status.sh\n\nWhat It Does\nMenu bar icon: Crab 🦀 icon appears in macOS menu bar\nQuick popup: Click icon → instant chat window (no browser needed)\nKeyboard shortcut: Cmd+Shift+O to toggle popup\nNative feel: Proper macOS vibrancy, stays on top when needed\nLightweight: Electron app, ~480x680px popup window\nIcon Setup\n\nThe menubar app requires two icon files in assets/openclaw-menubar/icons/:\n\nicon.png (22x22 pixels, transparent PNG)\nicon@2x.png (44x44 pixels, transparent PNG)\nOption 1: Auto-generate icons\ncd assets/openclaw-menubar\n./create-icon.sh\n\n\nThis creates a simple crab emoji icon.\n\nOption 2: Custom icons\n\nReplace the generated icons with your own 22x22 and 44x44 transparent PNGs.\n\nNote: macOS menu bar uses monochrome template mode (auto-colorizes your icon).\n\nWindow Size\n\nEdit assets/openclaw-menubar/main.js:\n\nbrowserWindow: {\n  width: 480,  // Change width\n  height: 680  // Change height\n}\n\nKeyboard Shortcut\n\nEdit assets/openclaw-menubar/main.js:\n\nglobalShortcut.register('CommandOrControl+Shift+O', () => {\n  // Change 'O' to any key\n});\n\nArchitecture\nElectron app using menubar package\nHeader: Custom HTML header (index-webchat.html) with branding\nContent: OpenClaw webchat loaded via BrowserView with auth token\nAuto-auth: Reads gateway config from ~/.openclaw/openclaw.json\nRequirements\nmacOS (menu bar apps are macOS-specific)\nOpenClaw Gateway running on localhost\nNode.js (for Electron)\nTroubleshooting\nIcon not showing\nIcon must be 22x22 PNG with transparent background\nmacOS menu bar uses monochrome template mode (auto-colorizes)\n\"OpenClaw Not Running\" error\nEnsure OpenClaw Gateway is running: openclaw gateway status\nCheck config: cat ~/.openclaw/openclaw.json\nWindow doesn't open\nCheck logs in Console.app (search \"OpenClaw\")\nTry: scripts/stop.sh && scripts/start.sh\nFiles\nassets/openclaw-menubar/ - Complete Electron app\nscripts/install.sh - Install dependencies (npm install)\nscripts/start.sh - Launch the menu bar app\nscripts/stop.sh - Kill the app process\nscripts/status.sh - Check if app is running"
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/prab002/openclaw-menubar",
    "publisherUrl": "https://clawhub.ai/prab002/openclaw-menubar",
    "owner": "prab002",
    "version": "1.0.0",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/openclaw-menubar",
    "downloadUrl": "https://openagent3.xyz/downloads/openclaw-menubar",
    "agentUrl": "https://openagent3.xyz/skills/openclaw-menubar/agent",
    "manifestUrl": "https://openagent3.xyz/skills/openclaw-menubar/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/openclaw-menubar/agent.md"
  }
}