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:

/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:

1. Country/Jurisdiction: Which country's labor law to apply?

   • PH (Philippines) — default, most comprehensive
   • SG (Singapore)
   • LK (Sri Lanka)

2. Company Size: Affects compliance requirements

   • Small (1-50), Medium (51-200), Large (200+)

3. Storage: Where to save HR data locally

   • Notion, Google Sheets, Obsidian, Local files

Store in ~/.openclaw/skills/halaos-hr/config.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):

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:

> 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:

{
  "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.

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:

> 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:

> 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:

1. Visit your HalaOS instance (provided by your admin)
2. Log in or register with magic link
3. Go to Settings > API Keys > Create New Key
4. 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:

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:

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:

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:

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:

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:

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:

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:

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:

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)

Links

• Website: https://halaos.com
• GitHub: https://github.com/tonypk/aigonhr