跳转到主要内容
账户管理不是 Bright Data 平台支持的使用场景（自 2026 年 4 月 1 日起生效）。这包括在 TikTok、Instagram 等类似平台上进行账户管理。Bright Data 代理不得用于此类用途。详情请参阅可接受使用政策。

正在构建 AI 初创公司？

您可能符合我们的初创计划资格。获得本文所介绍基础设施的全额资助访问权限（最高价值 $20,000）。
OpenClaw 是一个自托管的 AI 助手网关，可将 WhatsApp、Telegram、Discord 和 iMessage 等消息应用连接到 AI 编码代理。它具有插件系统，可让您使用新工具和功能扩展代理。 Bright Data 的 OpenClaw 插件将 Bright Data 网络数据基础设施的全部功能直接带入您的 OpenClaw 代理中。安装一次，您的代理即可获得：
  • 实时网络搜索通过 Google、Bing 和 Yandex 进行地理定位
  • 机器人绕过抓取通过 Web Unlocker，它自动处理验证码、JS 渲染和速率限制
  • 完整的浏览器自动化通过实际的 Chromium 实例，由 Bright Data 的住宅代理网络路由
  • 50+ 结构化数据工具用于 Amazon、LinkedIn、Instagram、TikTok、YouTube、Reddit 等
该插件注册了 66 个工��，分为五个类别：搜索、抓取、批量操作、浏览器自动化和结构化网络数据。

​
入门步骤

1

前置条件

2

获取您的 Bright Data API 密钥

3

安装 Bright Data 插件

使用 OpenClaw CLI 安装插件：
openclaw plugins install @brightdata/brightdata-plugin
验证安装：
openclaw plugins inspect brightdata
您应该看到插件 ID brightdata 以及所有已注册的工具。
4

配置您的 API 密钥

选择以下方法之一来提供您的 Bright Data API 密钥：
export BRIGHTDATA_API_TOKEN=your_token_here
该插件在首次使用时自动创建两个代理区域：mcp_unlocker（Web Unlocker）和 mcp_browser（Browser API）。无需手动设置区域。
要使用现有的区域，请改为执行以下操作：
export BRIGHTDATA_UNLOCKER_ZONE=my_existing_zone
export BRIGHTDATA_BROWSER_ZONE=my_existing_browser_zone
5

启用插件

启用插件并重启网关：
openclaw plugins enable brightdata
openclaw gateway restart
如果插件工具未向您的代理公开，您可能需要显式允许插件工具：
openclaw config set tools.alsoAllow '["group:plugins"]'
6

开始使用工具

您的 OpenClaw 代理现在可以访问所有 66 个 Bright Data 工具。尝试这些示例提示：
搜索网络
使用 brightdata_search 工具搜索"最新 AI 新闻"并返回前 5 个结果。
抓取网页
在 https://example.com 上使用 brightdata_scrape 工具，并用 3 个要点总结页面。
自动化浏览器
使用 brightdata_browser_navigate 打开 https://example.com，然后使用 brightdata_browser_get_text 返回可见的页面文本。
获取结构化数据
使用 brightdata_amazon_product 获取 https://www.amazon.com/dp/B0D2Q9397Y 的详细信息

​
可用工具

​
搜索

工具描述
brightdata_search使用地理定位搜索 Google、Bing 或 Yandex。返回支持分页的结构化结果。
brightdata_search_batch并行运行最多 5 个搜索查询。部分失败会内联返回。
brightdata_search 的参数：
参数类型描述
querystring必需。 搜索查询
engine"google" | "bing" | "yandex"搜索引擎（默认：google）
countnumber要返回的结果数，1-10
cursorstring下一页的分页游标
geo_locationstring2 字母 ISO 国家代码（例如 us、de）

​
抓取

工具描述
brightdata_scrape通过 Web Unlocker 获取任何页面。适用于受机器人保护的站点、JS 渲染页面和地理限制内容。
brightdata_scrape_batch使用相同的提取选项并行抓取最多 5 个 URL。
brightdata_scrape 的参数：
参数类型描述
urlstring必需。 要抓取的 HTTP/HTTPS URL
extractMode"markdown" | "text" | "html"输出格式（默认：markdown）
maxCharsnumber要返回的最大字符数（最小：100）

​
浏览器自动化

完整的 Chromium 浏览器控制，通过 Bright Data 的住宅代理网络路由。会话在 10 分钟后空闲超时。
工具描述
brightdata_browser_navigate使用可选的国家路由导航到 URL
brightdata_browser_snapshot捕获具有交互元素引用的 ARIA 快照
brightdata_browser_click通过快照引用点击元素
brightdata_browser_type通过引用在字段中输入（可选择按 Enter 提交）
brightdata_browser_fill_form在单个操作中填充多个表单字段
brightdata_browser_screenshot拍摄视口或整页截图
brightdata_browser_get_html获取当前页面 HTML
brightdata_browser_get_text获取当前页面文本内容
brightdata_browser_scroll滚动到页面底部
brightdata_browser_scroll_to滚动到由引用指定的特定元素
brightdata_browser_wait_for���待元素变为可见
brightdata_browser_network_requests列出页面加载以来的网络请求
brightdata_browser_go_back后退导航
brightdata_browser_go_forward前进导航

