Openclaw Skill

AI-powered HR Operating System for Southeast Asia. Full payroll with PH/SG/LK compliance, 9 AI agents (payroll specialist, compliance officer, leave advisor...), attendance with GPS geofencing, leave/OT/expense workflows, org intelligence with flight risk & burnout detection. Zero-setup via OpenClaw.

tonypk@tonypk

Install

openclaw skills install @tonypk/halaos-hr

HalaOS — AI-Powered HR Operating System

Enterprise HR system built for Southeast Asia. Handles employees, attendance, leave, payroll, tax compliance, benefits, loans, training, performance reviews, and more — with 9 specialized AI agents that understand local labor law.

Zero setup for basic use. Install and start asking HR questions immediately. Connect your HalaOS account for full platform access.

How It Works

This skill operates in two modes:

Mode 1: OpenClaw Native (Default — No Registration Needed)

AI HR assistant powered by your OpenClaw channels. Answers HR questions, calculates PH/SG/LK government contributions, generates compliance documents, and manages team data locally.

Just install and start:

text

/halaos-hr
> Calculate SSS contribution for salary 25,000 PHP
> How many vacation leave days does Philippine labor law require?
> Generate a Certificate of Employment for John Santos
> What are the BIR filing deadlines this quarter?
> Calculate 13th month pay for employee with 180,000 annual salary

Mode 2: Cloud Platform (Full Features — Requires Registration)

Connect to your HalaOS account for the complete HR platform: payroll processing, attendance tracking, leave management, AI-powered org intelligence, and automated compliance.

Set HALAOS_API_KEY to enable. See "Cloud Platform Setup" section below.

What It Does

Core HR

Employee Management: Profiles, 201 files, document tracking, salary assignment, org chart, directory
Attendance & Time: Clock in/out, GPS geofencing, shift scheduling, DTR reports, correction workflows
Leave Management: Balances, requests, approvals, calendar, carryover, encashment
Overtime: Request submission, approval workflow, rate calculation
Payroll: Multi-frequency cycles, automated computation, payslips, 13th month pay, final pay, bonus structures
Benefits: Plan enrollment, dependent management, claims workflow
Loans: Application, approval, amortization, salary deduction integration

Compliance & Tax (Southeast Asia)

Philippines: SSS, PhilHealth, Pag-IBIG, BIR withholding tax (TRAIN Law), BIR 2316/2550M/2550Q/1601C/1701/1702/0619E/SAWT
Sri Lanka: EPF/ETF filings
Singapore: IRAS compliance
Reports: DTR, DOLE register, CSV/bank file export

Workforce Operations

Onboarding/Offboarding: Templates, checklists, clearance workflows, final pay
Training & Certification: Programs, enrollment, expiry tracking, compliance training
Performance: Review cycles, self/manager reviews, KPI & goal tracking
Disciplinary: Incident logging, actions, appeals, resolution
Grievance: Filing, investigation, resolution, withdrawal
Policies: Creation, versioning, employee acknowledgment tracking
Expenses: Claims, approvals, reimbursement tracking

AI & Intelligence

9 Specialized AI Agents with tool access to live company data
Org Intelligence: Flight risk detection, burnout risk, team health metrics, blind spot analysis
Dashboard AI: Briefings, form auto-fill, compliance alerts, manager suggestions
Workflow Automation: Rules engine, SLA tracking, autonomous decision agent

中文说明

HalaOS 是一款面向东南亚的 AI 驱动人力资源操作系统。支持员工管理、考勤、请假、薪资、税务合规、福利、贷款、培训、绩效等全模块 HR 功能，内置 9 个专业 AI 代理，精通当地劳动法。

两种模式：

原生模式（默认）：直接通过 OpenClaw 提问 HR 问题、计算政府缴费、生成合规文件，零注册即用
云平台模式（完整功能）：连接 HalaOS 账号，使用完整薪资处理、考勤追踪、AI 组织洞察等功能

核心功能：

全自动薪资计算（含菲律宾 SSS/PhilHealth/Pag-IBIG/BIR 税表）
GPS 地理围栏考勤、弹性排班、DTR 报表
假期管理（余额、审批、结转、兑现）
9 个 AI 代理（薪资专家、合规官、考勤经理、请假顾问等）
组织智能（离职风险、倦怠风险、团队健康、盲点分析）
201 档案管理、培训认证、绩效 KPI、纪律处分、申诉流程

OpenClaw Native Mode

First Run — Configuration

On first use, ask the user about their company context:

Country/Jurisdiction: Which country's labor law to apply?
- PH (Philippines) — default, most comprehensive
- SG (Singapore)
- LK (Sri Lanka)
Company Size: Affects compliance requirements
- Small (1-50), Medium (51-200), Large (200+)
Storage: Where to save HR data locally
- Notion, Google Sheets, Obsidian, Local files

Store in ~/.openclaw/skills/halaos-hr/config.json:

json

{
  "jurisdiction": "PH",
  "company_size": "medium",
  "storage": "notion",
  "currency": "PHP",
  "timezone": "Asia/Manila"
}

HR Knowledge Base

