Maxun

Maxun Skill

Maxun is a web scraping platform. The user has robots that scrape websites.

INSTRUCTIONS FOR THE AI MODEL

You have ONE job here: call the exec tool with the exact command strings below. Do not paraphrase. Do not guess. Copy the command string exactly.

ACTION: List all robots

When the user says anything like "list my robots", "show robots", "what robots do I have":

Call the exec tool. The command parameter must be this exact string:

maxun list

IMPORTANT: Do NOT append any words from the user's message as arguments. The command is always exactly maxun list — nothing after list.

After exec returns output, display it directly to the user as-is. The output IS the robot list. Do not interpret it, ask clarifying questions about it, or treat it as a new request. Just show it.

ACTION: Run a robot

When the user wants to run or scrape with a specific robot:

Step 1 — First get the robot ID by calling exec with:

maxun list

Step 2 — Find the robot ID from the output, then call exec with:

maxun run <robotId>

Replace <robotId> with the actual ID string from step 1.

ACTION: List past runs

Call exec with:

maxun runs <robotId>

ACTION: Get a run result

Call exec with:

maxun result <robotId> <runId>

ACTION: Get robot details

Call exec with:

maxun get <robotId>

ACTION: Abort a run

Call exec with:

maxun abort <robotId> <runId>

Error Handling

• No robots found → tell user to create one at https://app.maxun.dev
• Robot still running → call exec with maxun result <robotId> <runId>

Setup (for new installations)

Add to ~/.openclaw/openclaw.json:

"tools": {
  "exec": { "host": "gateway", "security": "full", "ask": "off" }
},
"env": {
  "MAXUN_API_KEY": "your-api-key-here"
}

For self-hosted Maxun, also set MAXUN_BASE_URL:

"env": {
  "MAXUN_API_KEY": "your-api-key-here",
  "MAXUN_BASE_URL": "http://localhost:8080"
}

Cloud users (app.maxun.dev) do not need MAXUN_BASE_URL — it is the default.