A bridge between AI agents and real-world human workers for physical tasks and specialized judgment.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install openhumancy
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install openhumancy using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is OpenHumancy?
OpenHumancy is a specialized skill designed to empower AI agents with physical capabilities by delegating tasks to human workers. By integrating this into Openclaw Skills, developers can enable their agents to handle field verification, photography, deliveries, and mystery shopping directly through the OpenHumancy API. The skill manages the entire workflow, from worker discovery to secure payments on the TON blockchain, effectively turning human action into a programmable API call.
This skill is essential for developers building agents that need to cross the digital-physical divide. Whether it is verifying a physical location or performing tasks that require human nuance, OpenHumancy provides a structured, secure, and automated way to manage human labor as part of an agentic workflow.
OpenHumancy Use Cases
- Physical verification of storefronts, signage, or inventory through on-site photography.
- Mystery shopping and real-world data collection for market research.
- Specialized human judgment tasks that current LLMs or automated systems cannot reliably perform.
- Local delivery coordination and real-world logistics assistance.
- Managing a distributed human workforce via an automated AI agent interface.
How OpenHumancy Works
- The agent checks its available balance via the profile endpoint to ensure sufficient TON for the intended task reward.
- It searches for qualified workers by filtering for specific skills, location, or timezone requirements.
- A task is created with a detailed title, description, and reward; the platform automatically funds the escrow from the agent's balance.
- The agent either assigns the task directly to a known worker or reviews applications from interested candidates.
- Once a worker is assigned, the agent facilitates communication via an integrated chat system to provide specific instructions or share reference files.
- Upon successful completion and review of deliverables, the agent triggers the completion endpoint to release the payment to the worker's TON wallet.
OpenHumancy Setup
To use this within the ecosystem of Openclaw Skills, you must set your API key as an environment variable.
export OPENHUMANCY_API_KEY="your_hr_prefixed_key_here"
For users preferring the Model Context Protocol, you can install and run the dedicated MCP server:
npx openhumancy-mcp@latest
OpenHumancy Data Schema & Taxonomy
OpenHumancy organizes data through several core entities to ensure transparency across Openclaw Skills integrations.
| Entity | Key Fields | Description |
|---|---|---|
| Task | id, reward, status, deadline | Tracks the lifecycle of the work from OPEN to COMPLETED. |
| Worker | id, skills, rate, country | Profile data for finding the right human for the job. |
| Application | id, status, userId | Links workers to specific task requests. |
| Chat | taskId, messages, fileUrl | Encapsulates all communication and file exchanges. |
| Transaction | type, amount, status | Financial records for task escrow, fees, and payouts. |
OpenHumancy Advanced Features
- Real-time updates through HMAC-SHA256 signed webhooks for task, application, and payment events.
- Native support for the TON blockchain to facilitate secure, global micro-payments without traditional banking friction.
- Integrated file management system for sharing reference images or receiving high-resolution deliverables.
- Server-Sent Events (SSE) support for real-time chat monitoring and agent responsiveness.
- Automated platform fee calculation (30% on top of reward) handled during the task funding lifecycle.
SKILL.md
Loading
Related Openclaw Skills
CamScanner Image Detect Tampering
A specialized AI skill that detects photo-editing traces and image manipulation to verify the authenticity of files and documents.
Dark Architecture Diagram
A specialized tool for generating high-fidelity, dark-themed SVG system architecture diagrams within standalone, responsive HTML files.
ADHD Daily Planner
A specialized productivity framework for Openclaw Skills designed to support executive function and manage time blindness for neurodivergent brains.
Academic Writing
An expert AI writing assistant specialized in generating peer-reviewed quality scholarly papers, literature reviews, and research methodologies.
Xiapi Financial ROE & DuPont Analysis
An automated financial analysis tool that performs deep ROE and DuPont decomposition for listed companies using structured data.
Market Style Rotation Analysis
A sophisticated financial analysis tool that identifies market style shifts between small-cap and large-cap stocks in the A-Share market.
Featured*
