{
  "schemaVersion": "1.0",
  "item": {
    "slug": "flomo-via-app",
    "name": "Flomo Via App",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/qiantao1001/flomo-via-app",
    "canonicalUrl": "https://clawhub.ai/qiantao1001/flomo-via-app",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/flomo-via-app",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=flomo-via-app",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "README.md",
      "SKILL.md",
      "_meta.json",
      "references/api.md",
      "scripts/configure.sh",
      "scripts/flomo_send.sh"
    ],
    "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/flomo-via-app"
    },
    "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/flomo-via-app",
    "agentPageUrl": "https://openagent3.xyz/skills/flomo-via-app/agent",
    "manifestUrl": "https://openagent3.xyz/skills/flomo-via-app/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/flomo-via-app/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": "Flomo via App",
        "body": "Send notes to flomo using URL Scheme, with automatic webhook fallback for reliability.\n\n⚠️ 首次使用提示: 安装后请先运行 ./scripts/configure.sh 进行配置"
      },
      {
        "title": "1. 配置（首次使用必需）",
        "body": "./scripts/configure.sh\n\n运行后会交互式询问：\n\n是否有 flomo PRO 账户\nWebhook token/URL\n保存位置（默认保存到 skill 目录的 .env 文件）\n\n配置默认保存到 .env 文件，这样更便于管理和隔离。"
      },
      {
        "title": "2. 发送笔记",
        "body": "scripts/flomo_send.sh \"Your note content\" \"#tag1 #tag2\"\n\nOr manually via URL scheme:\n\nopen \"flomo://create?content=Hello%20World&tag=daily\""
      },
      {
        "title": "How It Works",
        "body": "The script uses a dual-channel strategy for maximum reliability:\n\nPrimary: URL Scheme → Opens flomo app directly (instant, local)\nFallback: Webhook API → HTTP POST to flomo servers (works without app)\n\nIf the flomo app is not installed or open command fails, it automatically falls back to webhook."
      },
      {
        "title": "Basic Usage",
        "body": "# Simple note\n./scripts/flomo_send.sh \"My quick thought\"\n\n# With tags\n./scripts/flomo_send.sh \"Meeting notes from today\" \"#work #meeting\"\n\n# From clipboard\n./scripts/flomo_send.sh \"$(pbpaste)\" \"#clippings\"\n\n# From stdin\necho \"Note from pipe\" | ./scripts/flomo_send.sh"
      },
      {
        "title": "Webhook Configuration (Optional)",
        "body": "If you ran ./scripts/configure.sh during setup, webhook is already configured.\n\nTo manually configure, set environment variable:\n\n# Option 1: Full webhook URL\nexport FLOMO_WEBHOOK_URL=\"https://flomoapp.com/iwh/xxxxxxxxxxxxxxxx\"\n\n# Option 2: Just the token\nexport FLOMO_WEBHOOK_TOKEN=\"xxxxxxxxxxxxxxxx\"\n\n# Then run script\n./scripts/flomo_send.sh \"Note with fallback\" \"#test\""
      },
      {
        "title": "Send Text Note",
        "body": "./scripts/flomo_send.sh \"Your note here\""
      },
      {
        "title": "Send with Tags",
        "body": "Tags in format #tagname will be automatically parsed by flomo.\n\n./scripts/flomo_send.sh \"Reading notes\" \"#books #learning\""
      },
      {
        "title": "Multi-line Notes",
        "body": "./scripts/flomo_send.sh \"Line 1\nLine 2\nLine 3\" \"#journal\""
      },
      {
        "title": "Send with Images (URL Scheme only)",
        "body": "Note: The flomo_send.sh script currently supports text only. To send images, use URL Scheme directly:\n\n# Via URL Scheme directly (supports up to 9 images)\nopen \"flomo://create?image_urls=%5B%22https://example.com/img1.jpg%22%5D&content=Photo%20notes\"\n\nImage URLs must be:\n\nPublicly accessible URLs\nURL-encoded JSON array format\nMaximum 9 images per note\n\nSee references/api.md for more details on image parameters."
      },
      {
        "title": "URL Scheme Format",
        "body": "Direct URL scheme usage (macOS only):\n\nBase URL: flomo://create\nParameters:\n\ncontent (optional): The note content, URL-encoded, max 5000 chars\nimage_urls (optional): JSON array of image URLs, URL-encoded, max 9 images"
      },
      {
        "title": "Examples",
        "body": "Text only:\n\nopen \"flomo://create?content=Your%20URL-encoded%20content\"\n\nWith images:\n\nopen \"flomo://create?image_urls=%5B%22https://example.com/img.jpg%22%5D&content=Photo%20notes\"\n\nThe image_urls parameter format:\n\nJSON array of publicly accessible image URLs\nMust be URL-encoded with encodeURIComponent"
      },
      {
        "title": "Examples",
        "body": "Save a link:\n\n./scripts/flomo_send.sh \"https://example.com/article\" \"#readlater #tech\"\n\nDaily journal:\n\n./scripts/flomo_send.sh \"Morning reflection: feeling productive today\" \"#journal\"\n\nQuick idea capture:\n\n./scripts/flomo_send.sh \"App idea: AI-powered plant water reminder\" \"#ideas\"\n\nRemote/SSH session (uses webhook):\n\nexport FLOMO_WEBHOOK_TOKEN=\"your-token\"\n./scripts/flomo_send.sh \"Note from server\" \"#server-log\""
      },
      {
        "title": "Requirements",
        "body": "⚠️ API 和 URL Scheme 功能需要 flomo PRO 会员 才能使用。"
      },
      {
        "title": "URL Scheme (Primary)",
        "body": "macOS with flomo app installed\nflomo app v1.5+ (supports URL Scheme)\nflomo PRO 会员"
      },
      {
        "title": "Webhook Fallback",
        "body": "curl command available\nFLOMO_WEBHOOK_URL or FLOMO_WEBHOOK_TOKEN environment variable set\nflomo PRO 会员"
      },
      {
        "title": "Limitations",
        "body": "Content: Maximum 5000 characters (before URL encoding)\nImages: Maximum 9 images per note (URL Scheme only; webhook does not support images)"
      },
      {
        "title": "Environment Variables",
        "body": "VariableDescriptionExampleFLOMO_WEBHOOK_URLFull webhook URLhttps://flomoapp.com/iwh/abc123FLOMO_WEBHOOK_TOKENWebhook token onlyabc123"
      },
      {
        "title": "Persistent Configuration",
        "body": "Add to your ~/.bashrc, ~/.zshrc, or ~/.bash_profile:\n\nexport FLOMO_WEBHOOK_TOKEN=\"your-webhook-token-here\""
      },
      {
        "title": "Troubleshooting",
        "body": "\"Error: Webhook not configured\"\n→ Set FLOMO_WEBHOOK_URL or FLOMO_WEBHOOK_TOKEN environment variable\n\n\"Error: flomo URL scheme failed\"\n→ Normal if app not installed; check if webhook fallback succeeded\n\nUnicode/Chinese characters not working\n→ The script auto-encodes UTF-8; if issues persist, check Python3 availability"
      },
      {
        "title": "API Reference",
        "body": "For detailed webhook API documentation, see references/api.md."
      }
    ],
    "body": "Flomo via App\n\nSend notes to flomo using URL Scheme, with automatic webhook fallback for reliability.\n\n⚠️ 首次使用提示: 安装后请先运行 ./scripts/configure.sh 进行配置\n\nQuick Start\n1. 配置（首次使用必需）\n./scripts/configure.sh\n\n\n运行后会交互式询问：\n\n是否有 flomo PRO 账户\nWebhook token/URL\n保存位置（默认保存到 skill 目录的 .env 文件）\n\n配置默认保存到 .env 文件，这样更便于管理和隔离。\n\n2. 发送笔记\nscripts/flomo_send.sh \"Your note content\" \"#tag1 #tag2\"\n\n\nOr manually via URL scheme:\n\nopen \"flomo://create?content=Hello%20World&tag=daily\"\n\nHow It Works\n\nThe script uses a dual-channel strategy for maximum reliability:\n\nPrimary: URL Scheme → Opens flomo app directly (instant, local)\nFallback: Webhook API → HTTP POST to flomo servers (works without app)\n\nIf the flomo app is not installed or open command fails, it automatically falls back to webhook.\n\nScript Usage\nBasic Usage\n# Simple note\n./scripts/flomo_send.sh \"My quick thought\"\n\n# With tags\n./scripts/flomo_send.sh \"Meeting notes from today\" \"#work #meeting\"\n\n# From clipboard\n./scripts/flomo_send.sh \"$(pbpaste)\" \"#clippings\"\n\n# From stdin\necho \"Note from pipe\" | ./scripts/flomo_send.sh\n\nWebhook Configuration (Optional)\n\nIf you ran ./scripts/configure.sh during setup, webhook is already configured.\n\nTo manually configure, set environment variable:\n\n# Option 1: Full webhook URL\nexport FLOMO_WEBHOOK_URL=\"https://flomoapp.com/iwh/xxxxxxxxxxxxxxxx\"\n\n# Option 2: Just the token\nexport FLOMO_WEBHOOK_TOKEN=\"xxxxxxxxxxxxxxxx\"\n\n# Then run script\n./scripts/flomo_send.sh \"Note with fallback\" \"#test\"\n\nSupported Actions\nSend Text Note\n./scripts/flomo_send.sh \"Your note here\"\n\nSend with Tags\n\nTags in format #tagname will be automatically parsed by flomo.\n\n./scripts/flomo_send.sh \"Reading notes\" \"#books #learning\"\n\nMulti-line Notes\n./scripts/flomo_send.sh \"Line 1\nLine 2\nLine 3\" \"#journal\"\n\nSend with Images (URL Scheme only)\n\nNote: The flomo_send.sh script currently supports text only. To send images, use URL Scheme directly:\n\n# Via URL Scheme directly (supports up to 9 images)\nopen \"flomo://create?image_urls=%5B%22https://example.com/img1.jpg%22%5D&content=Photo%20notes\"\n\n\nImage URLs must be:\n\nPublicly accessible URLs\nURL-encoded JSON array format\nMaximum 9 images per note\n\nSee references/api.md for more details on image parameters.\n\nURL Scheme Format\n\nDirect URL scheme usage (macOS only):\n\nBase URL: flomo://create\nParameters:\ncontent (optional): The note content, URL-encoded, max 5000 chars\nimage_urls (optional): JSON array of image URLs, URL-encoded, max 9 images\nExamples\n\nText only:\n\nopen \"flomo://create?content=Your%20URL-encoded%20content\"\n\n\nWith images:\n\nopen \"flomo://create?image_urls=%5B%22https://example.com/img.jpg%22%5D&content=Photo%20notes\"\n\n\nThe image_urls parameter format:\n\nJSON array of publicly accessible image URLs\nMust be URL-encoded with encodeURIComponent\nExamples\n\nSave a link:\n\n./scripts/flomo_send.sh \"https://example.com/article\" \"#readlater #tech\"\n\n\nDaily journal:\n\n./scripts/flomo_send.sh \"Morning reflection: feeling productive today\" \"#journal\"\n\n\nQuick idea capture:\n\n./scripts/flomo_send.sh \"App idea: AI-powered plant water reminder\" \"#ideas\"\n\n\nRemote/SSH session (uses webhook):\n\nexport FLOMO_WEBHOOK_TOKEN=\"your-token\"\n./scripts/flomo_send.sh \"Note from server\" \"#server-log\"\n\nRequirements\n\n⚠️ API 和 URL Scheme 功能需要 flomo PRO 会员 才能使用。\n\nURL Scheme (Primary)\nmacOS with flomo app installed\nflomo app v1.5+ (supports URL Scheme)\nflomo PRO 会员\nWebhook Fallback\ncurl command available\nFLOMO_WEBHOOK_URL or FLOMO_WEBHOOK_TOKEN environment variable set\nflomo PRO 会员\nLimitations\nContent: Maximum 5000 characters (before URL encoding)\nImages: Maximum 9 images per note (URL Scheme only; webhook does not support images)\nConfiguration\nEnvironment Variables\nVariable\tDescription\tExample\nFLOMO_WEBHOOK_URL\tFull webhook URL\thttps://flomoapp.com/iwh/abc123\nFLOMO_WEBHOOK_TOKEN\tWebhook token only\tabc123\nPersistent Configuration\n\nAdd to your ~/.bashrc, ~/.zshrc, or ~/.bash_profile:\n\nexport FLOMO_WEBHOOK_TOKEN=\"your-webhook-token-here\"\n\nTroubleshooting\n\n\"Error: Webhook not configured\" → Set FLOMO_WEBHOOK_URL or FLOMO_WEBHOOK_TOKEN environment variable\n\n\"Error: flomo URL scheme failed\" → Normal if app not installed; check if webhook fallback succeeded\n\nUnicode/Chinese characters not working → The script auto-encodes UTF-8; if issues persist, check Python3 availability\n\nAPI Reference\n\nFor detailed webhook API documentation, see references/api.md."
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/qiantao1001/flomo-via-app",
    "publisherUrl": "https://clawhub.ai/qiantao1001/flomo-via-app",
    "owner": "qiantao1001",
    "version": "1.0.8",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/flomo-via-app",
    "downloadUrl": "https://openagent3.xyz/downloads/flomo-via-app",
    "agentUrl": "https://openagent3.xyz/skills/flomo-via-app/agent",
    "manifestUrl": "https://openagent3.xyz/skills/flomo-via-app/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/flomo-via-app/agent.md"
  }
}