Openclaw Greek Accounting Meta

Orchestrator for the full OpenClaw Greek Accounting system. Routes commands across 18 specialist skills. Primary entry point for accounting firms.

# OpenClaw Greek Accounting Meta-Skill

This meta-skill is the primary entry point for the entire OpenClaw Greek Accounting system. It orchestrates all 18 specialised skills through simple business commands, managing data flow, sequencing, error recovery, and human confirmation gates for government submissions.


## Setup

```bash
export OPENCLAW_DATA_DIR="/data"
which jq || sudo apt install jq

# Install companion skills (this orchestrator needs them to be useful)
# See the full skill list at: https://github.com/satoshistackalotto/openclaw-greek-accounting
```

This is the orchestrator skill — it coordinates all other Greek accounting skills. Install companion skills for actual functionality. This skill alone only routes commands.


## Core Philosophy

- **Single Entry Point**: One meta-skill controls the entire system — accountants and assistants never need to address individual skills directly
- **Business-Focused Commands**: Simple commands that match real accounting workflows
- **Skill Orchestration**: Automatically manages interactions between all 18 specialised skills
- **Human Confirmation Gate**: Any action submitting to a government system (AADE, EFKA, myDATA) requires explicit human confirmation before proceeding
- **Error Recovery**: Handles failures gracefully with fallback strategies
- **Progress Reporting**: Clear visibility into complex multi-step processes
- **Greek Business Standards**: Professional output matching Greek accounting practices

## Meta-Skill Architecture

### Managed Skills — Full Registry
```yaml
Required_Skills:

  phase_1_core:
    - accounting-workflows        # Document processing, invoice extraction, reconciliation
    - greek-compliance-aade       # VAT returns, payroll, myDATA, TAXIS XML
    - cli-deadline-monitor        # AADE/EFKA/municipal deadline tracking
    - greek-email-processor       # Greek email classification, attachment extraction
    - greek-individual-taxes      # E1 forms, individual tax returns, deduction optimisation

  phase_2_advanced:
    - aade-api-monitor            # Real-time AADE monitoring, regulatory change detection
    - greek-banking-integration   # Bank statement import, transaction categorisation
    - greek-document-ocr          # Greek language OCR, structured data extraction
    - efka-api-integration        # Social security contributions, EFKA declarations

  phase_3a_infrastructure:
    - dashboard-greek-accounting  # Business intelligence, compliance monitoring, alerts (English UI)
    - client-data-management      # Client master records, compliance history, GDPR (sole writer to /data/clients/)
    - user-authentication-system  # Role-based access, per-client permissions, audit logs
    - conversational-ai-assistant # Natural language interface for assistants (English queries, Greek data)

  phase_3b_professional_outputs:
    - greek-financial-statements  # P&L, balance sheet, cash flow, VAT summary — EGLS-compliant Greek format
    - client-communication-engine # Outgoing Greek correspondence — confirmations, summaries, requests, reminders
    - system-integrity-and-backup # Encrypted backups, integrity checks, retention enforcement, schema migrations
    - analytics-and-advisory      # Proactive risk scoring, trend analysis, anomaly detection, morning advisory

  openclaw_dependencies:
    - deepread                    # OCR and text extraction
    - pdf-tools                   # PDF manipulation
    - file-processor              # File organisation and batch processing
    - doc-converter               # Document format conversion

Installation_Command:
  setup: "npx openclaw skills add openclaw-greek-accounting-meta --install-deps"
  verification: "openclaw greek health-check --verify-all-skills"
```

## Business-Focused Commands

### 1. Monthly Accounting Workflows

