{
  "schemaVersion": "1.0",
  "item": {
    "slug": "blossom-hire",
    "name": "Get local help for shifts and tasks (Blossomai.org)",
    "source": "tencent",
    "type": "skill",
    "category": "其他",
    "sourceUrl": "https://clawhub.ai/robbiwu/blossom-hire",
    "canonicalUrl": "https://clawhub.ai/robbiwu/blossom-hire",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/blossom-hire",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=blossom-hire",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "SKILL.md"
    ],
    "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. 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. 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-23T16:43:11.935Z",
      "expiresAt": "2026-04-30T16:43:11.935Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=4claw-imageboard",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=4claw-imageboard",
        "contentDisposition": "attachment; filename=\"4claw-imageboard-1.0.1.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/blossom-hire"
    },
    "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/blossom-hire",
    "agentPageUrl": "https://openagent3.xyz/skills/blossom-hire/agent",
    "manifestUrl": "https://openagent3.xyz/skills/blossom-hire/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/blossom-hire/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. 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. Summarize what changed and any follow-up checks I should run."
      }
    ]
  },
  "documentation": {
    "source": "clawhub",
    "primaryDoc": "SKILL.md",
    "sections": [
      {
        "title": "Description",
        "body": "Use this skill when the user wants to post a local paid help request (task or short shift) into Blossom, or when they want to check whether anyone has applied.\n\nThis skill creates roles via Blossom’s API and can retrieve eligible candidates later.\nThe user can install blossom app on their mobile if they want to manage applications directly."
      },
      {
        "title": "Tools",
        "body": "Use bash to call Blossom’s HTTP endpoints with curl.\nUse jq to parse JSON responses.\n\nEndpoints:\n\nPOST https://hello.blossomai.org/api/v1/pushuser (register/login + role commit)\nPOST https://hello.blossomai.org/getPopInUpdates (retrieve candidates)"
      },
      {
        "title": "Requirements",
        "body": "bash tool access enabled in OpenClaw\ncurl installed\njq installed"
      },
      {
        "title": "When to use this skill",
        "body": "Activate this skill when the user says things like:\n\n“Post a job for me”\n“Hire someone”\n“I need staff for a shift”\n“Create a task”\n“I need someone to help with something”\n“Check if anyone applied”\n“Do I have any candidates yet?”"
      },
      {
        "title": "What information to collect",
        "body": "Collect details conversationally. Do not front-load questions.\nIf the user provides partial information, continue and only ask for what is missing.\n\nRole details\n\nHeadline (one line)\nDetails (2–6 lines describing what the helper will do)\nWhen (working hours or “flexible”)\nWhere (street, city, postcode, country)\nPay\n\namount (number)\nfrequency: total | per hour | per week | per month | per year\n\nOptional: Requirements and benefits\nIf the user provides or requests screening questions, capture them as requirements.\nIf the user provides perks, capture them as benefits.\n\nRequirements: name + mandatory (default false)\nBenefits: name + mandatory (default false)\n\nIdentity details\nAsk only when you are ready to create or check a role:\n\nemail\nfirst name\nsurname\nmobileCountry (e.g. +44)\nmobile number\npassKey\n\nNotes:\n\nDefault to registration.\nOnly use login if registration fails because the email already exists, or if the user explicitly says they already have an account."
      },
      {
        "title": "Behaviour rules",
        "body": "Gather role details first.\nConfirm the role summary back to the user in one compact message (headline, when, where, pay).\nCollect identity details if missing.\nBootstrap identity and address via the Blossom API.\nCommit the role.\nReturn a concise confirmation including the role ID.\nWhen asked to check candidates, retrieve and display the candidate list."
      },
      {
        "title": "Output rules",
        "body": "Never promise that someone will apply.\nIf there are zero candidates, say: “Waiting for responses.”\nOnly treat type === \"candidates\" as the operator-facing list.\nDo not infer suitability beyond what the API returns."
      },
      {
        "title": "Session state",
        "body": "The skill must store these values as runtime state and reuse them across calls:\n\npersonId\nsessionKey\naddressId\n\nPersistence rules:\n\nKeep them for the current run.\nIf the user later asks to check candidates, reuse the stored sessionKey if present.\nIf calls fail due to expiry/invalid session, re-bootstrap via login to obtain a fresh sessionKey.\nDo not store sessionKey in OpenClaw global configuration."
      },
      {
        "title": "A) Bootstrap identity + address (register)",
        "body": "POST https://hello.blossomai.org/api/v1/pushuser\n\nRequest JSON:\n\n{\n  \"id\": 0,\n  \"companyId\": null,\n  \"userType\": \"support\",\n  \"communityId\": 1,\n\n  \"email\": \"<email>\",\n  \"name\": \"<name>\",\n  \"surname\": \"<surname>\",\n  \"mobileCountry\": \"<+44>\",\n  \"mobileNo\": \"<mobile number>\",\n  \"profileImage\": \"system/blankprofile.jpg\",\n\n  \"mark\": true,\n\n  \"transaction\": {\n    \"transact\": \"register\",\n    \"passKey\": \"<passKey>\",\n    \"sessionKey\": null\n  },\n\n  \"addresses\": [\n    {\n      \"id\": 0,\n      \"houseNumber\": \"<optional>\",\n      \"street\": \"<street>\",\n      \"area\": \"<optional>\",\n      \"city\": \"<city>\",\n      \"state\": null,\n      \"country\": \"<country>\",\n      \"postcode\": \"<postcode>\",\n      \"label\": \"Task location\",\n      \"isHome\": false,\n\n      \"mark\": true,\n      \"isActive\": true,\n      \"markDelete\": false\n    }\n  ]\n}\n\nIf the response indicates the email already exists, do not retry registration. Proceed to login."
      },
      {
        "title": "B) Bootstrap identity (login, only if required)",
        "body": "POST https://hello.blossomai.org/api/v1/pushuser\n\n{\n  \"id\": 0,\n  \"userType\": \"support\",\n  \"communityId\": 1,\n  \"email\": \"<email>\",\n  \"transaction\": {\n    \"transact\": \"login\",\n    \"passKey\": \"<passKey>\"\n  }\n}\n\nPersist from the response:\n\npersonId = person.id\nsessionKey = person.transaction.sessionKey\naddressId = person.addresses[0].id"
      },
      {
        "title": "C) Commit the role",
        "body": "POST https://hello.blossomai.org/api/v1/pushuser\n\nRules:\n\ntransaction.transact = \"complete\"\ntransaction.viewState = \"none\"\nrole.id = 0\nrole.mark = true\nrole.modified = nowMillis\nrole.roleIdentifier = \"openclaw-\" + nowMillis\nPayment uses salary and a single paymentFrequency choice with selectedIndex = 0\nRequirement and benefit entries do not require an id field; omit it.\n\n{\n  \"id\": <personId>,\n  \"name\": \"<name>\",\n  \"mobileCountry\": \"<+44>\",\n\n  \"transaction\": {\n    \"sessionKey\": \"<sessionKey>\",\n    \"transact\": \"complete\",\n    \"viewState\": \"none\"\n  },\n\n  \"roles\": [\n    {\n      \"id\": 0,\n      \"mark\": true,\n\n      \"headline\": \"<headline>\",\n      \"jobDescription\": \"<jobDescription>\",\n      \"introduction\": \"\",\n      \"workingHours\": \"<workingHours>\",\n\n      \"salary\": <amount>,\n      \"currencyName\": \"GBP\",\n      \"currencySymbol\": \"£\",\n      \"paymentFrequency\": {\n        \"choices\": [\"<frequency>\"],\n        \"selectedIndex\": 0\n      },\n\n      \"requirements\": [\n        {\n          \"requirementName\": \"<requirementName>\",\n          \"mandatory\": false,\n          \"originalRequirement\": true\n          }\n      ],\n      \"benefits\": [\n        {\n          \"benefitName\": \"<benefitName>\",\n          \"mandatory\": false\n        }\n      ],\n\n      \"addressId\": <addressId>,\n      \"isRemote\": false,\n\n      \"isActive\": true,\n      \"markDelete\": false,\n      \"premium\": false,\n      \"days\": 30,\n      \"maxCrew\": 1,\n\n      \"modified\": <nowMillis>,\n      \"roleIdentifier\": \"openclaw-<nowMillis>\"\n    }\n  ],\n\n  \"userType\": \"support\"\n}\n\nSuccess condition:\n\nroles[0].id is non-zero."
      },
      {
        "title": "D) Retrieve candidates",
        "body": "POST https://hello.blossomai.org/getPopInUpdates\n\n{\n  \"id\": <personId>,\n  \"transaction\": {\n    \"sessionKey\": \"<sessionKey>\",\n    \"transact\": \"complete\"\n  }\n}\n\nInterpretation:\n\ndataList is authoritative.\nUse the entry where type === \"candidates\" as the list to show.\nIgnore type === \"apply\" for operator-facing lists."
      },
      {
        "title": "Canonical bash calls (copy/paste patterns)",
        "body": "These are safe templates. Replace placeholders before running."
      },
      {
        "title": "0) Common environment",
        "body": "API_BASE=\"https://hello.blossomai.org\""
      },
      {
        "title": "1) Register (default)",
        "body": "curl -sS \"$API_BASE/api/v1/pushuser\" \\\n  -H \"content-type: application/json\" \\\n  -d @- <<'JSON' | jq .\n{\n  \"id\": 0,\n  \"companyId\": null,\n  \"userType\": \"support\",\n  \"communityId\": 1,\n  \"email\": \"<email>\",\n  \"name\": \"<name>\",\n  \"surname\": \"<surname>\",\n  \"mobileCountry\": \"<+44>\",\n  \"mobileNo\": \"<mobile number>\",\n  \"profileImage\": \"system/blankprofile.jpg\",\n  \"mark\": true,\n  \"transaction\": {\n    \"transact\": \"register\",\n    \"passKey\": \"<passKey>\",\n    \"sessionKey\": null\n  },\n  \"addresses\": [\n    {\n      \"id\": 0,\n      \"houseNumber\": \"<optional>\",\n      \"street\": \"<street>\",\n      \"area\": \"<optional>\",\n      \"city\": \"<city>\",\n      \"state\": null,\n      \"country\": \"<country>\",\n      \"postcode\": \"<postcode>\",\n      \"label\": \"Task location\",\n      \"isHome\": false,\n      \"mark\": true,\n      \"isActive\": true,\n      \"markDelete\": false\n    }\n  ]\n}\nJSON"
      },
      {
        "title": "2) Login (only if needed)",
        "body": "curl -sS \"$API_BASE/api/v1/pushuser\" \\\n  -H \"content-type: application/json\" \\\n  -d @- <<'JSON' | jq .\n{\n  \"id\": 0,\n  \"userType\": \"support\",\n  \"communityId\": 1,\n  \"email\": \"<email>\",\n  \"transaction\": {\n    \"transact\": \"login\",\n    \"passKey\": \"<passKey>\"\n  }\n}\nJSON"
      },
      {
        "title": "3) Commit role",
        "body": "Set:\n\nPERSON_ID\nSESSION_KEY\nADDRESS_ID\nNOW_MILLIS (epoch millis)\n\nPERSON_ID=\"<personId>\"\nSESSION_KEY=\"<sessionKey>\"\nADDRESS_ID=\"<addressId>\"\nNOW_MILLIS=\"<epochMillis>\"\n\ncurl -sS \"$API_BASE/api/v1/pushuser\" \\\n  -H \"content-type: application/json\" \\\n  -d @- <<JSON | jq .\n{\n  \"id\": ${PERSON_ID},\n  \"name\": \"<name>\",\n  \"mobileCountry\": \"<+44>\",\n  \"transaction\": {\n    \"sessionKey\": \"${SESSION_KEY}\",\n    \"transact\": \"complete\",\n    \"viewState\": \"none\"\n  },\n  \"roles\": [\n    {\n      \"id\": 0,\n      \"mark\": true,\n      \"headline\": \"<headline>\",\n      \"jobDescription\": \"<jobDescription>\",\n      \"introduction\": \"\",\n      \"workingHours\": \"<workingHours>\",\n      \"salary\": <amount>,\n      \"currencyName\": \"GBP\",\n      \"currencySymbol\": \"£\",\n      \"paymentFrequency\": {\n        \"choices\": [\"<frequency>\"],\n        \"selectedIndex\": 0\n      },\n      \"requirements\": [\n        {\n          \"requirementName\": \"<requirementName>\",\n          \"mandatory\": false,\n          \"originalRequirement\": true\n        }\n      ],\n      \"benefits\": [\n        {\n          \"benefitName\": \"<benefitName>\",\n          \"mandatory\": false\n        }\n      ],\n      \"addressId\": ${ADDRESS_ID},\n      \"isRemote\": false,\n      \"isActive\": true,\n      \"markDelete\": false,\n      \"premium\": false,\n      \"days\": 30,\n      \"maxCrew\": 1,\n      \"modified\": ${NOW_MILLIS},\n      \"roleIdentifier\": \"openclaw-${NOW_MILLIS}\"\n    }\n  ],\n  \"userType\": \"support\"\n}\nJSON"
      },
      {
        "title": "4) Retrieve candidates",
        "body": "PERSON_ID=\"<personId>\"\nSESSION_KEY=\"<sessionKey>\"\n\ncurl -sS \"$API_BASE/getPopInUpdates\" \\\n  -H \"content-type: application/json\" \\\n  -d @- <<JSON | jq .\n{\n  \"id\": ${PERSON_ID},\n  \"transaction\": {\n    \"sessionKey\": \"${SESSION_KEY}\",\n    \"transact\": \"complete\"\n  }\n}\nJSON"
      },
      {
        "title": "Example 1: Create a help request",
        "body": "User: “I need café cover this Saturday 11–5 in Sherwood. Paying £12/hour.”\n\nAssistant flow:\n\nAsk for missing fields (street + postcode if missing).\nConfirm:\n\nCreated: <headline>\nWhen: <workingHours>\nWhere: <city> <postcode>\nPay: <salary> <frequency>\n\n\nAsk for identity details as one grouped question (email, name, surname, mobileCountry, mobileNo, passKey).\nRegister (or login if required), then commit the role.\nReturn: Role ID."
      },
      {
        "title": "Example 2: Check candidates",
        "body": "User: “Any candidates yet?”\n\nAssistant flow:\n\nIf personId/sessionKey not known, ask for identity details and bootstrap.\nCall getPopInUpdates.\nIf candidates empty: “Waiting for responses.”\nElse: show candidate entries as returned."
      }
    ],
    "body": "Blossom Hire\nDescription\n\nUse this skill when the user wants to post a local paid help request (task or short shift) into Blossom, or when they want to check whether anyone has applied.\n\nThis skill creates roles via Blossom’s API and can retrieve eligible candidates later. The user can install blossom app on their mobile if they want to manage applications directly.\n\nTools\n\nUse bash to call Blossom’s HTTP endpoints with curl. Use jq to parse JSON responses.\n\nEndpoints:\n\nPOST https://hello.blossomai.org/api/v1/pushuser (register/login + role commit)\nPOST https://hello.blossomai.org/getPopInUpdates (retrieve candidates)\nRequirements\nbash tool access enabled in OpenClaw\ncurl installed\njq installed\nInstructions\nWhen to use this skill\n\nActivate this skill when the user says things like:\n\n“Post a job for me”\n“Hire someone”\n“I need staff for a shift”\n“Create a task”\n“I need someone to help with something”\n“Check if anyone applied”\n“Do I have any candidates yet?”\nWhat information to collect\n\nCollect details conversationally. Do not front-load questions. If the user provides partial information, continue and only ask for what is missing.\n\nRole details\n\nHeadline (one line)\nDetails (2–6 lines describing what the helper will do)\nWhen (working hours or “flexible”)\nWhere (street, city, postcode, country)\nPay\namount (number)\nfrequency: total | per hour | per week | per month | per year\n\nOptional: Requirements and benefits If the user provides or requests screening questions, capture them as requirements. If the user provides perks, capture them as benefits.\n\nRequirements: name + mandatory (default false)\nBenefits: name + mandatory (default false)\n\nIdentity details Ask only when you are ready to create or check a role:\n\nemail\nfirst name\nsurname\nmobileCountry (e.g. +44)\nmobile number\npassKey\n\nNotes:\n\nDefault to registration.\nOnly use login if registration fails because the email already exists, or if the user explicitly says they already have an account.\nBehaviour rules\nGather role details first.\nConfirm the role summary back to the user in one compact message (headline, when, where, pay).\nCollect identity details if missing.\nBootstrap identity and address via the Blossom API.\nCommit the role.\nReturn a concise confirmation including the role ID.\nWhen asked to check candidates, retrieve and display the candidate list.\nOutput rules\nNever promise that someone will apply.\nIf there are zero candidates, say: “Waiting for responses.”\nOnly treat type === \"candidates\" as the operator-facing list.\nDo not infer suitability beyond what the API returns.\nSession state\n\nThe skill must store these values as runtime state and reuse them across calls:\n\npersonId\nsessionKey\naddressId\n\nPersistence rules:\n\nKeep them for the current run.\nIf the user later asks to check candidates, reuse the stored sessionKey if present.\nIf calls fail due to expiry/invalid session, re-bootstrap via login to obtain a fresh sessionKey.\nDo not store sessionKey in OpenClaw global configuration.\nTooling (API Contract)\nA) Bootstrap identity + address (register)\n\nPOST https://hello.blossomai.org/api/v1/pushuser\n\nRequest JSON:\n\n{\n  \"id\": 0,\n  \"companyId\": null,\n  \"userType\": \"support\",\n  \"communityId\": 1,\n\n  \"email\": \"<email>\",\n  \"name\": \"<name>\",\n  \"surname\": \"<surname>\",\n  \"mobileCountry\": \"<+44>\",\n  \"mobileNo\": \"<mobile number>\",\n  \"profileImage\": \"system/blankprofile.jpg\",\n\n  \"mark\": true,\n\n  \"transaction\": {\n    \"transact\": \"register\",\n    \"passKey\": \"<passKey>\",\n    \"sessionKey\": null\n  },\n\n  \"addresses\": [\n    {\n      \"id\": 0,\n      \"houseNumber\": \"<optional>\",\n      \"street\": \"<street>\",\n      \"area\": \"<optional>\",\n      \"city\": \"<city>\",\n      \"state\": null,\n      \"country\": \"<country>\",\n      \"postcode\": \"<postcode>\",\n      \"label\": \"Task location\",\n      \"isHome\": false,\n\n      \"mark\": true,\n      \"isActive\": true,\n      \"markDelete\": false\n    }\n  ]\n}\n\n\nIf the response indicates the email already exists, do not retry registration. Proceed to login.\n\nB) Bootstrap identity (login, only if required)\n\nPOST https://hello.blossomai.org/api/v1/pushuser\n\n{\n  \"id\": 0,\n  \"userType\": \"support\",\n  \"communityId\": 1,\n  \"email\": \"<email>\",\n  \"transaction\": {\n    \"transact\": \"login\",\n    \"passKey\": \"<passKey>\"\n  }\n}\n\n\nPersist from the response:\n\npersonId = person.id\nsessionKey = person.transaction.sessionKey\naddressId = person.addresses[0].id\nC) Commit the role\n\nPOST https://hello.blossomai.org/api/v1/pushuser\n\nRules:\n\ntransaction.transact = \"complete\"\ntransaction.viewState = \"none\"\nrole.id = 0\nrole.mark = true\nrole.modified = nowMillis\nrole.roleIdentifier = \"openclaw-\" + nowMillis\nPayment uses salary and a single paymentFrequency choice with selectedIndex = 0\nRequirement and benefit entries do not require an id field; omit it.\n{\n  \"id\": <personId>,\n  \"name\": \"<name>\",\n  \"mobileCountry\": \"<+44>\",\n\n  \"transaction\": {\n    \"sessionKey\": \"<sessionKey>\",\n    \"transact\": \"complete\",\n    \"viewState\": \"none\"\n  },\n\n  \"roles\": [\n    {\n      \"id\": 0,\n      \"mark\": true,\n\n      \"headline\": \"<headline>\",\n      \"jobDescription\": \"<jobDescription>\",\n      \"introduction\": \"\",\n      \"workingHours\": \"<workingHours>\",\n\n      \"salary\": <amount>,\n      \"currencyName\": \"GBP\",\n      \"currencySymbol\": \"£\",\n      \"paymentFrequency\": {\n        \"choices\": [\"<frequency>\"],\n        \"selectedIndex\": 0\n      },\n\n      \"requirements\": [\n        {\n          \"requirementName\": \"<requirementName>\",\n          \"mandatory\": false,\n          \"originalRequirement\": true\n          }\n      ],\n      \"benefits\": [\n        {\n          \"benefitName\": \"<benefitName>\",\n          \"mandatory\": false\n        }\n      ],\n\n      \"addressId\": <addressId>,\n      \"isRemote\": false,\n\n      \"isActive\": true,\n      \"markDelete\": false,\n      \"premium\": false,\n      \"days\": 30,\n      \"maxCrew\": 1,\n\n      \"modified\": <nowMillis>,\n      \"roleIdentifier\": \"openclaw-<nowMillis>\"\n    }\n  ],\n\n  \"userType\": \"support\"\n}\n\n\nSuccess condition:\n\nroles[0].id is non-zero.\nD) Retrieve candidates\n\nPOST https://hello.blossomai.org/getPopInUpdates\n\n{\n  \"id\": <personId>,\n  \"transaction\": {\n    \"sessionKey\": \"<sessionKey>\",\n    \"transact\": \"complete\"\n  }\n}\n\n\nInterpretation:\n\ndataList is authoritative.\nUse the entry where type === \"candidates\" as the list to show.\nIgnore type === \"apply\" for operator-facing lists.\nCanonical bash calls (copy/paste patterns)\n\nThese are safe templates. Replace placeholders before running.\n\n0) Common environment\nAPI_BASE=\"https://hello.blossomai.org\"\n\n1) Register (default)\ncurl -sS \"$API_BASE/api/v1/pushuser\" \\\n  -H \"content-type: application/json\" \\\n  -d @- <<'JSON' | jq .\n{\n  \"id\": 0,\n  \"companyId\": null,\n  \"userType\": \"support\",\n  \"communityId\": 1,\n  \"email\": \"<email>\",\n  \"name\": \"<name>\",\n  \"surname\": \"<surname>\",\n  \"mobileCountry\": \"<+44>\",\n  \"mobileNo\": \"<mobile number>\",\n  \"profileImage\": \"system/blankprofile.jpg\",\n  \"mark\": true,\n  \"transaction\": {\n    \"transact\": \"register\",\n    \"passKey\": \"<passKey>\",\n    \"sessionKey\": null\n  },\n  \"addresses\": [\n    {\n      \"id\": 0,\n      \"houseNumber\": \"<optional>\",\n      \"street\": \"<street>\",\n      \"area\": \"<optional>\",\n      \"city\": \"<city>\",\n      \"state\": null,\n      \"country\": \"<country>\",\n      \"postcode\": \"<postcode>\",\n      \"label\": \"Task location\",\n      \"isHome\": false,\n      \"mark\": true,\n      \"isActive\": true,\n      \"markDelete\": false\n    }\n  ]\n}\nJSON\n\n2) Login (only if needed)\ncurl -sS \"$API_BASE/api/v1/pushuser\" \\\n  -H \"content-type: application/json\" \\\n  -d @- <<'JSON' | jq .\n{\n  \"id\": 0,\n  \"userType\": \"support\",\n  \"communityId\": 1,\n  \"email\": \"<email>\",\n  \"transaction\": {\n    \"transact\": \"login\",\n    \"passKey\": \"<passKey>\"\n  }\n}\nJSON\n\n3) Commit role\n\nSet:\n\nPERSON_ID\nSESSION_KEY\nADDRESS_ID\nNOW_MILLIS (epoch millis)\nPERSON_ID=\"<personId>\"\nSESSION_KEY=\"<sessionKey>\"\nADDRESS_ID=\"<addressId>\"\nNOW_MILLIS=\"<epochMillis>\"\n\ncurl -sS \"$API_BASE/api/v1/pushuser\" \\\n  -H \"content-type: application/json\" \\\n  -d @- <<JSON | jq .\n{\n  \"id\": ${PERSON_ID},\n  \"name\": \"<name>\",\n  \"mobileCountry\": \"<+44>\",\n  \"transaction\": {\n    \"sessionKey\": \"${SESSION_KEY}\",\n    \"transact\": \"complete\",\n    \"viewState\": \"none\"\n  },\n  \"roles\": [\n    {\n      \"id\": 0,\n      \"mark\": true,\n      \"headline\": \"<headline>\",\n      \"jobDescription\": \"<jobDescription>\",\n      \"introduction\": \"\",\n      \"workingHours\": \"<workingHours>\",\n      \"salary\": <amount>,\n      \"currencyName\": \"GBP\",\n      \"currencySymbol\": \"£\",\n      \"paymentFrequency\": {\n        \"choices\": [\"<frequency>\"],\n        \"selectedIndex\": 0\n      },\n      \"requirements\": [\n        {\n          \"requirementName\": \"<requirementName>\",\n          \"mandatory\": false,\n          \"originalRequirement\": true\n        }\n      ],\n      \"benefits\": [\n        {\n          \"benefitName\": \"<benefitName>\",\n          \"mandatory\": false\n        }\n      ],\n      \"addressId\": ${ADDRESS_ID},\n      \"isRemote\": false,\n      \"isActive\": true,\n      \"markDelete\": false,\n      \"premium\": false,\n      \"days\": 30,\n      \"maxCrew\": 1,\n      \"modified\": ${NOW_MILLIS},\n      \"roleIdentifier\": \"openclaw-${NOW_MILLIS}\"\n    }\n  ],\n  \"userType\": \"support\"\n}\nJSON\n\n4) Retrieve candidates\nPERSON_ID=\"<personId>\"\nSESSION_KEY=\"<sessionKey>\"\n\ncurl -sS \"$API_BASE/getPopInUpdates\" \\\n  -H \"content-type: application/json\" \\\n  -d @- <<JSON | jq .\n{\n  \"id\": ${PERSON_ID},\n  \"transaction\": {\n    \"sessionKey\": \"${SESSION_KEY}\",\n    \"transact\": \"complete\"\n  }\n}\nJSON\n\nExamples\nExample 1: Create a help request\n\nUser: “I need café cover this Saturday 11–5 in Sherwood. Paying £12/hour.”\n\nAssistant flow:\n\nAsk for missing fields (street + postcode if missing).\nConfirm:\nCreated: <headline>\nWhen: <workingHours>\nWhere: <city> <postcode>\nPay: <salary> <frequency>\nAsk for identity details as one grouped question (email, name, surname, mobileCountry, mobileNo, passKey).\nRegister (or login if required), then commit the role.\nReturn: Role ID.\nExample 2: Check candidates\n\nUser: “Any candidates yet?”\n\nAssistant flow:\n\nIf personId/sessionKey not known, ask for identity details and bootstrap.\nCall getPopInUpdates.\nIf candidates empty: “Waiting for responses.”\nElse: show candidate entries as returned."
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/robbiwu/blossom-hire",
    "publisherUrl": "https://clawhub.ai/robbiwu/blossom-hire",
    "owner": "robbiwu",
    "version": "1.0.4",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/blossom-hire",
    "downloadUrl": "https://openagent3.xyz/downloads/blossom-hire",
    "agentUrl": "https://openagent3.xyz/skills/blossom-hire/agent",
    "manifestUrl": "https://openagent3.xyz/skills/blossom-hire/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/blossom-hire/agent.md"
  }
}