Jobs Hunter Claw 🎯

Unified skill for job hunting automation: Discover → Apply → Track.

ClawHub: https://clawhub.ai/QuantDeveloperUSA/jobs-hunter-claw
GitHub: https://github.com/ABFS-Inc/jobs-hunter-claw

Installation

Option 1: ClawHub (Recommended)

CODEBLOCK0

Option 2: Git Clone

CODEBLOCK1

Prerequisites

1. gog CLI (Google Workspace)

The skill uses gog for Google Sheets access:

CODEBLOCK2

2. Google Sheet Setup

Create a Google Sheet with these tabs:

See references/google-sheet-setup.md for detailed setup.

3. Configure Spreadsheet ID (Required)

Set the environment variable with your Google Sheet ID:

CODEBLOCK3

The ID is found in your Google Sheet URL:
CODEBLOCK4

For persistent configuration, add to your shell profile (~/.bashrc, ~/.zshrc):

CODEBLOCK5

For OpenClaw agents, set in the agent's environment or TOOLS.md.

Quick Start

CODEBLOCK6

Agent Setup

Create a dedicated agent to run job hunting automation.

Model Requirement

This skill requires google/gemini-flash-latest for optimal performance and cost efficiency.

Gemini Flash provides:

• - Fast response times for frequent job board scanning
• Cost-effective for high-volume cron jobs (hourly scans, daily reviews)
• Sufficient capability for structured data operations (CRUD, search, logging)
• Good tool-use performance for shell command execution

Do not use Opus, Sonnet, or other premium models — they're overkill for this skill and will incur unnecessary costs.

1. Create the Agent

CODEBLOCK7

2. Configure Agent Identity

Create IDENTITY.md in the agent workspace:

CODEBLOCK8

3. Configure Agent Tools

Create TOOLS.md in the agent workspace with the spreadsheet ID:

CODEBLOCK9bash

Set spreadsheet ID

Run commands

4. Configure Heartbeat (Optional)

Create HEARTBEAT.md for periodic checks:

CODEBLOCK11

Cron Job Setup

Automate job hunting tasks with OpenClaw cron jobs.

Important: Cron jobs need the spreadsheet ID in the task prompt or agent environment.

Job 1: Email Scan (Hourly, Business Hours)

CODEBLOCK12

Schedule: Every hour from 9 AM - 6 PM EST (14-23 UTC), Monday-Friday.

Job 2: Weekly Pipeline Review (Monday Morning)

CODEBLOCK13

Schedule: Monday 9 AM EST (14:00 UTC).

Managing Cron Jobs

CODEBLOCK14

CLI Reference

Commands

Adding a Job

CODEBLOCK15

Required: --company, INLINECODE19

Updating a Job

CODEBLOCK16

Logging Activity

CODEBLOCK17

Deleting a Job

CODEBLOCK18

Note: Delete clears the row data but preserves the activity log history.

Searching Jobs

CODEBLOCK19

Filtering Jobs

CODEBLOCK20

Validation Rules

Status Values (Title Case)

The CLI auto-normalizes status to Title Case (interview → Interview).

Event Types (lowercase)

Contact Validation

Contacts must be Google Contacts links:
CODEBLOCK21

Bypass with --no-strict-contacts flag.

Google Apps Script (Optional)

For manual job entry via the Google Sheet form tab, install the Apps Script:

1. 1. Open your Google Sheet
2. Go to Extensions → Apps Script
3. Delete existing code in INLINECODE46
4. Paste contents of INLINECODE47
5. Click Save
6. Refresh the Google Sheet
7. Use the new 🎯 Job Tracker menu

Menu Functions

• - ➕ Add Job — Creates job from form fields
• 📥 Load Job to Edit — Loads existing job into form
• 💾 Save Changes — Saves form changes back
• 📝 Add Log Entry — Adds activity log
• 🧹 Clear Form — Clears form fields
• 🔄 Refresh Next ID — Updates ID counter
• ⚙️ Setup Data Validation — Adds dropdowns (run once)

Files

CODEBLOCK22

Troubleshooting

"JOBTRACKERSPREADSHEET_ID environment variable is required"

Set the environment variable:
CODEBLOCK23

"gog: command not found"

Install gog CLI:
CODEBLOCK24

"Google API error (403)"

Authenticate gog with Sheets access:
CODEBLOCK25

"Permission denied" when running job-tracker.sh

Fix executable permission:
CODEBLOCK26

Cron jobs not delivering to Discord

Use the full channel format: channel:CHANNEL_ID (not just discord).

Version History

• - 1.4.0 — Specified google/gemini-flash-latest as required model for cost efficiency
• 1.3.0 — Added delete command for removing jobs; uses gog sheets clear for proper row clearing
• 1.2.0 — Removed hardcoded spreadsheet ID, now requires JOB_TRACKER_SPREADSHEET_ID env var
• 1.1.0 — Added agent setup and cron job documentation
• 1.0.2 — File extensions fixed for ClawHub compatibility
• 1.0.0 — Initial release