​
结构化网络数据（50+ 平台）

每个工具接受 url 或 keyword 并返回干净的、类型化的 JSON。无需抓取或解析。
工具数据
brightdata_amazon_product产品详情、定价、规格
brightdata_amazon_product_reviews客户评论和评分
brightdata_amazon_product_search搜索结果与排名
brightdata_walmart_product产品详情和可用性
brightdata_walmart_seller卖家资料和指标
brightdata_ebay_product列表详情和竞价
brightdata_homedepot_products产品目录和定价
brightdata_zara_products时尚目录数据
brightdata_etsy_products手工制作和古董列表
brightdata_bestbuy_products电子产品目录和优惠
工具数据
brightdata_linkedin_person_profile完整的个人资料
brightdata_linkedin_company_profile公司概览和统计
brightdata_linkedin_job_listings具有详情的空缺职位
brightdata_linkedin_posts帖子内容和参与度
brightdata_linkedin_people_search人物搜索结果
brightdata_crunchbase_company融资、投资者、创始人
brightdata_zoominfo_company_profile公司情报数据
Instagram
工具数据
brightdata_instagram_profiles资料统计和简介
brightdata_instagram_posts帖子内容和参与度
brightdata_instagram_reels卷轴元数据和浏览
brightdata_instagram_comments评论线程
Facebook
工具数据
brightdata_facebook_posts帖子内容和反应
brightdata_facebook_marketplace_listings市场列表
brightdata_facebook_company_reviews页面评论和评分
brightdata_facebook_events活动详情和参与
TikTok
工具数据
brightdata_tiktok_profiles创作者资料和统计
brightdata_tiktok_posts视频内容和指标
brightdata_tiktok_shopTikTok 商城产品数据
brightdata_tiktok_comments评论线程
X（Twitter）
工具数据
brightdata_x_posts帖子内容和指标
brightdata_x_profile_posts资料帖子历史
YouTube 和 Reddit
工具数据
brightdata_youtube_profiles频道统计和信息
brightdata_youtube_videos视频详情和指标
brightdata_youtube_comments评论线程
brightdata_reddit_posts帖子内容和得分
工具数据
brightdata_google_maps_reviews地点评论和评分
brightdata_google_shopping购物结果和价格
brightdata_google_play_store应用详情和评论
brightdata_apple_app_store应用详情和评论
工具数据
brightdata_yahoo_finance_business公司财务和新闻
brightdata_github_repository_file仓库文件内容
工具数据
brightdata_zillow_properties_listing房产清单和估计
brightdata_booking_hotel_listings酒店列表和定价
工具数据
brightdata_chatgpt_ai_insightsChatGPT 响应
brightdata_grok_ai_insightsGrok 响应
brightdata_perplexity_ai_insightsPerplexity 响应

​
网络搜索提供商集成

该插件也注册为 OpenClaw 网络搜索提供商。要将 Bright Data 设置为您的默认搜索提供商： 
openclaw config set tools.web.search.provider brightdata
设置后，您的代理执行的任何通用网络搜索都将通过 Bright Data 的搜索基础设施路由。

​
配置参考

所有设置都可以通过环境变量或 OpenClaw 配置提供。环境变量优先。
设置环境变量OpenClaw 配置路径默认值
API 密钥BRIGHTDATA_API_TOKENplugins.entries.brightdata.config.webSearch.apiKey必需
基础 URLBRIGHTDATA_BASE_URLplugins.entries.brightdata.config.webSearch.baseUrlhttps://api.brightdata.com
Unlocker 区域BRIGHTDATA_UNLOCKER_ZONEplugins.entries.brightdata.config.webSearch.unlockerZonemcp_unlocker
浏览器区域BRIGHTDATA_BROWSER_ZONEplugins.entries.brightdata.config.webSearch.browserZonemcp_browser
请求超时-plugins.entries.brightdata.config.webSearch.timeoutSeconds30s 搜索 / 60s 抓取
轮询超时-plugins.entries.brightdata.config.webSearch.pollingTimeoutSeconds600s

​
插件管理

# 验证安装和加载的工具
openclaw plugins inspect brightdata

# 更新到最新版本
openclaw plugins update brightdata

# 临时禁用
openclaw plugins disable brightdata

# 重新启用
openclaw plugins enable brightdata

# 卸载
openclaw plugins uninstall brightdata

​
故障排除

安装后找不到插件
  • 运行 openclaw plugins list 以验证插件已安装。
  • 使用 openclaw plugins inspect brightdata 检查插件 ID 是否为 brightdata。
  • 运行 openclaw plugins doctor 获取诊断信息。
工具未注册
  • 确保插件已启用：openclaw plugins enable brightdata。
  • 重启网关：openclaw gateway restart。
身份验证错误
  • 验证您的 API 密钥是否通过环境变量或配置正确设置。
  • 检查密钥是否未在您的 Bright Data 仪表板 中过期。
区域创建失败
  • 该插件在首次使用时��动创建 mcp_unlocker 和 mcp_browser 区域。
  • 如果自动创建失败，请在 Bright Data 仪表板中手动创建区域，并通过环境变量设置它们。

​
其他资源