Registry / search / oxylabs-ai-studio-openclaw

oxylabs-ai-studio-openclaw

library1.0.3jsnpmunverified

An OpenClaw plugin providing web search and web fetch tools powered by Oxylabs AI Studio. Version 1.0.3 integrates with OpenClaw >=2026.3.23 to offer AI-powered web search with geographic/language filtering and structured JSON responses, plus AI-driven content extraction from URLs returning clean markdown. Key differentiators include automatic parsing, intent-driven actions, JavaScript rendering support, and bypassing IP blocks. The package ships TypeScript types and can be configured via environment variable or plugin config.

npm install oxylabs-ai-studio-openclaw

package ↗

INSTALL

IMPORT

SIG · OXYLABS-AI-STUDIO-

oxylabs-ai-studio-openclaw

searchjavascriptv1.0.3

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

default

✓ import oxylabsPlugin from 'oxylabs-ai-studio-openclaw'

✗ const oxylabsPlugin = require('oxylabs-ai-studio-openclaw')

Package is ESM-only; use import syntax. CommonJS require() will not work.

createOxylabsPlugin

✓ import { createOxylabsPlugin } from 'oxylabs-ai-studio-openclaw'

Named export available for factory-style usage. Both default and named exports provide the same plugin.

OxylabsPluginOptions

✓ import type { OxylabsPluginOptions } from 'oxylabs-ai-studio-openclaw'

✗ import { OxylabsPluginOptions } from 'oxylabs-ai-studio-openclaw' (type used as value)

Type import is required for TypeScript; the type is not a runtime value.

Install and configure the plugin, then perform a web search using the oxylabs_web_search tool with 5 results.

import { createOpenClaw } from 'openclaw'; import oxylabsPlugin from 'oxylabs-ai-studio-openclaw'; const claw = createOpenClaw({ plugins: { entries: { 'oxylabs-aistudio': { enabled: true, config: { apiKey: process.env.OXYLABS_AISTUDIO_API_KEY ?? '' } } } } }); (async () => { const result = await claw.tools.oxylabs_web_search({ query: 'latest AI news', maxResults: 5 }); console.log(JSON.stringify(result, null, 2)); })();

Debug

Known issues

gotchaThe plugin requires OpenClaw >=2026.3.23; older versions will fail to load the tools.

fix

Ensure OpenClaw version is at least 2026.3.23 by updating your project's openclaw dependency.

affects: >=1.0.0 <1.0.0

deprecatedAs of version 1.0.3, the default export is a pre-configured plugin object; the createOxylabsPlugin named export is considered legacy and may be removed in a future major version.

fix

Use the default import (import oxylabsPlugin from 'oxylabs-ai-studio-openclaw') instead of createOxylabsPlugin.

affects: >=1.0.3

gotchaThe API key can be set via environment variable OXYLABS_AISTUDIO_API_KEY or plugin config apiKey. If both are provided, the config value takes precedence.

fix

Set OXYLABS_AISTUDIO_API_KEY in your environment or ensure the plugin config includes an apiKey field.

affects: >=1.0.0

gotchaThe oxylabs_web_fetch tool may require longer polling; defaults are 3s interval with up to 8 polls (24s total). For large pages, increase maxPolls or pollIntervalMs in config.

fix

Adjust config: { pollIntervalMs: 5000, maxPolls: 15 } for slower content.

affects: >=1.0.0

gotchaThe package does not provide CommonJS support; using require() will throw a runtime error.

fix

Use import syntax or configure your bundler/Node.js to handle ESM (e.g., "type": "module" in package.json).

affects: >=1.0.0

Errors

Common errors & fixes

ERR_REQUIRE_ESM: require() of ES Module /path/to/node_modules/oxylabs-ai-studio-openclaw/dist/index.js from /path/to/your/file.js not supported.

The package is ESM-only but the consumer is trying to require() it.

fix

Switch to import syntax: import oxylabsPlugin from 'oxylabs-ai-studio-openclaw'; or rename your file to .mjs if using Node.js without 'type':'module'.

Error: Oxylabs AI Studio API key is not configured. Provide it via OXYLABS_AISTUDIO_API_KEY env var or apiKey in plugin config.

Neither the environment variable nor the plugin configuration contains a valid API key.

fix

Set the OXYLABS_AISTUDIO_API_KEY environment variable or add apiKey under plugin config entries for oxylabs-aistudio.

TypeError: claw.tools.oxylabs_web_search is not a function

The plugin was not registered correctly, or OpenClaw version is below 2026.3.23.

fix

Verify that oxylabs-aistudio plugin entry is enabled and OpenClaw >=2026.3.23 is installed. Check that the plugin config is nested under entries.

Error: Cannot find module 'openclaw'

openclaw is a peer dependency that must be installed separately.

fix

Run 'npm install openclaw@>=2026.3.23' in your project.

Upgrade

Version history

1.0.3latest on npm

Audit

Dependencies

openclawrequiredPeer dependency: requires OpenClaw runtime >=2026.3.23 to register tools

Agent activity

35 hits · last 30 days

node

Resources

packageoxylabs-ai-studio-openclaw ↗