OpenClaw

了解如何将 Oxylabs OpenClaw 技能与 Oxylabs AI Studio 配置。

我们提供一个用于 OpenClaw 代理，可通过 Oxylabs AI Studio进行网页搜索和页面提取，包括地理定向搜索、JavaScript 渲染和 Markdown 内容提取。

要求

• python 3 在 PATH
• OpenClaw 中已安装并运行
• Oxylabs AI Studio API 密钥

安装

openclaw skills install @oxylabs/oxylabs-web-search

它会安装到当前工作区的 skills/ 目录中。

添加 --global 可安装到 ~/.openclaw/skills，使该技能对所有本地代理可见：

openclaw skills install @oxylabs/oxylabs-web-search --global

启用前验证该技能：

openclaw skills verify @oxylabs/oxylabs-web-search

当 ClawHub 将验证标记为失败时，命令会以非零状态退出。

配置

该技能读取 OXYLABS_AI_STUDIO_API_KEY。请通过以下三种方式之一提供。

选项 1：OpenClaw 配置（推荐）

添加一项到 ~/.openclaw/openclaw.json:

{
  "skills": {
    "entries": {
      "oxylabs-web-search": {
        "enabled": true,
        "apiKey": "YOUR_OXYLABS_AI_STUDIO_API_KEY"
      }
    }
  }
}

选项 2：环境变量

export OXYLABS_AI_STUDIO_API_KEY="YOUR_OXYLABS_AI_STUDIO_API_KEY"

选项 3： .env 文件

OXYLABS_AI_STUDIO_API_KEY=YOUR_OXYLABS_AI_STUDIO_API_KEY

apiKey 也接受 SecretRef 对象来替代明文字符串。

安装后重新启动一个 OpenClaw 会话，并确认该技能已加载：

openclaw skills check

用法

搜索 – 查找查询的页面

python3 scripts/oxylabs.py search "best pancake recipe" -n 5

响应：

抓取 – 将一个页面作为 Markdown 获取

python3 scripts/oxylabs.py scrape "https://sandbox.oxylabs.io/products/1"

响应：

使用以下命令保持技能更新：

openclaw skills update --all

openclaw skills update 仅跟踪 ClawHub 安装。请重新安装 Git 和本地源以刷新它们。

输入参数

• query (字符串)：要搜索的内容（必需，位置参数）
• url (字符串)：要抓取的目标 URL（必需，位置参数）
• -n (整数)：要返回的结果最大数量
• --content (标志)：在结果中包含页面内容
• --geo (字符串)：以 ISO2 格式指定搜索代理位置
• --render-js (标志)：渲染 JavaScript（默认：关闭）

用法示例

请参见 ClawHub 上的技能列表 以获取完整的 SKILL.md 和源代码。