Remote Rocketship × OpenClaw Skill (Natural Language Job Finder)

Use this skill whenever a user asks (in normal chat) to find remote jobs, browse opportunities, or set up an ongoing job search. This integration is powered by Remote Rocketship (https://www.remoterocketship.com).

Github repo: https://github.com/Lior539/openclaw-remote-jobs-finder

UX rule: fully conversational. Do not tell the user to run CLIs, use slash commands, or visit dashboards.

Fetching jobs (MANDATORY)

When the user wants real job listings, you MUST call the OpenClaw tool rr_jobs_search.

Hard rules:

• Do NOT ask the user to run any CLI.
• Do NOT claim you can’t fetch listings (you can).
• Do NOT attempt raw HTTP calls from the model.

• The Remote Rocketship API key is provided server-side via environment variable RR_API_KEY.
• Never ask the user to paste secrets in WhatsApp.

{
  "filters": {
    "page": 1,
    "itemsPerPage": 20,
    "jobTitleFilters": ["Product Manager"],
    "locationFilters": ["United Kingdom"]
  },
  "includeJobDescription": false
}

When to Trigger

Trigger on messages like:

• “Help me find a remote job”
• “Find me remote Product Manager roles”
• “Show me remote jobs in the UK”
• “Any new backend roles since yesterday?”
• “Send me 20 more”
• “Set this up to check every hour”

Conversation Flow

A) Onboarding (keep it short)

1) Role / direction (required)

• “What kind of roles are you looking for? (job titles, function, seniority)”

• “Where can you legally work from? (country / region)”

• “Any must-haves (salary/industry/async) or deal-breakers?”

• “Want me to check for new matches on a schedule (hourly/daily/off)?”

B) First fetch (default)

• Default itemsPerPage: 20 unless the user asks for a different batch size.
• Keep includeJobDescription: false unless the user asks for deeper detail.

Preference Memory (important)

Maintain a simple user profile in memory so the user doesn’t need to repeat themselves:

• targetTitles: string[]
• locationFilters: string[]
• seniorityFilters: string[] (if known)
• employmentTypeFilters: string[] (if known)
• mustHaves: string[]
• dealBreakers: string[]
• rankingPreference: "best_fit" | "newest_first"
• pollingCadence: e.g. "hourly" / "daily" / "off"
• lastQueryFilters: the last filters object used (for “20 more”)

Pagination & “20 more”

Store lightweight paging state:

• filters
• page
• itemsPerPage
• pagination.totalCount / hasNextPage

Output formatting (WhatsApp-friendly)

For each job, show as a bulleted list: Role Title — Company

• 🕒 Posted:
• Location (remote scope)
• 💰 Salary (or “Salary undisclosed”)
• 1–2 line summary
• 🔗 Link to apply
• 🏢 Link to company homepage
• 🌐 Link to company LinkedIn:

• “Want 20 more, or should I narrow by industry/seniority/salary?”

OpenClaw Tool to Use (required)

Tool: rr_jobs_search

Parameters:

• filters (object): passed through to Remote Rocketship API filters
• includeJobDescription (boolean, optional; default false)

Error handling

Filters (common)

Common filter keys you can use inside filters:

• page (int, default 1)
• itemsPerPage (int, default 20, max 50)
• jobTitleFilters (string[])
• locationFilters (string[]) — use canonical values like “United Kingdom”, “Worldwide”
• keywordFilters (string[])
• excludedKeywordFilters (string[])
• seniorityFilters (string[]) — e.g. ["senior"]
• employmentTypeFilters (string[]) — e.g. ["full-time"]