Requirements
- Target platform
- OpenClaw
- Install method
- Manual import
- Extraction
- Extract archive
- Prerequisites
- OpenClaw
- Primary doc
- SKILL.md
Post a job, task, or paid shift to hire local help in Blossom, then check eligible candidates.
Post a job, task, or paid shift to hire local help in Blossom, then check eligible candidates.
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
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.
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.
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. This 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.
Use bash to call Blossom’s HTTP endpoints with curl. Use jq to parse JSON responses. Endpoints: POST https://hello.blossomai.org/api/v1/pushuser (register/login + role commit) POST https://hello.blossomai.org/getPopInUpdates (retrieve candidates)
bash tool access enabled in OpenClaw curl installed jq installed
Activate this skill when the user says things like: “Post a job for me” “Hire someone” “I need staff for a shift” “Create a task” “I need someone to help with something” “Check if anyone applied” “Do I have any candidates yet?”
Collect details conversationally. Do not front-load questions. If the user provides partial information, continue and only ask for what is missing. Role details Headline (one line) Details (2–6 lines describing what the helper will do) When (working hours or “flexible”) Where (street, city, postcode, country) Pay amount (number) frequency: total | per hour | per week | per month | per year Optional: Requirements and benefits If the user provides or requests screening questions, capture them as requirements. If the user provides perks, capture them as benefits. Requirements: name + mandatory (default false) Benefits: name + mandatory (default false) Identity details Ask only when you are ready to create or check a role: email first name surname mobileCountry (e.g. +44) mobile number passKey Notes: Default to registration. Only use login if registration fails because the email already exists, or if the user explicitly says they already have an account.
Gather role details first. Confirm the role summary back to the user in one compact message (headline, when, where, pay). Collect identity details if missing. Bootstrap identity and address via the Blossom API. Commit the role. Return a concise confirmation including the role ID. When asked to check candidates, retrieve and display the candidate list.
Never promise that someone will apply. If there are zero candidates, say: “Waiting for responses.” Only treat type === "candidates" as the operator-facing list. Do not infer suitability beyond what the API returns.
The skill must store these values as runtime state and reuse them across calls: personId sessionKey addressId Persistence rules: Keep them for the current run. If the user later asks to check candidates, reuse the stored sessionKey if present. If calls fail due to expiry/invalid session, re-bootstrap via login to obtain a fresh sessionKey. Do not store sessionKey in OpenClaw global configuration.
POST https://hello.blossomai.org/api/v1/pushuser Request JSON: { "id": 0, "companyId": null, "userType": "support", "communityId": 1, "email": "<email>", "name": "<name>", "surname": "<surname>", "mobileCountry": "<+44>", "mobileNo": "<mobile number>", "profileImage": "system/blankprofile.jpg", "mark": true, "transaction": { "transact": "register", "passKey": "<passKey>", "sessionKey": null }, "addresses": [ { "id": 0, "houseNumber": "<optional>", "street": "<street>", "area": "<optional>", "city": "<city>", "state": null, "country": "<country>", "postcode": "<postcode>", "label": "Task location", "isHome": false, "mark": true, "isActive": true, "markDelete": false } ] } If the response indicates the email already exists, do not retry registration. Proceed to login.
POST https://hello.blossomai.org/api/v1/pushuser { "id": 0, "userType": "support", "communityId": 1, "email": "<email>", "transaction": { "transact": "login", "passKey": "<passKey>" } } Persist from the response: personId = person.id sessionKey = person.transaction.sessionKey addressId = person.addresses[0].id
POST https://hello.blossomai.org/api/v1/pushuser Rules: transaction.transact = "complete" transaction.viewState = "none" role.id = 0 role.mark = true role.modified = nowMillis role.roleIdentifier = "openclaw-" + nowMillis Payment uses salary and a single paymentFrequency choice with selectedIndex = 0 Requirement and benefit entries do not require an id field; omit it. { "id": <personId>, "name": "<name>", "mobileCountry": "<+44>", "transaction": { "sessionKey": "<sessionKey>", "transact": "complete", "viewState": "none" }, "roles": [ { "id": 0, "mark": true, "headline": "<headline>", "jobDescription": "<jobDescription>", "introduction": "", "workingHours": "<workingHours>", "salary": <amount>, "currencyName": "GBP", "currencySymbol": "£", "paymentFrequency": { "choices": ["<frequency>"], "selectedIndex": 0 }, "requirements": [ { "requirementName": "<requirementName>", "mandatory": false, "originalRequirement": true } ], "benefits": [ { "benefitName": "<benefitName>", "mandatory": false } ], "addressId": <addressId>, "isRemote": false, "isActive": true, "markDelete": false, "premium": false, "days": 30, "maxCrew": 1, "modified": <nowMillis>, "roleIdentifier": "openclaw-<nowMillis>" } ], "userType": "support" } Success condition: roles[0].id is non-zero.
POST https://hello.blossomai.org/getPopInUpdates { "id": <personId>, "transaction": { "sessionKey": "<sessionKey>", "transact": "complete" } } Interpretation: dataList is authoritative. Use the entry where type === "candidates" as the list to show. Ignore type === "apply" for operator-facing lists.
These are safe templates. Replace placeholders before running.
API_BASE="https://hello.blossomai.org"
curl -sS "$API_BASE/api/v1/pushuser" \ -H "content-type: application/json" \ -d @- <<'JSON' | jq . { "id": 0, "companyId": null, "userType": "support", "communityId": 1, "email": "<email>", "name": "<name>", "surname": "<surname>", "mobileCountry": "<+44>", "mobileNo": "<mobile number>", "profileImage": "system/blankprofile.jpg", "mark": true, "transaction": { "transact": "register", "passKey": "<passKey>", "sessionKey": null }, "addresses": [ { "id": 0, "houseNumber": "<optional>", "street": "<street>", "area": "<optional>", "city": "<city>", "state": null, "country": "<country>", "postcode": "<postcode>", "label": "Task location", "isHome": false, "mark": true, "isActive": true, "markDelete": false } ] } JSON
curl -sS "$API_BASE/api/v1/pushuser" \ -H "content-type: application/json" \ -d @- <<'JSON' | jq . { "id": 0, "userType": "support", "communityId": 1, "email": "<email>", "transaction": { "transact": "login", "passKey": "<passKey>" } } JSON
Set: PERSON_ID SESSION_KEY ADDRESS_ID NOW_MILLIS (epoch millis) PERSON_ID="<personId>" SESSION_KEY="<sessionKey>" ADDRESS_ID="<addressId>" NOW_MILLIS="<epochMillis>" curl -sS "$API_BASE/api/v1/pushuser" \ -H "content-type: application/json" \ -d @- <<JSON | jq . { "id": ${PERSON_ID}, "name": "<name>", "mobileCountry": "<+44>", "transaction": { "sessionKey": "${SESSION_KEY}", "transact": "complete", "viewState": "none" }, "roles": [ { "id": 0, "mark": true, "headline": "<headline>", "jobDescription": "<jobDescription>", "introduction": "", "workingHours": "<workingHours>", "salary": <amount>, "currencyName": "GBP", "currencySymbol": "£", "paymentFrequency": { "choices": ["<frequency>"], "selectedIndex": 0 }, "requirements": [ { "requirementName": "<requirementName>", "mandatory": false, "originalRequirement": true } ], "benefits": [ { "benefitName": "<benefitName>", "mandatory": false } ], "addressId": ${ADDRESS_ID}, "isRemote": false, "isActive": true, "markDelete": false, "premium": false, "days": 30, "maxCrew": 1, "modified": ${NOW_MILLIS}, "roleIdentifier": "openclaw-${NOW_MILLIS}" } ], "userType": "support" } JSON
PERSON_ID="<personId>" SESSION_KEY="<sessionKey>" curl -sS "$API_BASE/getPopInUpdates" \ -H "content-type: application/json" \ -d @- <<JSON | jq . { "id": ${PERSON_ID}, "transaction": { "sessionKey": "${SESSION_KEY}", "transact": "complete" } } JSON
User: “I need café cover this Saturday 11–5 in Sherwood. Paying £12/hour.” Assistant flow: Ask for missing fields (street + postcode if missing). Confirm: Created: <headline> When: <workingHours> Where: <city> <postcode> Pay: <salary> <frequency> Ask for identity details as one grouped question (email, name, surname, mobileCountry, mobileNo, passKey). Register (or login if required), then commit the role. Return: Role ID.
User: “Any candidates yet?” Assistant flow: If personId/sessionKey not known, ask for identity details and bootstrap. Call getPopInUpdates. If candidates empty: “Waiting for responses.” Else: show candidate entries as returned.
Long-tail utilities that do not fit the current primary taxonomy cleanly.
Largest current source with strong distribution and engagement signals.