In native mode, answer HR questions using built-in knowledge of Southeast Asian labor law:

Philippine Labor Law:

Minimum wage by region (NCR, CALABARZON, etc.)
Mandatory benefits: SSS, PhilHealth, Pag-IBIG, 13th month pay
Leave entitlements: SIL (5 days), maternity (105 days), paternity (7 days), solo parent (7 days), VAWC (10 days), special leave for women (60 days)
TRAIN Law withholding tax brackets
DOLE compliance requirements
Regular/special holiday pay rules

Singapore Employment Act:

CPF contribution rates by age bracket
Annual leave entitlement (7-14 days by tenure)
Sick leave (14 days outpatient + 60 days hospitalization)
Public holiday entitlements
IRAS filing requirements

Sri Lanka Labor Law:

EPF (employee 8% + employer 12%) and ETF (employer 3%)
Annual leave (14 days), casual leave (7 days), sick leave (7 days)
Gratuity calculation (half month per year after 5 years)

Government Contribution Calculator

When asked to calculate contributions, use these formulas:

SSS (Philippines 2024):

Employee: 4.5% of monthly salary credit
Employer: 9.5% of monthly salary credit
Monthly salary credit range: PHP 4,000 - PHP 30,000

PhilHealth (Philippines 2024):

Rate: 5% of basic salary (split 50/50 employee/employer)
Floor: PHP 10,000; Ceiling: PHP 100,000

Pag-IBIG (Philippines):

Employee: 1% if salary <= PHP 1,500; 2% if > PHP 1,500
Employer: 2% of basic salary
Ceiling: PHP 10,000 (for contributions over PHP 5,000 max PHP 200)

BIR Withholding Tax (TRAIN Law):

Annual Taxable Income	Tax
<= PHP 250,000	0%
250,001 - 400,000	15% of excess over 250,000
400,001 - 800,000	22,500 + 20% of excess over 400,000
800,001 - 2,000,000	102,500 + 25% of excess over 800,000
2,000,001 - 8,000,000	402,500 + 30% of excess over 2,000,000
> 8,000,000	2,202,500 + 35% of excess over 8,000,000

Document Generation

Generate common HR documents in native mode:

Certificate of Employment (COE): Employee name, position, dates, salary (optional)
Employment Contract: Based on jurisdiction template
Memorandum / Notice: Warning, suspension, termination
Leave Summary: Balance report per employee
Payslip: Basic computation with deductions breakdown

Employee Data Management

When the user manages employees locally:

text

> Add employee Maria Santos, position: Accountant, department: Finance, salary: 35000 PHP
> List all employees
> Show Maria's leave balance
> Calculate Maria's net pay for January
> Generate DTR report for Finance department, March 2026

Employee record format:

json

{
  "name": "Maria Santos",
  "position": "Accountant",
  "department": "Finance",
  "salary": 35000,
  "currency": "PHP",
  "hire_date": "2024-06-15",
  "status": "active",
  "jurisdiction": "PH"
}

AI Agents Reference

When connected to the cloud platform, 9 specialized AI agents are available. Each has tools that access live company data.

ID	Agent	Specialty	Tools
1	General HR Assistant	All-purpose HR questions	9 tools (employee, leave, attendance, payroll, policy, compliance, knowledge base)
2	Payroll Specialist	Payroll, tax, deductions, 13th month, final pay	Payroll analysis, salary simulation, contribution tables
3	Attendance Manager	Clock in/out, DTR, schedules, geofencing	Attendance records, patterns, schedule data
4	Compliance Officer	Labor law, DOLE, BIR, government filings	Compliance checking, policy lookup, filing deadlines
5	Leave Advisor	Balances, entitlements, carryover, encashment	Leave balances, request history, calendar
6	Onboarding Guide	New hire setup, 201 file, policies	Onboarding tasks, document requirements
7	Performance Reviewer	KPIs, goals, review cycles	Performance data, goal tracking
8	Training Advisor	Skills gaps, certifications, compliance training	Training records, certification expiry
9	Workflow Decision Agent	Autonomous approval recommendations	Approval context, workflow rules, confidence scoring

Using Agents in Native Mode

In native mode (no API key), the skill itself acts as a general HR assistant using built-in knowledge. Agent-specific expertise is simulated:

text

> Ask the compliance officer: what BIR forms do I need to file this month?
> Ask the payroll specialist: calculate overtime pay for 8 hours on a regular holiday
> Ask the leave advisor: can an employee carry over unused SIL to next year?

Using Agents in Cloud Mode

With HALAOS_API_KEY set, queries are routed to specialized agents with access to your actual company data:

text

> How many employees are at risk of burnout?
> Generate this month's payroll for all employees
> Who has expiring certifications in the next 30 days?
> What's the leave utilization rate by department?

Cloud Platform Setup

For the full HR platform with payroll processing, attendance, AI agents, and compliance automation:

Visit your HalaOS instance (provided by your admin)
Log in or register with magic link
Go to Settings > API Keys > Create New Key
Set HALAOS_API_KEY in your OpenClaw config

Cloud API Endpoints

