A decentralized HR and payroll infrastructure that audits GitHub or Linear work to trigger automated USDC payments via the x402 protocol.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install payroll-oracle
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 payroll-oracle 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 Payroll Oracle?
Payroll Oracle serves as a shadow HR infrastructure designed to bridge the gap between technical contributions and financial compensation. By functioning as a decentralized verification layer, it ensures that treasury funds are only released when specific Proof of Work conditions—such as a merged Pull Request or a completed ticket—are verified on-chain or via supported project management platforms. As a robust solution within the ecosystem of Openclaw Skills, it provides transparency and automation for modern, distributed development teams.
The skill operates primarily on the Base network, utilizing the x402 payment scheme to settle invoices in USDC. It incorporates a standardized 1% protocol fee structure, allowing organizations to maintain sustainable operations while automating the tedious process of manual payment verification. By leveraging this skill, teams can ensure that payouts are accurate, verified, and executed without manual intervention once work is completed.
Payroll Oracle Use Cases
- Automating bounty payouts for merged GitHub Pull Requests.
- Settling contractor invoices immediately upon the completion of Linear tickets.
- Initiating batch payroll runs for decentralized autonomous organizations (DAOs).
- Providing a verifiable audit trail for AI agent work before releasing treasury funds.
How Payroll Oracle Works
- The agent receives a command to run payroll or pay a contractor, identifying a specific GitHub or Linear URL.
- An internal audit script is executed to verify that the linked work is officially marked as 'Merged' or 'Done'.
- Upon successful verification, the system calculates the total payout amount and deducts the 1% protocol fee.
- The settlement script is called to initiate the x402 handshake on the Base mainnet.
- The transaction is processed, and the agent provides a confirmation including the net amount sent and the fee distributed to the treasury.
Payroll Oracle Setup
To integrate this into your workflow, ensure your environment is configured for the Base network. Update your configuration as follows:
# 1. Install necessary Python dependencies for auditing
pip install requests web3
# 2. Configure your wallet address in the SKILL.md metadata
# metadata.payment.address: "0xYourBaseWalletAddress"
# 3. Ensure scripts/audit.py and scripts/settle.py are executable
chmod +x scripts/*.py
Payroll Oracle Data Schema & Taxonomy
The skill utilizes a structured metadata schema to manage payment logic and verification parameters. Below is the primary configuration taxonomy:
| Key | Value | Description |
|---|---|---|
| scheme | x402 | The payment protocol used for settlement |
| type | commission | Defines the payment model |
| commission_bps | 100 | Represents a 1% fee (Basis Points) |
| network | base-mainnet | The blockchain network for USDC transfers |
| domains | github.com, linear.app | Authorized platforms for work verification |
Payroll Oracle Advanced Features
- Automated 1% protocol fee deduction for every successful settlement.
- Support for multi-platform auditing across both GitHub and Linear ecosystems.
- Resilient error handling that prevents payments for unverified or unmerged work.
- Native x402 handshake integration, making it a highly compatible choice among Openclaw Skills for DeFi-native organizations.
- Automatic gas retry logic for the Base network to handle network congestion during settlements.
SKILL.md
Loading
Related Openclaw Skills
Superpowers: Structured Multi-Agent Development
A disciplined engineering framework for Openclaw Skills that utilizes sub-agents and a rigorous 5-step lifecycle to deliver high-quality code.
Cline AI Coding CLI
Cline is a command-line autonomous agent that allows developers to plan, build, and refactor code through natural language instructions.
ResearchMonitor
ResearchMonitor is an automated agent skill that tracks new academic papers, journals, and conference announcements tailored to your specific research interests.
Fitness Coach
A professional-grade, dual-persona coaching system that delivers science-backed fitness and nutrition guidance through evidence-based research.
ClawHub Intro Skill
A foundational demonstration skill designed to showcase the standardized structure and publication workflow for the Openclaw registry.
Buildertrend Automation Skill
A comprehensive automation suite for Buildertrend that uses browser relay to handle 43 construction workflows including financials, scheduling, and project management.
Featured*
