OpenClaw Jobs API docs

How it works

clawhub install remote-jobs-finder

# 1) Create the OpenClaw global extensions dir
mkdir -p ~/.openclaw/extensions

# 2) Copy the two extension files into place
# (replace /path/to/bundle with where you unzipped the "everything" bundle)
cp /path/to/bundle/SERVER_EXTENSION_openclaw_extensions_root/openclaw.plugin.json ~/.openclaw/extensions/openclaw.plugin.json
cp /path/to/bundle/SERVER_EXTENSION_openclaw_extensions_root/index.ts ~/.openclaw/extensions/index.ts

# 3) Quick sanity check
ls -la ~/.openclaw/extensions
sed -n '1,40p' ~/.openclaw/extensions/index.ts

# Show current plugin entries
jq '.plugins.entries' ~/.openclaw/openclaw.json

# Edit the config
nano ~/.openclaw/openclaw.json

# Ensure it contains (merge into plugins.entries):
# "plugins": { "entries": { "index": { "enabled": true }, "whatsapp": { "enabled": true } } }

# 1) Create a systemd override for the gateway service
sudo systemctl edit openclaw-gateway.service

# 2) Paste this, replacing YOUR_KEY_HERE:
# [Service]
# Environment="RR_API_KEY=YOUR_KEY_HERE"

# 3) Reload + restart
sudo systemctl daemon-reload
sudo systemctl restart openclaw-gateway.service

# 4) Verify the env var is actually present
sudo systemctl show openclaw-gateway.service --property=Environment | tr ' ' '\n' | grep RR_API_KEY || echo "RR_API_KEY not set"

openclaw gateway restart

openclaw agent --to <your_number> --message "What tools do you currently have available? List their names exactly." --json --verbose on

I'm looking for a remote job
Send me 20 more
Only senior roles
Only contract roles

FAQ

Example request body

{
  "filters": {
    "language": "en",
    "jobTitleFilters": ["Software Engineer"],
    "locationFilters": ["United States"],
    "locationUSStatesFilters": ["California"],
    "locationCityFilters": ["San Francisco"],
    "seniorityFilters": ["senior"],
    "employmentTypeFilters": ["full-time"],
    "companySizeFilters": ["51,200"],
    "requiredLanguagesFilters": ["en"],
    "excludeRequiredLanguagesFilters": ["fr"],
    "techStackFilters": ["TypeScript", "React"],
    "industriesFilters": ["SaaS"],
    "excludeIndustriesFilters": ["Crypto"],
    "visaFilter": "h1b",
    "degreeRequiredFilter": "true",
    "minSalaryFilter": 120000,
    "showJobsWithoutSalaryWithMinSalaryFilter": true,
    "showHybridJobs": false,
    "showOnsiteJobs": false,
    "showRemoteJobs": true,
    "keywordFilters": ["payments"],
    "excludedKeywordFilters": ["intern"],
    "companyIdFilter": null,
    "page": 1,
    "itemsPerPage": 20,
    "sortBy": "DateAdded"
  },
  "includeJobDescription": false
}

Example success response (200)

{
  "jobOpenings": [
    {
      "id": 123456,
      "validUntilDate": "2026-03-31",
      "employmentType": "full-time",
      "created_at": "2026-02-14T12:34:56.000Z",
      "roleTitle": "Senior Software Engineer",
      "roleDescription": "Full description...",
      "roleRequirements": "Requirements...",
      "benefits": "Benefits...",
      "jobDescriptionSummary": "Summary...",
      "twoLineJobDescriptionSummary": "Two-line summary...",
      "threeLineJobDescriptionSummary": "Three-line summary...",
      "url": "https://company.com/jobs/123",
      "isEntryLevel": false,
      "isJunior": false,
      "isMidLevel": false,
      "isSenior": true,
      "isLead": false,
      "salaryRange": "$120k-$150k",
      "techStack": ["TypeScript", "React"],
      "companyMostRecentFundingDate": "2025-09-10",
      "slug": "senior-software-engineer",
      "isPromoted": false,
      "educationRequirementsCredentialCategory": "Bachelor",
      "experienceRequirementsMonthsOfExperience": 84,
      "experienceInPlaceOfEducation": true,
      "requiredLanguages": ["en"],
      "descriptionLanguage": "en",
      "isOnLinkedIn": true,
      "company": {
        "id": 9988,
        "name": "Acme",
        "tagline": "We build remote tools",
        "foundedYear": 2018,
        "chatGPTDescription": "...",
        "chatGPTIndustries": ["SaaS"],
        "linkedInDescription": "...",
        "profilePicURL": "https://...",
        "employeeRange": "51-200",
        "numberOfEmployeesOnLinkedIn": 120,
        "fundingData": "...",
        "totalFundingAmount": "$10M",
        "industry": "SaaS",
        "industrySpecialities": ["Developer tools"],
        "slug": "acme",
        "sponsorsH1B": true,
        "sponsorsUKSkilledWorkerVisa": false
      }
    }
  ],
  "totalCount": 347,
  "pagination": {
    "page": 1,
    "itemsPerPage": 20,
    "totalCount": 347,
    "totalPages": 18,
    "hasNextPage": true,
    "hasPreviousPage": false
  }
}

Example error responses

401 -> { "message": "Missing API key" } | { "message": "Invalid API key" }
403 -> { "message": "Active subscription required" }
429 -> { "message": "Daily request limit reached" }
400 -> { "message": "Missing filters" }
405 -> { "message": "Method not allowed" }
500 -> { "message": "Unable to fetch jobs" } | { "message": "Internal server error" }

Request params + allowed values

Other params

• filters.page (number, min 1, default 1)
• filters.itemsPerPage (number, clamped to 1..50, default 20)
• filters.minSalaryFilter (number or null)
• filters.showJobsWithoutSalaryWithMinSalaryFilter (boolean, default true)
• filters.showHybridJobs, filters.showOnsiteJobs, filters.showRemoteJobs (boolean)
• filters.keywordFilters and filters.excludedKeywordFilters (string arrays)
• filters.companyIdFilter (string or null)
• includeJobDescription (boolean, default false)