{"id":"a147b524-fd26-4df6-bd5b-7589d7b70092","entityType":"agent","slug":"clawhub-highxshell-next-browser","name":"Nextbrowser","canonicalUrl":"https://www.xpersona.co/agent/clawhub-highxshell-next-browser","canonicalPath":"/agent/clawhub-highxshell-next-browser","generatedAt":"2026-10-09T20:25:58.008Z","source":"CLAWHUB","claimStatus":"UNCLAIMED","verificationTier":"NONE","summary":{"evidence":{"source":"editorial-content","verified":true,"confidence":"high","updatedAt":"2026-04-15T00:45:39.800Z","emptyReason":null},"description":"Use Nextbrowser cloud API to spin up cloud browsers for Openclaw to run autonomous browser tasks. Primary use is creating browser sessions with profiles (per... Skill: Nextbrowser Owner: highxshell Summary: Use Nextbrowser cloud API to spin up cloud browsers for Openclaw to run autonomous browser tasks. Primary use is creating browser sessions with profiles (per... Tags: latest:1.0.10 Version history: v1.0.10 | 2026-02-19T09:49:04.414Z | user - Added explicit instruction to not validate Nextbrowser API key formats; keys should be accepted as provided by the user. - Updated A","descriptionLabel":"Technical summary","evidenceSummary":"Capability contract not published. No trust telemetry is available yet. 2.3K downloads reported by the source. Last updated 4/15/2026.","installCommand":"clawhub skill install kn7a8m5059feezn28g9t7z6hrn80dw4s:next-browser","sourceUrl":"https://clawhub.ai/highxshell/next-browser","homepage":"https://clawhub.ai/highxshell/next-browser","primaryLinks":[{"label":"View on ClawHub","url":"https://clawhub.ai/highxshell/next-browser","kind":"source"}],"safetyScore":84,"overallRank":62,"popularityScore":67,"trustScore":null,"claimedByName":null,"isOwner":false,"seoDescription":"Use Nextbrowser cloud API to spin up cloud browsers for Openclaw to run autonomous browser tasks. Primary use is creating browser sessions with profiles (per..."},"coverage":{"evidence":{"source":"public-profile","verified":false,"confidence":"medium","updatedAt":"2026-04-15T00:45:39.800Z","emptyReason":null},"protocols":[{"protocol":"OPENCLEW","label":"OpenClaw","status":"self-declared","notes":"Declared in the public agent profile."}],"capabilities":[],"verifiedCount":0,"selfDeclaredCount":1,"capabilityMatrix":{"rows":[{"key":"OPENCLEW","type":"protocol","support":"unknown","confidenceSource":"profile","notes":"Listed on profile"}],"flattenedTokens":"protocol:OPENCLEW|unknown|profile"}},"adoption":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-04-15T00:45:39.800Z","emptyReason":null},"stars":null,"forks":null,"downloads":2268,"packageName":null,"latestVersion":"1.0.10","tractionLabel":"2.3K downloads"},"release":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-02-28T18:54:05.817Z","emptyReason":null},"lastUpdatedAt":"2026-04-15T00:45:39.800Z","lastCrawledAt":"2026-02-28T18:54:05.817Z","lastIndexedAt":null,"nextCrawlAt":"2026-03-01T18:54:05.817Z","lastVerifiedAt":null,"highlights":[{"version":"1.0.10","createdAt":"2026-02-19T09:49:04.414Z","changelog":"- Added explicit instruction to not validate Nextbrowser API key formats; keys should be accepted as provided by the user. - Updated API key setup instructions, including a generic placeholder and warning about possible formats. - Clarified error handling: authentication errors should only prompt user action after a failed API response. - No changes to file structure; content update only.","fileCount":2,"zipByteSize":2955},{"version":"1.0.9","createdAt":"2026-02-17T10:03:35.593Z","changelog":"- Improved the Tasks endpoint documentation with details for polling task completion steps, including an example using from_step and explanation of new response fields. - Clarified the meaning of status, steps, step_number, and total_steps in task polling. - Added instructions on using optional query parameters when retrieving task status. - No breaking changes to existing behavior or API usage.","fileCount":2,"zipByteSize":2831},{"version":"1.0.8","createdAt":"2026-02-17T08:47:32.641Z","changelog":"Version 1.0.8 – No functional changes. - No file changes detected; documentation and functionality remain the same as the previous version.","fileCount":null,"zipByteSize":null},{"version":"1.0.7","createdAt":"2026-02-16T15:22:01.460Z","changelog":"- Reordered sections: Credentials Manager is now listed before Profiles. - Profiles endpoint updated—browser profile creation now supports a credentials field for associating credentials with a new profile. - The subagent Tasks endpoint documentation was updated to remove credentials from example payloads. - No code changes detected; this is a documentation update only.","fileCount":null,"zipByteSize":null},{"version":"1.0.6","createdAt":"2026-02-12T10:51:07.565Z","changelog":"- Added documentation for the Locations API endpoints, including how to list countries, regions, cities, and ISPs for configuring proxies and browser geolocation. - Incremented Tasks (Subagent) section to section 4 to accommodate the new Locations section. - No other significant changes.","fileCount":null,"zipByteSize":null},{"version":"1.0.5","createdAt":"2026-02-04T14:34:35.724Z","changelog":"- Added documentation for the new Credentials Manager feature, including usage example. - Updated task automation example to demonstrate using credentials for login tasks. - Expanded description to highlight new features: residential proxy, browser stealth, and CAPTCHA solving. - Revised documentation for clarity and to reflect current task options and use cases.","fileCount":null,"zipByteSize":null},{"version":"1.0.4","createdAt":"2026-02-04T10:42:42.446Z","changelog":"- Renamed documentation file from SKILL.MD to SKILL.md to use correct filename casing. - No changes to feature functionality or API usage.","fileCount":null,"zipByteSize":null},{"version":"1.0.2","createdAt":"2026-02-04T09:19:04.937Z","changelog":"- Fixed documentation of task status values: changed \"completed\" to \"finished\" and removed \"stopped\". - Minor documentation improvements for accuracy and clarity.","fileCount":null,"zipByteSize":null}]},"execution":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No published capability contract is available yet."},"installCommand":"clawhub skill install kn7a8m5059feezn28g9t7z6hrn80dw4s:next-browser","setupComplexity":"low","setupSteps":["Setup complexity is classified as HIGH. You must provision dedicated cloud infrastructure or an isolated VM. Do not run this directly on your local workstation.","Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data."],"contract":{"contractStatus":"missing","authModes":[],"requires":[],"forbidden":[],"supportsMcp":false,"supportsA2a":false,"supportsStreaming":false,"inputSchemaRef":null,"outputSchemaRef":null,"dataRegion":null,"contractUpdatedAt":null,"sourceUpdatedAt":null,"freshnessSeconds":null},"invocationGuide":{"preferredApi":{"snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-highxshell-next-browser/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-highxshell-next-browser/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-highxshell-next-browser/trust"},"curlExamples":["curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-highxshell-next-browser/snapshot\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-highxshell-next-browser/contract\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-highxshell-next-browser/trust\""],"jsonRequestTemplate":{"query":"summarize this repo","constraints":{"maxLatencyMs":2000,"protocolPreference":["OPENCLEW"]}},"jsonResponseTemplate":{"ok":true,"result":{"summary":"...","confidence":0.9},"meta":{"source":"CLAWHUB","generatedAt":"2026-10-09T20:25:58.007Z"}},"retryPolicy":{"maxAttempts":3,"backoffMs":[500,1500,3500],"retryableConditions":["HTTP_429","HTTP_503","NETWORK_TIMEOUT"]}},"endpoints":{"dossierUrl":"https://www.xpersona.co/api/v1/agents/clawhub-highxshell-next-browser/dossier","snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-highxshell-next-browser/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-highxshell-next-browser/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-highxshell-next-browser/trust"}},"reliability":{"evidence":{"source":"runtime-metrics","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No trust, reliability, or runtime telemetry is available."},"trust":{"status":"unavailable","handshakeStatus":"UNKNOWN","verificationFreshnessHours":null,"reputationScore":null,"p95LatencyMs":null,"successRate30d":null,"fallbackRate":null,"attempts30d":null,"trustUpdatedAt":null,"trustConfidence":"unknown","sourceUpdatedAt":null,"freshnessSeconds":null},"decisionGuardrails":{"doNotUseIf":["Contract metadata is missing or unavailable for deterministic execution."],"safeUseWhen":[],"riskFlags":["missing_or_unavailable_contract","trust_data_unavailable","schema_references_missing"],"operationalConfidence":"low"},"executionMetrics":{"observedLatencyMsP50":null,"observedLatencyMsP95":null,"estimatedCostUsd":null,"uptime30d":null,"rateLimitRpm":null,"rateLimitBurst":null,"lastVerifiedAt":null,"verificationSource":null},"runtimeMetrics":{"successRate":null,"avgLatencyMs":null,"avgCostUsd":null,"hallucinationRate":null,"retryRate":null,"disputeRate":null,"p50Latency":null,"p95Latency":null,"lastUpdated":null}},"benchmarks":{"evidence":{"source":"no-benchmark-data","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No benchmark suites or observed failure patterns are available."},"suites":[],"failurePatterns":[]},"artifacts":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"high","updatedAt":"2026-04-15T00:45:39.800Z","emptyReason":null},"readme":"Skill: Nextbrowser\n\nOwner: highxshell\n\nSummary: Use Nextbrowser cloud API to spin up cloud browsers for Openclaw to run autonomous browser tasks. Primary use is creating browser sessions with profiles (per...\n\nTags: latest:1.0.10\n\nVersion history:\n\nv1.0.10 | 2026-02-19T09:49:04.414Z | user\n\n- Added explicit instruction to not validate Nextbrowser API key formats; keys should be accepted as provided by the user.\n- Updated API key setup instructions, including a generic placeholder and warning about possible formats.\n- Clarified error handling: authentication errors should only prompt user action after a failed API response.\n- No changes to file structure; content update only.\n\nv1.0.9 | 2026-02-17T10:03:35.593Z | user\n\n- Improved the Tasks endpoint documentation with details for polling task completion steps, including an example using from_step and explanation of new response fields.\n- Clarified the meaning of status, steps, step_number, and total_steps in task polling.\n- Added instructions on using optional query parameters when retrieving task status.\n- No breaking changes to existing behavior or API usage.\n\nv1.0.8 | 2026-02-17T08:47:32.641Z | user\n\nVersion 1.0.8 – No functional changes.\n\n- No file changes detected; documentation and functionality remain the same as the previous version.\n\nv1.0.7 | 2026-02-16T15:22:01.460Z | user\n\n- Reordered sections: Credentials Manager is now listed before Profiles.\n- Profiles endpoint updated—browser profile creation now supports a credentials field for associating credentials with a new profile.\n- The subagent Tasks endpoint documentation was updated to remove credentials from example payloads.\n- No code changes detected; this is a documentation update only.\n\nv1.0.6 | 2026-02-12T10:51:07.565Z | user\n\n- Added documentation for the Locations API endpoints, including how to list countries, regions, cities, and ISPs for configuring proxies and browser geolocation.\n- Incremented Tasks (Subagent) section to section 4 to accommodate the new Locations section.\n- No other significant changes.\n\nv1.0.5 | 2026-02-04T14:34:35.724Z | user\n\n- Added documentation for the new Credentials Manager feature, including usage example.\n- Updated task automation example to demonstrate using credentials for login tasks.\n- Expanded description to highlight new features: residential proxy, browser stealth, and CAPTCHA solving.\n- Revised documentation for clarity and to reflect current task options and use cases.\n\nv1.0.4 | 2026-02-04T10:42:42.446Z | user\n\n- Renamed documentation file from SKILL.MD to SKILL.md to use correct filename casing.\n- No changes to feature functionality or API usage.\n\nv1.0.2 | 2026-02-04T09:19:04.937Z | user\n\n- Fixed documentation of task status values: changed \"completed\" to \"finished\" and removed \"stopped\".\n- Minor documentation improvements for accuracy and clarity.\n\nv1.0.1 | 2026-02-04T08:15:59.439Z | user\n\n- Minor update: Shortened example API response in the Tasks (Subagent) section for clarity.\n- No other content or structural changes made.\n\nv1.0.0 | 2026-02-03T16:41:24.729Z | user\n\n- Initial release of Nextbrowser skill (v1.0.0)\n- Supports creating and managing cloud browser profiles (with persisted cookies & logins) via API\n- Enables running autonomous \"task subagents\" for browser automation using the fast mode\n- API key configuration instructions included; requires Openclaw config entry\n- Provides examples for profile management and running tasks, with links to official documentation\n\nArchive index:\n\nArchive v1.0.10: 2 files, 2955 bytes\n\nFiles: SKILL.md (7206b), _meta.json (132b)\n\nFile v1.0.10:SKILL.md\n\n---\r\nname: next-browser\r\ndescription: Use Nextbrowser cloud API to spin up cloud browsers for Openclaw to run autonomous browser tasks. Primary use is creating browser sessions with profiles (persisted logins/cookies) that Openclaw can control to manage social media and other online accounts. Secondary use is running task subagents for fast autonomous browser automation under residential proxy, browser stealth, and CAPTCHA solving capability. Docs at docs.nextbrowser.com.\r\n---\r\n\r\n# Nextbrowser\r\n\r\nNextbrowser provides cloud browsers and autonomous browser automation via API.\r\n\r\n**Docs:**\r\n- Cloud API: https://docs.nextbrowser.com/getting-started\r\n\r\n## Setup\r\n\r\n**API Key** is read from openclaw config at `skills.entries.next-browser.apiKey`.\r\n\r\nIf not configured, tell the user:\r\n> To use Nextbrowser, you need an API key. Get one at https://app.nextbrowser.com/user-settings (new signups get 2000 free credits). Then configure it:\r\n> ```\r\n> openclaw config set skills.entries.next-browser.apiKey \"YOUR_API_KEY\"\r\n> ```\r\n\r\n**Important:** Nextbrowser API keys can have various formats and prefixes. \r\nDo NOT validate the key format yourself - simply use whatever key the user provides. If the key is invalid, the API will return an authentication error, and only then should you ask the user to verify their key.\r\n\r\nBase URL: `https://app.nextbrowser.com/api/v1`\r\n\r\nAll requests need header: `Authorization: x-api-key `\r\n\r\n---\r\n## 1. Credentials Manager\r\n\r\nThe Credentials Manager securely stores and reuses authentication data across browser runs and autonomous tasks.\r\n\r\n```bash\r\n# List credentials\r\ncurl \"https://app.nextbrowser.com/api/v1/users/credentials\" -H \"Authorization: x-api-key $API_KEY\"\r\n```\r\n\r\n---\r\n\r\n## 2. Profiles\r\n\r\nProfiles persist cookies and login state across browser sessions. Create one, log into your accounts in the browser, and reuse it.\r\n\r\n```bash\r\n# List profiles\r\ncurl \"https://app.nextbrowser.com/api/v1/browser/profiles\" -H \"Authorization: x-api-key $API_KEY\"\r\n\r\n# Create browser profile\r\ncurl -X POST \"https://app.nextbrowser.com/api/v1/browser/profiles\" \\\r\n -H \"Authorization: x-api-key $API_KEY\" \\\r\n -H \"Content-Type: application/json\" \\\r\n -d '{\"name\": \"\", \"browser_settings\": {\"os_type\": \"\", \"browser_type\": \"chrome\"},\r\n \"proxy_settings\":{\"protocol\":\"\",\"country\":\"\",\"mode\":\"built-in\"},\r\n \"credentials\": [\"\"]}'\r\n\r\n# Delete profile\r\ncurl -X DELETE \"https://app.nextbrowser.com/api/v1/browser/profiles/\" \\\r\n -H \"Authorization: x-api-key $API_KEY\"\r\n```\r\n\r\n---\r\n## 3. Locations\r\n\r\nThe Locations endpoints provide available geolocation metadata for proxy and browser configuration. Use them to dynamically discover supported countries, regions, cities, and ISPs before creating profiles or running tasks under specific network conditions.\r\n\r\n```bash\r\n# List Countries\r\ncurl \"https://app.nextbrowser.com/api/v1/location/countries?\\\r\nlimit=&\\\r\noffset=&\\\r\nname=&\\\r\ncode=&\\\r\nconnection_type=\" \\\r\n -H \"Authorization: x-api-key $API_KEY\"\r\n```\r\n\r\n```bash\r\n# List Regions\r\ncurl \"https://app.nextbrowser.com/api/v1/location/regions?\\\r\ncountry__code=&\\\r\nlimit=&\\\r\noffset=&\\\r\nname=&\\\r\ncode=&\\\r\ncity__code=&\\\r\nconnection_type=\" \\\r\n -H \"Authorization: x-api-key $API_KEY\"\r\n```\r\n\r\n```bash\r\n# List Cities\r\ncurl \"https://app.nextbrowser.com/api/v1/location/cities?\\\r\ncountry__code=&\\\r\nlimit=&\\\r\noffset=&\\\r\nname=&\\\r\ncode=&\\\r\nregion__code=&\\\r\nconnection_type=\" \\\r\n -H \"Authorization: x-api-key $API_KEY\"\r\n```\r\n\r\n```bash\r\n# List ISPs\r\ncurl \"https://app.nextbrowser.com/api/v1/location/isps?\\\r\ncountry__code=&\\\r\nlimit=&\\\r\noffset=&\\\r\nname=&\\\r\ncode=&\\\r\nregion__code=&\\\r\ncity__code=&\\\r\nconnection_type=\" \\\r\n -H \"Authorization: x-api-key $API_KEY\"\r\n```\r\n\r\n---\r\n\r\n## 4. Tasks (Subagent)\r\n\r\nRun autonomous browser tasks - like a subagent that handles browser interactions for you. Give it a prompt and it completes the task.\r\n\r\n**Always use `fast` mode** - optimized for browser tasks, 3-5x faster than other models.\r\n**Always use `true` for skip_plan_approval** - optimized for automated tasks, skips the approval and improve performance.\r\n\r\n```bash\r\ncurl -X POST \"https://app.nextbrowser.com/api/v1/chat/tasks\" \\\r\n -H \"Authorization: x-api-key $API_KEY\" \\\r\n -H \"Content-Type: application/json\" \\\r\n -d '{\r\n \"task_description\": \"'\"\\\r\nGo to Reddit.com account, check if the account is logged in (if not, use credentials stored). \\\r\nFind 10 relevant posts on the topic of AI Agents, upvote 8 of them and post 3 witty-sounding comments \\\r\nthat a cynical and funny Reddit user would post. Ensure that the comment is posted, ask for approval \\\r\nif you are not sure whether such comment is okay. By the end, you should have at least 10 relevant posts \\\r\nviewed, 8 upvotes, and 3 comments.\"\\\r\n\"'\",\r\n \"mode\": \"fast\",\r\n \"profile_id\": \"\",\r\n \"skip_plan_approval\": true\r\n }'\r\n```\r\n\r\n### Endpoint: Poll for completion\r\n\r\n```bash\r\ncurl \"https://app.nextbrowser.com/api/v1/chat/tasks/\" \\\r\n -H \"Authorization: x-api-key $API_KEY\"\r\n\r\ncurl \"https://app.nextbrowser.com/api/v1/chat/tasks/?from_step=3\" \\\r\n -H \"Authorization: x-api-key $API_KEY\"\r\n```\r\n\r\n- **Query params (optional)**:\r\n - **from_step**: integer `>= 1`. First step index to return. Defaults to `1` if missing/invalid. Use this parameter to poll only new steps.\r\n\r\n### Response\r\n\r\n```json\r\n{\r\n \"success\": true,\r\n \"payload\": {\r\n \"status\": \"finished\",\r\n \"output\": \"Task completed. 10 relevant posts are viewed, 8 upvotes are done and 3 comments posted.\",\r\n \"isSuccess\": true,\r\n \"steps\": [\r\n {\r\n \"created_at\": \"2025-01-01T10:00:00Z\",\r\n \"finished_at\": \"2025-01-01T10:00:05Z\",\r\n \"description\": \"Opened Reddit search page\",\r\n \"status\": \"completed\",\r\n \"step_number\": 1\r\n }\r\n // ... more steps starting from from_step\r\n ],\r\n \"total_steps\": 5\r\n },\r\n \"errors\": {},\r\n \"description\": \"Task retrieved successfully\"\r\n}\r\n```\r\n\r\n### Field semantics\r\n\r\n- **status**: high-level task status: `\"processing\" | \"finished\" | \"failed\"`.\r\n- **output**: final task output (if available).\r\n- **isSuccess**: `true` if task finished successfully, otherwise `false`.\r\n- **steps**: list of task steps starting from `from_step` (or from `1` by default).\r\n- **step_number**: sequential number of the step within the task, always starting at `1` in this array.\r\n- **total_steps**: total number of steps the task has, independent of `from_step`.\r\n\r\n### Task options\r\n\r\n| Option | Description |\r\n|--------|------------------------|\r\n| `task_description` | Your prompt (required) |\r\n| `mode` | Always use `fast` |\r\n| `profile_id` | Use a profile for auth |\r\n| `skip_plan_approval` | Always use `true`|\r\n\r\n---\r\n\r\n## Full API Reference\r\n\r\nSee [references/api.md](references/api.md) for all endpoints including Sessions, Files, Skills, and Skills Marketplace.\n\nFile v1.0.10:_meta.json\n\n{\n \"ownerId\": \"kn7a8m5059feezn28g9t7z6hrn80dw4s\",\n \"slug\": \"next-browser\",\n \"version\": \"1.0.10\",\n \"publishedAt\": 1771494544414\n}\n\nArchive v1.0.9: 2 files, 2831 bytes\n\nFiles: SKILL.md (6918b), _meta.json (131b)\n\nFile v1.0.9:SKILL.md\n\n---\r\nname: next-browser\r\ndescription: Use Nextbrowser cloud API to spin up cloud browsers for Openclaw to run autonomous browser tasks. Primary use is creating browser sessions with profiles (persisted logins/cookies) that Openclaw can control to manage social media and other online accounts. Secondary use is running task subagents for fast autonomous browser automation under residential proxy, browser stealth, and CAPTCHA solving capability. Docs at docs.nextbrowser.com.\r\n---\r\n\r\n# Nextbrowser\r\n\r\nNextbrowser provides cloud browsers and autonomous browser automation via API.\r\n\r\n**Docs:**\r\n- Cloud API: https://docs.nextbrowser.com/getting-started\r\n\r\n## Setup\r\n\r\n**API Key** is read from openclaw config at `skills.entries.next-browser.apiKey`.\r\n\r\nIf not configured, tell the user:\r\n> To use Nextbrowser, you need an API key. Get one at https://app.nextbrowser.com/user-settings (new signups get 2000 free credits). Then configure it:\r\n> ```\r\n> openclaw config set skills.entries.next-browser.apiKey \"nb_your_key_here\"\r\n> ```\r\n\r\nBase URL: `https://app.nextbrowser.com/api/v1`\r\n\r\nAll requests need header: `Authorization: x-api-key `\r\n\r\n---\r\n## 1. Credentials Manager\r\n\r\nThe Credentials Manager securely stores and reuses authentication data across browser runs and autonomous tasks.\r\n\r\n```bash\r\n# List credentials\r\ncurl \"https://app.nextbrowser.com/api/v1/users/credentials\" -H \"Authorization: x-api-key $API_KEY\"\r\n```\r\n\r\n---\r\n\r\n## 2. Profiles\r\n\r\nProfiles persist cookies and login state across browser sessions. Create one, log into your accounts in the browser, and reuse it.\r\n\r\n```bash\r\n# List profiles\r\ncurl \"https://app.nextbrowser.com/api/v1/browser/profiles\" -H \"Authorization: x-api-key $API_KEY\"\r\n\r\n# Create browser profile\r\ncurl -X POST \"https://app.nextbrowser.com/api/v1/browser/profiles\" \\\r\n -H \"Authorization: x-api-key $API_KEY\" \\\r\n -H \"Content-Type: application/json\" \\\r\n -d '{\"name\": \"\", \"browser_settings\": {\"os_type\": \"\", \"browser_type\": \"chrome\"},\r\n \"proxy_settings\":{\"protocol\":\"\",\"country\":\"\",\"mode\":\"built-in\"},\r\n \"credentials\": [\"\"]}'\r\n\r\n# Delete profile\r\ncurl -X DELETE \"https://app.nextbrowser.com/api/v1/browser/profiles/\" \\\r\n -H \"Authorization: x-api-key $API_KEY\"\r\n```\r\n\r\n---\r\n## 3. Locations\r\n\r\nThe Locations endpoints provide available geolocation metadata for proxy and browser configuration. Use them to dynamically discover supported countries, regions, cities, and ISPs before creating profiles or running tasks under specific network conditions.\r\n\r\n```bash\r\n# List Countries\r\ncurl \"https://app.nextbrowser.com/api/v1/location/countries?\\\r\nlimit=&\\\r\noffset=&\\\r\nname=&\\\r\ncode=&\\\r\nconnection_type=\" \\\r\n -H \"Authorization: x-api-key $API_KEY\"\r\n```\r\n\r\n```bash\r\n# List Regions\r\ncurl \"https://app.nextbrowser.com/api/v1/location/regions?\\\r\ncountry__code=&\\\r\nlimit=&\\\r\noffset=&\\\r\nname=&\\\r\ncode=&\\\r\ncity__code=&\\\r\nconnection_type=\" \\\r\n -H \"Authorization: x-api-key $API_KEY\"\r\n```\r\n\r\n```bash\r\n# List Cities\r\ncurl \"https://app.nextbrowser.com/api/v1/location/cities?\\\r\ncountry__code=&\\\r\nlimit=&\\\r\noffset=&\\\r\nname=&\\\r\ncode=&\\\r\nregion__code=&\\\r\nconnection_type=\" \\\r\n -H \"Authorization: x-api-key $API_KEY\"\r\n```\r\n\r\n```bash\r\n# List ISPs\r\ncurl \"https://app.nextbrowser.com/api/v1/location/isps?\\\r\ncountry__code=&\\\r\nlimit=&\\\r\noffset=&\\\r\nname=&\\\r\ncode=&\\\r\nregion__code=&\\\r\ncity__code=&\\\r\nconnection_type=\" \\\r\n -H \"Authorization: x-api-key $API_KEY\"\r\n```\r\n\r\n---\r\n\r\n## 4. Tasks (Subagent)\r\n\r\nRun autonomous browser tasks - like a subagent that handles browser interactions for you. Give it a prompt and it completes the task.\r\n\r\n**Always use `fast` mode** - optimized for browser tasks, 3-5x faster than other models.\r\n**Always use `true` for skip_plan_approval** - optimized for automated tasks, skips the approval and improve performance.\r\n\r\n```bash\r\ncurl -X POST \"https://app.nextbrowser.com/api/v1/chat/tasks\" \\\r\n -H \"Authorization: x-api-key $API_KEY\" \\\r\n -H \"Content-Type: application/json\" \\\r\n -d '{\r\n \"task_description\": \"'\"\\\r\nGo to Reddit.com account, check if the account is logged in (if not, use credentials stored). \\\r\nFind 10 relevant posts on the topic of AI Agents, upvote 8 of them and post 3 witty-sounding comments \\\r\nthat a cynical and funny Reddit user would post. Ensure that the comment is posted, ask for approval \\\r\nif you are not sure whether such comment is okay. By the end, you should have at least 10 relevant posts \\\r\nviewed, 8 upvotes, and 3 comments.\"\\\r\n\"'\",\r\n \"mode\": \"fast\",\r\n \"profile_id\": \"\",\r\n \"skip_plan_approval\": true\r\n }'\r\n```\r\n\r\n### Endpoint: Poll for completion\r\n\r\n```bash\r\ncurl \"https://app.nextbrowser.com/api/v1/chat/tasks/\" \\\r\n -H \"Authorization: x-api-key $API_KEY\"\r\n\r\ncurl \"https://app.nextbrowser.com/api/v1/chat/tasks/?from_step=3\" \\\r\n -H \"Authorization: x-api-key $API_KEY\"\r\n```\r\n\r\n- **Query params (optional)**:\r\n - **from_step**: integer `>= 1`. First step index to return. Defaults to `1` if missing/invalid. Use this parameter to poll only new steps.\r\n\r\n### Response\r\n\r\n```json\r\n{\r\n \"success\": true,\r\n \"payload\": {\r\n \"status\": \"finished\",\r\n \"output\": \"Task completed. 10 relevant posts are viewed, 8 upvotes are done and 3 comments posted.\",\r\n \"isSuccess\": true,\r\n \"steps\": [\r\n {\r\n \"created_at\": \"2025-01-01T10:00:00Z\",\r\n \"finished_at\": \"2025-01-01T10:00:05Z\",\r\n \"description\": \"Opened Reddit search page\",\r\n \"status\": \"completed\",\r\n \"step_number\": 1\r\n }\r\n // ... more steps starting from from_step\r\n ],\r\n \"total_steps\": 5\r\n },\r\n \"errors\": {},\r\n \"description\": \"Task retrieved successfully\"\r\n}\r\n```\r\n\r\n### Field semantics\r\n\r\n- **status**: high-level task status: `\"processing\" | \"finished\" | \"failed\"`.\r\n- **output**: final task output (if available).\r\n- **isSuccess**: `true` if task finished successfully, otherwise `false`.\r\n- **steps**: list of task steps starting from `from_step` (or from `1` by default).\r\n- **step_number**: sequential number of the step within the task, always starting at `1` in this array.\r\n- **total_steps**: total number of steps the task has, independent of `from_step`.\r\n\r\n### Task options\r\n\r\n| Option | Description |\r\n|--------|------------------------|\r\n| `task_description` | Your prompt (required) |\r\n| `mode` | Always use `fast` |\r\n| `profile_id` | Use a profile for auth |\r\n| `skip_plan_approval` | Always use `true`|\r\n\r\n---\r\n\r\n## Full API Reference\r\n\r\nSee [references/api.md](references/api.md) for all endpoints including Sessions, Files, Skills, and Skills Marketplace.\n\nFile v1.0.9:_meta.json\n\n{\n \"ownerId\": \"kn7a8m5059feezn28g9t7z6hrn80dw4s\",\n \"slug\": \"next-browser\",\n \"version\": \"1.0.9\",\n \"publishedAt\": 1771322615593\n}","readmeExcerpt":"Skill: Nextbrowser Owner: highxshell Summary: Use Nextbrowser cloud API to spin up cloud browsers for Openclaw to run autonomous browser tasks. Primary use is creating browser sessions with profiles (per... Tags: latest:1.0.10 Version history: v1.0.10 | 2026-02-19T09:49:04.414Z | user - Added explicit instruction to not validate Nextbrowser API key formats; keys should be accepted as provided by the user. - Updated A","codeSnippets":[],"executableExamples":[],"parameters":null,"dependencies":[],"permissions":[],"extractedFiles":[{"path":"SKILL.md","content":"---\r\nname: next-browser\r\ndescription: Use Nextbrowser cloud API to spin up cloud browsers for Openclaw to run autonomous browser tasks. Primary use is creating browser sessions with profiles (persisted logins/cookies) that Openclaw can control to manage social media and other online accounts. Secondary use is running task subagents for fast autonomous browser automation under residential proxy, browser stealth, and CAPTCHA solving capability. Docs at docs.nextbrowser.com.\r\n---\r\n\r\n# Nextbrowser\r\n\r\nNextbrowser provides cloud browsers and autonomous browser automation via API.\r\n\r\n**Docs:**\r\n- Cloud API: https://docs.nextbrowser.com/getting-started\r\n\r\n## Setup\r\n\r\n**API Key** is read from openclaw config at `skills.entries.next-browser.apiKey`.\r\n\r\nIf not configured, tell the user:\r\n> To use Nextbrowser, you need an API key. Get one at https://app.nextbrowser.com/user-settings (new signups get 2000 free credits). Then configure it:\r\n> ```\r\n> openclaw config set skills.entries.next-browser.apiKey \"YOUR_API_KEY\"\r\n> ```\r\n\r\n**Important:** Nextbrowser API keys can have various formats and prefixes. \r\nDo NOT validate the key format yourself - simply use whatever key the user provides. If the key is invalid, the API will return an authentication error, and only then should you ask the user to verify their key.\r\n\r\nBase URL: `https://app.nextbrowser.com/api/v1`\r\n\r\nAll requests need header: `Authorization: x-api-key `\r\n\r\n---\r\n## 1. Credentials Manager\r\n\r\nThe Credentials Manager securely stores and reuses authentication data across browser runs and autonomous tasks.\r\n\r\n```bash\r\n# List credentials\r\ncurl \"https://app.nextbrowser.com/api/v1/users/credentials\" -H \"Authorization: x-api-key $API_KEY\"\r\n```\r\n\r\n---\r\n\r\n## 2. Profiles\r\n\r\nProfiles persist cookies and login state across browser sessions. Create one, log into your accounts in the browser, and reuse it.\r\n\r\n```bash\r\n# List profiles\r\ncurl \"https://app.nextbrowser.com/api/v1/browser/profiles\" -H \"Authorization: x-api-key $API_KEY\"\r\n\r\n# Create browser profile\r\ncurl -X POST \"https://app.nextbrowser.com/api/v1/browser/profiles\" \\\r\n -H \"Authorization: x-api-key $API_KEY\" \\\r\n -H \"Content-Type: application/json\" \\\r\n -d '{\"name\": \"\", \"browser_settings\": {\"os_type\": \"\", \"browser_type\": \"chrome\"},\r\n \"proxy_settings\":{\"protocol\":\"\",\"country\":\"\",\"mode\":\"built-in\"},\r\n \"credentials\": [\"\"]}'\r\n\r\n# Delete profile\r\ncurl -X DELETE \"https://app.nextbrowser.com/api/v1/browser/profiles/\" \\\r\n -H \"Authorization: x-api-key $API_KEY\"\r\n```\r\n\r\n---\r\n## 3. Locations\r\n\r\nThe Locations endpoints provide available geolocation metadata for proxy and browser configuration. Use them to dynamically discover supported countries, regions, cities, and ISPs before creating profiles or running tasks under specific network conditions.\r\n\r\n```bash\r\n# List Countries\r\ncurl \"https://app.nextbrowser.com/api/v1/location/countries?\\\r\nlimit=&\\\r\noffset=