#### Complete Monthly Processing
```bash
# Single command for full monthly accounting cycle
openclaw greek monthly-process --afm EL123456789 --month 2026-02

# What it orchestrates internally:
# 1. openclaw auth check-access --client EL123456789 --action compliance_management
# 2. openclaw deadline check aade --client EL123456789  (confirm deadlines and due dates)
# 3. openclaw email scan-folder /data/incoming/ --classify-new  (classify any new documents)
# 4. openclaw ocr process-greek --input-dir /data/ocr/incoming/  (OCR new documents)
# 5. openclaw accounting batch-process --input-dir /data/ocr/output/accounting-ready/
# 6. openclaw banking reconcile --afm EL123456789 --period 2026-02
# 7. openclaw compliance vat-return --client EL123456789 --period 2026-02 --prepare
# 8. openclaw efka contribution-calc --afm EL123456789 --period 2026-02
# ⚠️  HUMAN CONFIRMATION REQUIRED — displays full filing details before proceeding
# 9. openclaw compliance vat-return --client EL123456789 --period 2026-02 --submit
# 10. openclaw efka submit-declaration --afm EL123456789 --period 2026-02
# 11. openclaw clients log-filing --afm EL123456789 --type VAT-monthly --period 2026-02 --status submitted
# 12. openclaw clients log-filing --afm EL123456789 --type EFKA-monthly --period 2026-02 --status submitted
# 13. openclaw dashboard refresh --client EL123456789
```

#### Quick Status Check
```bash
# Rapid overview of current status
openclaw greek status-check --include-urgent

# Output example:
# ✅ All government systems operational (AADE, EFKA, myDATA)
# ⚠️  3 VAT returns due in 7 days
# 🚨 1 AADE notification requires attention
# 📊 15 documents in OCR queue, 3 awaiting review
```

### 2. Client Management Workflows

#### New Client Onboarding
```bash
# Complete new client setup — requires accountant role or above
openclaw greek client-onboarding --afm EL123456789 --name "NEW CLIENT AE" --legal-form AE --sector retail

# Orchestrates:
# 1. openclaw auth check-access --action create_client  (permission gate)
# 2. openclaw clients add --afm EL123456789 --name "NEW CLIENT AE" --legal-form AE --sector retail
# 3. openclaw clients obligations --afm EL123456789  (generate obligation schedule)
# 4. openclaw deadline check aade  (pull relevant upcoming deadlines)
# 5. openclaw dashboard sync-clients --rebuild  (update portfolio view)
```

#### Client Document Processing
```bash
# Process all new documents for a specific client
openclaw greek client-process --afm EL123456789 --period current-month

# Orchestrates:
# 1. openclaw auth check-access --client EL123456789 --action process_documents
# 2. openclaw ocr process-greek --input-dir /data/ocr/incoming/  (OCR any new scans)
# 3. openclaw accounting batch-process --input-dir /data/ocr/output/accounting-ready/ --greek-format
# 4. openclaw clients doc-register --afm EL123456789  (register each document)
# 5. openclaw dashboard document-queue --count  (refresh queue status)
```

### 3. Compliance & Tax Workflows

#### Tax Season Preparation
```bash
# Prepare all individual tax returns
openclaw greek tax-season-prep --year 2025 --deadline-check

# Orchestrates:
# 1. Collect all individual client data
# 2. Optimize deductions for each client
# 3. Prepare E1 forms with TAXIS formatting
# 4. Generate document checklists
# 5. Schedule submission reminders
```

#### Emergency Compliance Response
```bash
# Handle urgent compliance issues
openclaw greek emergency-compliance --type audit --entity "DEMO AE"

# Responds to:
# 1. AADE audit notifications (immediate alert)
# 2. Deadline changes (update all affected clients)
# 3. System outages (switch to manual processing)
# 4. Missing documents (generate urgent requests)
```

### 4. Government Integration Workflows

#### AADE Integration Suite
```bash
# Complete AADE interaction management
openclaw greek aade-sync --check-updates --submit-pending

# Coordinates:
# 1. Check for new AADE announcements
# 2. Update deadline trackers
# 3. Submit pending VAT returns
# 4. Verify myDATA submissions
# 5. Download compliance certificates
```

#### Multi-Municipality Management
```bash
# Handle clients across different municipalities
openclaw greek mun