# Send Invoice Collector to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "invoice-collector",
    "name": "Invoice Collector",
    "source": "tencent",
    "type": "skill",
    "category": "效率提升",
    "sourceUrl": "https://clawhub.ai/mintannn/invoice-collector",
    "canonicalUrl": "https://clawhub.ai/mintannn/invoice-collector",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/invoice-collector",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=invoice-collector",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "SKILL.md",
      "scripts/collect_invoices.sh"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-23T16:43:11.935Z",
      "expiresAt": "2026-04-30T16:43:11.935Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=4claw-imageboard",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=4claw-imageboard",
        "contentDisposition": "attachment; filename=\"4claw-imageboard-1.0.1.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/invoice-collector"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/invoice-collector",
    "downloadUrl": "https://openagent3.xyz/downloads/invoice-collector",
    "agentUrl": "https://openagent3.xyz/skills/invoice-collector/agent",
    "manifestUrl": "https://openagent3.xyz/skills/invoice-collector/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/invoice-collector/agent.md"
  }
}
```
## Documentation

### Invoice Collector

Collect invoices from Gmail and send them as a summary email with all attachments.

### Puppeteer --no-sandbox Flag

This skill uses --no-sandbox when launching Puppeteer/Chromium. This is required in many environments:

WSL (Windows Subsystem for Linux): Chrome sandbox requires kernel features not available in WSL1/WSL2
Docker containers: Unless running with --privileged or specific seccomp profiles
CI/CD environments: Most runners don't support Chrome's sandbox

Risk: Disabling the sandbox means if a malicious HTML email were rendered, it could potentially execute code outside the browser context.

Mitigation: This skill only renders emails from your own Gmail inbox. The risk is limited to emails you've already received. If you're concerned, review emails before processing or run in an isolated environment.

### Installation via curl | tar

The gogcli installation example uses curl -sL ... | tar xz, which is a common pattern but carries supply chain risks if the source were compromised.

Safer alternative (verify checksum):

# Download and verify
curl -sLO https://github.com/steipete/gogcli/releases/latest/download/gogcli_linux_amd64.tar.gz
curl -sLO https://github.com/steipete/gogcli/releases/latest/download/checksums.txt
sha256sum -c checksums.txt --ignore-missing
tar xzf gogcli_linux_amd64.tar.gz
mv gog ~/.local/bin/

macOS users: Use brew install steipete/tap/gogcli which handles verification automatically.

### 1. Install gogcli

# Linux (download binary)
curl -sL https://github.com/steipete/gogcli/releases/latest/download/gogcli_linux_amd64.tar.gz | tar xz
mv gog ~/.local/bin/

# macOS
brew install steipete/tap/gogcli

### 2. Setup Google OAuth

Go to Google Cloud Console
Create project → Enable Gmail API
Create OAuth credentials (Desktop app)
Download JSON

gog auth credentials ~/path/to/client_secret.json
gog auth add your@gmail.com

### 3. Install Puppeteer (for email screenshots)

cd /tmp && npm install puppeteer

### 4. Install Japanese fonts (optional, for JP emails)

sudo apt install fonts-noto-cjk

### Generic Invoice Search

Search for any invoice/receipt without specifying specific senders:

export GOG_ACCOUNT="user@gmail.com"
export GOG_KEYRING_PASSWORD="your-password"

# Search all invoices in date range
gog gmail search '(invoice OR receipt OR 請求書 OR 領収書 OR billing OR payment) after:2026/01/01 before:2026/02/01'

# Search with specific criteria
gog gmail search 'subject:(invoice OR receipt) has:attachment after:2026/01/01'

### Workflow

Search - Find invoice emails
Download - Get PDFs or screenshot emails
Summarize - Create summary with amounts
Send - Email to destination with attachments

### Step 1: Search Invoices

# All invoices from last month
LAST_MONTH=$(date -d "1 month ago" +%Y/%m/01)
THIS_MONTH=$(date +%Y/%m/01)
gog gmail search "(invoice OR receipt OR 請求書 OR 領収書) after:$LAST_MONTH before:$THIS_MONTH" --json

### Step 2: Process Each Email

mkdir -p /tmp/invoices

For emails WITH PDF attachments:

# Get message details
MSG_ID="<message_id_here>"
EMAIL_JSON=$(gog gmail read $MSG_ID --json)

# Find PDF attachment
ATTACH_INFO=$(echo "$EMAIL_JSON" | jq -r '.thread.messages[0].payload.parts[]? | select(.filename | test("\\\\.pdf$"; "i")) | "\\(.body.attachmentId)|\\(.filename)"' | head -1)
ATTACH_ID=$(echo "$ATTACH_INFO" | cut -d'|' -f1)
FILENAME=$(echo "$ATTACH_INFO" | cut -d'|' -f2)

# Download
gog gmail attachment $MSG_ID "$ATTACH_ID" --out "/tmp/invoices/$FILENAME"

For emails WITHOUT PDF (take screenshot):

MSG_ID="<message_id_here>"

# Extract HTML
gog gmail read $MSG_ID --json | node -e "
const fs = require('fs');
let data = '';
process.stdin.on('data', chunk => data += chunk);
process.stdin.on('end', () => {
  const json = JSON.parse(data);
  const msg = json.thread.messages[0];
  let html = '';
  const findHtml = (p) => {
    if (p.mimeType === 'text/html' && p.body?.data) {
      html = Buffer.from(p.body.data, 'base64').toString('utf-8');
    }
    if (p.parts) p.parts.forEach(findHtml);
  };
  (msg.payload.parts || []).forEach(findHtml);
  if (!html && msg.payload.body?.data) {
    html = Buffer.from(msg.payload.body.data, 'base64').toString('utf-8');
  }
  fs.writeFileSync('/tmp/invoices/email.html', html || '<html><body>No content</body></html>');
});
"

# Screenshot
node -e "
const puppeteer = require('puppeteer');
const fs = require('fs');
(async () => {
  const browser = await puppeteer.launch({ headless: 'new', args: ['--no-sandbox'] });
  const page = await browser.newPage();
  await page.setViewport({ width: 800, height: 1200 });
  await page.setContent(fs.readFileSync('/tmp/invoices/email.html', 'utf-8'), { waitUntil: 'networkidle0' });
  await page.screenshot({ path: '/tmp/invoices/receipt.png', fullPage: true });
  await browser.close();
})();
"

### Step 3: Extract Invoice Info

Parse email for sender, date, amount:

# Get basic info from email
gog gmail read $MSG_ID --json | jq '{
  from: .thread.messages[0].payload.headers[] | select(.name=="From") | .value,
  subject: .thread.messages[0].payload.headers[] | select(.name=="Subject") | .value,
  date: .thread.messages[0].payload.headers[] | select(.name=="Date") | .value
}'

### Step 4: Send Summary Email

gog gmail send \\
  --to "recipient@example.com" \\
  --subject "【$(date +%Y年%m月)】請求書まとめ" \\
  --body "請求書・領収書を添付します。

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
📊 請求書まとめ
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

【添付ファイル】
1. Invoice-001.pdf - Service A
2. Receipt.png - Service B (メールスクショ)

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

このメールは自動生成されました。
" \\
  --attach /tmp/invoices/Invoice-001.pdf \\
  --attach /tmp/invoices/Receipt.png

### Example Prompts

Generic:

"先月の請求書を全部集めてまとめて送って"
"invoiceで検索して今月届いた請求書をkeiri@company.comに転送して"
"has:attachment receipt で検索して請求書集めて"

Specific:

"AnthropicとVercelとAWSの請求書を集めて"
"from:stripe の請求書を過去3ヶ月分まとめて"

### Tips

Date format: YYYY/MM/DD for gog search
PDF priority: Always prefer PDF attachments over screenshots
Japanese fonts: Required for correct rendering of JP emails
Cleanup: rm -rf /tmp/invoices after sending
Cron: Set up monthly cron job for recurring collection
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: mintannn
- Version: 1.2.0
## Source health
- Status: healthy
- Source download looks usable.
- Yavira can redirect you to the upstream package for this source.
- Health scope: source
- Reason: direct_download_ok
- Checked at: 2026-04-23T16:43:11.935Z
- Expires at: 2026-04-30T16:43:11.935Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/invoice-collector)
- [Send to Agent page](https://openagent3.xyz/skills/invoice-collector/agent)
- [JSON manifest](https://openagent3.xyz/skills/invoice-collector/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/invoice-collector/agent.md)
- [Download page](https://openagent3.xyz/downloads/invoice-collector)