All API calls require: Authorization: Bearer <HALAOS_API_KEY>

Base URL: HALAOS_URL env var, or your HalaOS instance URL.

Dashboard & Intelligence:

text

GET  {baseUrl}/api/v1/dashboard/stats              — Company overview stats
GET  {baseUrl}/api/v1/dashboard/action-items        — Pending approvals & tasks
GET  {baseUrl}/api/v1/dashboard/flight-risk          — Employee attrition risk
GET  {baseUrl}/api/v1/dashboard/burnout-risk         — Burnout detection
GET  {baseUrl}/api/v1/dashboard/team-health          — Team health metrics
GET  {baseUrl}/api/v1/dashboard/compliance-alerts    — Compliance warnings
GET  {baseUrl}/api/v1/ai/briefing                    — AI-generated daily briefing

Employees:

text

GET  {baseUrl}/api/v1/employees                     — List employees
GET  {baseUrl}/api/v1/employees/:id                 — Get employee details
GET  {baseUrl}/api/v1/directory                     — Employee directory
GET  {baseUrl}/api/v1/directory/org-chart            — Organization chart

Attendance:

text

POST {baseUrl}/api/v1/attendance/clock-in           — Clock in
POST {baseUrl}/api/v1/attendance/clock-out           — Clock out
GET  {baseUrl}/api/v1/attendance/records             — Attendance records
GET  {baseUrl}/api/v1/attendance/summary             — Attendance summary
GET  {baseUrl}/api/v1/attendance/report              — DTR report

Leave:

text

GET  {baseUrl}/api/v1/leaves/balances               — My leave balances
POST {baseUrl}/api/v1/leaves/requests               — Submit leave request
GET  {baseUrl}/api/v1/leaves/requests               — List leave requests
GET  {baseUrl}/api/v1/leaves/calendar               — Leave calendar

Payroll:

text

GET  {baseUrl}/api/v1/payroll/cycles                — List payroll cycles
POST {baseUrl}/api/v1/payroll/runs                  — Run payroll
GET  {baseUrl}/api/v1/payroll/payslips              — List payslips
GET  {baseUrl}/api/v1/payroll/payslips/:id/pdf      — Download payslip PDF
POST {baseUrl}/api/v1/payroll/13th-month/calculate  — Calculate 13th month pay

Compliance:

text

GET  {baseUrl}/api/v1/compliance/sss-table          — SSS contribution table
GET  {baseUrl}/api/v1/compliance/philhealth-table   — PhilHealth table
GET  {baseUrl}/api/v1/compliance/pagibig-table      — Pag-IBIG table
GET  {baseUrl}/api/v1/compliance/bir-tax-table      — BIR tax table
POST {baseUrl}/api/v1/compliance/government-forms/generate — Generate BIR forms
GET  {baseUrl}/api/v1/tax-filings/upcoming          — Upcoming filing deadlines

Approvals:

text

GET  {baseUrl}/api/v1/approvals/pending             — Pending approvals
POST {baseUrl}/api/v1/approvals/:id/approve         — Approve request
POST {baseUrl}/api/v1/approvals/:id/reject          — Reject request

Analytics:

text

GET  {baseUrl}/api/v1/analytics/summary             — HR analytics summary
GET  {baseUrl}/api/v1/analytics/headcount-trend     — Headcount over time
GET  {baseUrl}/api/v1/analytics/turnover            — Turnover statistics
GET  {baseUrl}/api/v1/analytics/department-costs    — Department cost analysis
GET  {baseUrl}/api/v1/analytics/attendance-patterns — Attendance patterns
GET  {baseUrl}/api/v1/analytics/leave-utilization   — Leave utilization
GET  {baseUrl}/api/v1/analytics/blind-spots         — Manager blind spots

AI Chat:

text

POST {baseUrl}/api/v1/ai/chat                       — Chat with AI agent
GET  {baseUrl}/api/v1/ai/agents                     — List available agents
GET  {baseUrl}/api/v1/ai/sessions                   — List chat sessions

When HALAOS_API_KEY is set, prefer using cloud API endpoints for all queries. When not set, use built-in knowledge and local data.

Response Formatting

Present payroll computations in a clear table with gross, deductions (itemized), and net pay
Show government contributions as a breakdown: employee share vs employer share
Display leave balances as a summary table: type, total, used, remaining
For compliance questions, always cite the specific law or regulation
Show attendance summaries with present/absent/late counts
For analytics, present trends with direction indicators (up/down/stable)

Openclaw Skill

Install

HalaOS — AI-Powered HR Operating System

How It Works

Mode 1: OpenClaw Native (Default — No Registration Needed)

Mode 2: Cloud Platform (Full Features — Requires Registration)

What It Does

Core HR

Compliance & Tax (Southeast Asia)

Workforce Operations

AI & Intelligence

中文说明

OpenClaw Native Mode

First Run — Configuration

HR Knowledge Base

Government Contribution Calculator

Document Generation

Employee Data Management

AI Agents Reference

Using Agents in Native Mode

Using Agents in Cloud Mode

Cloud Platform Setup

Cloud API Endpoints

Response Formatting

Links