OpenClaw Integration Guide
Connect Orbyt to OpenClaw for AI-powered job search assistance. OpenClaw reads Orbyt's REST tool manifest, so setup takes under a minute.
At a glance
- What you get
- Twenty-nine Orbyt tools inside OpenClaw: twenty-two Jobs pipeline tools plus seven salary intelligence lookups.
- What the URL is
- A static REST tool manifest at /mcp.json, a JSON file describing 29 endpoints. It is not a live JSON-RPC MCP server, and OpenClaw reads it as a manifest.
- Plan required
- Orbyt Ultra for the 22 pipeline tools. The 7 salary tools call Orbyt Intelligence and need a separate Intelligence key, which the free tier covers with no card.
- Auth
- Bearer token. Orbyt Jobs tokens begin with ext_ and are created in Settings, Account, API Keys.
- If you need a real MCP server
- Orbyt runs one for salary intelligence at /api/v1/intelligence/mcp. It speaks JSON-RPC 2.0, negotiates official protocol revisions, and requires an Intelligence key on Pro or higher.
- Setup time
- Under a minute. Name, URL, auth header, save.
Overview
OpenClaw is an AI assistant that can load external tools. Connecting Orbyt gives OpenClaw direct access to your job pipeline, contacts, calendar, and suggestions.
One honest clarification before the steps. The URL you paste below, https://www.orbytlabs.ai/mcp.json, is a static REST tool manifest: a JSON file describing 29 REST endpoints. It is not a live JSON-RPC MCP server. OpenClaw's manifest-based server support reads it. If your client requires a real MCP server (the JSON-RPC kind that Claude Desktop speaks), Orbyt has one for salary intelligence at https://www.orbytlabs.ai/api/v1/intelligence/mcp; it negotiates official MCP protocol versions and requires an Intelligence key on the Pro plan or higher. See the Claude Desktop guide for that config.
What You Need
- Orbyt Ultra plan
- OpenClaw installed
- An Orbyt API key from Settings > Account > API Keys
Step 1: Get Your API Key
- Open Orbyt > Settings > Account
- Scroll to API Keys
- Click Create API Key
- Name it "OpenClaw"
- Copy the token (starts with
ext_)
Step 2: Add Orbyt to OpenClaw
- Open OpenClaw Settings
- Go to the MCP Servers section
- Click Add Server
- Enter these details:
- Name: Orbyt
- URL: https://www.orbytlabs.ai/mcp.json
- Auth Header: Bearer ext_your_token_here
- Click Save
That's it. OpenClaw will load all 29 Orbyt tools automatically: 22 job-search pipeline tools plus 7 salary intelligence lookups. The 7 salary tools call the Orbyt Intelligence REST API and need an intelligence_ key (the free tier covers them, no card required); your ext_ token covers the 22 pipeline tools.
Step 3: Try It
Ask OpenClaw:
- "What's in my job pipeline?"
- "Add a Senior Engineer role at Figma to my pipeline"
- "What should I follow up on this week?"
- "Show me my contacts at Stripe"
- "Log a phone screen with Linear today"
What OpenClaw Can Do With Orbyt
| Ask OpenClaw to... | What happens |
|---|---|
| Show your pipeline | Reads your jobs grouped by status |
| Add a job | Creates a new entry in your pipeline |
| Update a status | Moves a job to the next stage |
| Check follow-ups | Shows overdue and upcoming action items |
| Find contacts | Searches by name or company |
| Log an activity | Records calls, emails, interviews |
| Check your calendar | Shows upcoming interviews and events |
Troubleshooting
Orbyt doesn't appear in OpenClaw:
- Double-check the URL is exactly
https://www.orbytlabs.ai/mcp.json - Make sure your token starts with
ext_ - Restart OpenClaw
Getting errors:
- 401: Your API key is wrong or revoked. Generate a new one.
- 403: Your Orbyt plan needs to be Ultra.
- 429: You hit the rate limit. Wait a minute and try again.
Common questions
Is the Orbyt OpenClaw URL a real MCP server?
No, and the distinction matters. The URL at /mcp.json is a static REST tool manifest, a JSON file describing 29 endpoints, which OpenClaw's manifest-based server support reads directly. Orbyt does run a real JSON-RPC MCP server, but it serves salary intelligence and lives at a different address.
How many Orbyt tools does OpenClaw load?
Twenty-nine. Twenty-two are Jobs pipeline tools covering jobs, contacts, activities, calendar, suggestions and your profile. The other seven are salary intelligence lookups: get, calculate, projections, history, list roles, list cities, and search roles.
Do I need two different Orbyt keys for OpenClaw?
Effectively yes, because the tools reach two products. Your ext_ token covers the 22 pipeline tools and needs Orbyt Ultra. The 7 salary tools call Orbyt Intelligence and use an intelligence_ key, which the free Intelligence tier covers at 1,000 requests a month with no card.
What Orbyt plan does OpenClaw need?
Orbyt Ultra for the pipeline tools. External API access is a single gated feature at the top tier, so a token created on Free or Pro is valid but every pipeline call returns HTTP 403. The salary tools are separate and their free tier needs no paid plan.
Orbyt does not appear in OpenClaw. What should I check?
Three things, in order. Confirm the URL is exactly the manifest address with no trailing path. Confirm the token begins with ext_ and that the auth header includes the word Bearer before it. Then restart OpenClaw, because the manifest is fetched when a server is loaded and not on every call.
What do 401, 403 and 429 mean from Orbyt tools in OpenClaw?
A 401 means the token is wrong, revoked, or was truncated when pasted. A 403 means the token is valid but the account behind it is not on Orbyt Ultra. A 429 means you hit the per-minute rate limit; wait a minute and the same call succeeds.
Can OpenClaw change my job data, or only read it?
It can change it. The manifest includes write tools that create jobs, log activities and move a job to a new status, and the token you paste carries whatever permissions you gave it. If you want a read-only assistant, create a read-only token rather than relying on how you phrase requests.
Which client should I use if OpenClaw will not read a manifest?
Use the Claude Desktop path instead. Clients built on the official MCP SDK expect a live JSON-RPC server, which a static manifest is not. Orbyt's Intelligence MCP endpoint is a real one, and the Claude Desktop guide carries a working config for it that any SDK-based client can adapt.
