workspace-invoice

Invoice QR code agent workspace. Decodes a QR code image, navigates to the invoice URL, fills a fixed Chinese corporate invoice form with predefined billing details, and submits the application.

Included Assets

Configuration

• AGENTS.md — Invoice worker rules and browser profile constraints
• IDENTITY.md, USER.md, BOOTSTRAP.md, HEARTBEAT.md — OpenClaw agent metadata
• TOOLS.md — Tool routing reference

Skill

• skills/submit-invoice-from-qr/SKILL.md — Workflow definition for QR decode → form fill → submit
• skills/submit-invoice-from-qr/references/invoice-profile.md — Company billing details and field label mappings
• skills/submit-invoice-from-qr/scripts/decode_qr.sh — QR code decoder script (requires zbarimg)

Scripts

• scripts/invoice_session_lib.mjs — Shared session/job utilities (decode, session store, logging paths)
• scripts/run_invoice_job.mjs — Unattended invoice job runner (Node.js)
• scripts/run_invoice_job.sh — Shell wrapper for the job runner
• scripts/cleanup_invoice_session.mjs — Session cleanup utility

How to Use

1. Prerequisites

• Install zbar (provides zbarimg):

  brew install zbar
  

• OpenClaw must be configured with the isolated openclaw browser profile.

2. Submit an Invoice from a QR Image

Submit a QR code image (attachment or local path) to the agent and request invoice submission. The agent will:

1. Decode the QR code using zbarimg.
2. Open the extracted URL in the isolated openclaw browser profile.
3. Match and fill form fields using the predefined company profile.
4. Submit the application and verify the result page.

3. Run Unattended Jobs

For batch or background processing:

./scripts/run_invoice_job.sh --image /path/to/qr.png [--job-id invoice-batch-001] [--verbose]

4. Clean Up Sessions

node scripts/cleanup_invoice_session.mjs --job-id invoice-batch-001

Notes

• This workspace is scoped to invoice QR tasks only. It uses the isolated openclaw browser profile and does not interact with the user's active browsing session.
• Text entry in browser fields uses `type