The StoreClaw Chrome extension connects StoreClaw with your local Chrome browser. After the connection is set up, StoreClaw can open web pages, read page content, and help complete tasks that depend on a real browser environment.

This is useful when a task needs your current login session, a dynamic web page, access to an ecommerce admin, or your help with login and CAPTCHA verification.

Currently, only the local Chrome browser is supported. Cloud browser, Edge, and Safari support will be available in future releases.

Common Use Cases

  • Extract Web Page Information: Extract real-time content from competitor pages, product detail pages, search result pages, or admin reports.
  • Assist With Admin Operations: With your authorization and instructions, StoreClaw can enter an ecommerce admin and help search, fill in, or click through pages.
  • Handle Dynamic Pages: Access pages that must be opened in a real browser, such as pages that require login, dynamic loading, or human verification.

Before You Start

Make sure your device and browser meet the following requirements:

Item Requirement
Operating System macOS or Windows
Browser Chrome
Chrome Version Chrome 100 or later recommended

We recommend using the latest stable version of Chrome for better compatibility and security.

Install the Extension

Get the Extension Package

  1. Log in to StoreClaw.
  2. Click your avatar in the lower-left corner and go to Settings.
  3. On the settings page, click Browser.
  4. On the Chrome card, click Connect.
  5. In the installation guide, click Next.
  6. Click Download the Package to download the extension package to your local device.
  7. Unzip the downloaded package.

Step 1: Open the Chrome Extensions Page

  1. Open Chrome.
  2. Enter chrome://extensions in the address bar and press Enter.

Step 2: Turn On Developer Mode

On the Chrome extensions page:

  1. Find the Developer Mode switch in the upper-right corner.
  2. Turn it on.

The StoreClaw Chrome extension is currently installed from a local package and has not yet been published on the Chrome Web Store. Because of this, developer mode must be enabled before installation.

Step 3: Install the Extension

  1. Drag the Storeclaw-AI-Browser-Operator folder into the chrome://extensions page.
  2. When Chrome shows the installation confirmation window, click Add Extension.
  3. After installation, StoreClaw AI Browser Operator will appear in the extension list.

Verify the Connection Status

Before the extension is installed, the Chrome card on the StoreClaw browser page usually shows Browser extension not detected and a Connect button.

After installation, go back to StoreClaw -> Settings -> Browser and refresh the page. StoreClaw will automatically detect the extension status and complete the pairing. You do not need to enter any additional parameters manually.

Browser Page: Connected

You can confirm the connection in the following ways:

  • StoreClaw Browser Page: The Chrome row shows Connected.
  • Chrome Toolbar: The StoreClaw extension icon appears in the upper-right corner.
  • Chat Test: Send an instruction that requires web actions in Chat. StoreClaw should be able to call your local browser to complete the task.

What You Can Do After Connecting

After the connection is successful, StoreClaw can use your local browser in tasks that you actively start, such as:

  • Open a specific web page and extract page content
  • Enter your store admin to find orders, products, or reports
  • Click, scroll, or switch tabs on dynamic pages
  • Access related pages using the current login session in your browser
  • Continue a task after you manually complete login or human verification

Example instructions:

  • Open this competitor product page and extract the title, price, review count, and key selling points
  • After I log in to Shopify admin, check whether there are any new high-risk orders today
  • Open the Amazon search results page and summarize the price range and review count of the top 10 competitors

Permissions and Security

The StoreClaw Chrome extension is used only for browser tasks that you actively start. After the connection is set up, StoreClaw does not continuously access your browser or operate web pages without a triggered task.

When a browser task is running, please note:

  • The extension may read page content related to the current task.
  • If a page is already logged in, StoreClaw may access that page using the current login session.
  • For sensitive actions such as account login, payment, or form submission, we recommend reviewing the task before it runs.
  • If a CAPTCHA or human verification appears, you need to complete it manually in your local browser.

How It Works With Other Features

Chat

Local browser actions are usually started from Chat. You can describe the target page and task in natural language, and StoreClaw will call the Chrome extension when needed.

Skills

Some Skills may need to access web pages or admin pages during execution. When a task depends on a real browser environment, the skill may call Browser capabilities to complete the required steps.

Scheduled Tasks

Scheduled Tasks run in the cloud by default. Tasks that depend on your local Chrome browser require your device, Chrome, and the extension to remain available. Because of this, they are not suitable for fully unattended cloud-based scheduled tasks.

FAQ

Q: After installing the extension and refreshing the page, it still does not show “Connected”. What should I do?

A: Check the following items in order:

  • Make sure Chrome is still running.
  • Open chrome://extensions and confirm that StoreClaw AI Browser Operator is installed.
  • Make sure the extension switch is turned on.
  • Go back to StoreClaw → Settings → Browser, refresh the page, and wait a few seconds.
  • If you use multiple Chrome profiles, make sure the extension is installed in the same Chrome profile where you are logged in to StoreClaw.

Q: Chrome says “Apps, extensions, and user scripts cannot be added from this website” when I drag the Storeclaw-AI-Browser-Operator folder. What should I do?**

A: This usually happens because Developer Mode is not turned on. Open chrome://extensions, turn on Developer Mode in the upper-right corner, and then drag the extension folder again to install it.

Q: Chrome says this extension may affect browser security. Is this normal?

A: Yes. This is a standard Chrome warning for extensions installed outside the Chrome Web Store. The StoreClaw Chrome extension only performs browser actions when you actively start a task or when a clearly triggered skill needs to use Browser capabilities.

Q: Will StoreClaw keep accessing my browser after it is connected?

A: No. StoreClaw only operates your local browser when you send an instruction or when a clearly triggered task needs to use Browser capabilities.

Q: Can I use multiple Chrome windows at the same time?

A: Yes. To reduce interruptions during task execution, we recommend keeping the target web page open and avoiding closing Chrome or switching to unrelated pages while the task is running.

Q: When will Edge and Safari be supported?

A: Edge and Safari support is still being planned. If the page shows Coming Soon, it means support for that browser is not available yet.

Notes

  • Do not close Chrome while a task is running, or the current browser task may be interrupted.
  • If multiple Chrome windows are open, keep the target window open so you can observe the task progress.
  • If the page requires login, authorization, or human verification, complete it manually in your local browser.
  • The current version is still in Beta. If you encounter unexpected behavior, go to Settings -> Get Help to send feedback.

StoreClaw Chrome 插件用于连接 StoreClaw 与您的本地 Chrome 浏览器。连接完成后，StoreClaw 可以在您主动发起的任务中打开网页、读取页面内容，并协助完成依赖真实浏览器环境的操作。

这适用于需要使用当前登录状态、处理动态网页、进入电商后台，或在必要时由您配合完成登录和人机验证的场景。

当前仅支持本地 Chrome 浏览器。云端浏览器以及 Edge、Safari 支持将在后续版本推出。

典型使用场景

  • 抓取网页信息：提取竞品页面、产品详情页、搜索结果页或后台报表中的实时内容。
  • 辅助完成后台操作：在您的授权和指令下，进入电商后台完成查找、填写、点击等操作。
  • 处理动态页面：访问必须在真实浏览器中打开的页面，例如需要登录、动态加载或人机验证的页面。

使用前准备

请先确认您的设备和浏览器满足以下要求：

项目 要求
操作系统 macOS 或 Windows
浏览器 Chrome
Chrome 版本 建议使用 Chrome 100 或以上版本

建议使用最新稳定版 Chrome，以获得更好的兼容性和安全性。

安装插件

获取插件安装包

  1. 登录 StoreClaw。
  2. 点击左下角头像，进入 设置。
  3. 在设置页面中，点击 浏览器。
  4. 在 Chrome 卡片中点击 连接。
  5. 在弹出的安装引导中点击 下一步。
  6. 点击 下载安装包，将插件安装包下载到本地。
  7. 解压下载的压缩包。

第一步：打开 Chrome 扩展页面

  1. 打开 Chrome 浏览器。
  2. 在地址栏输入 chrome://extensions 并回车。

第二步：开启开发者模式

进入 Chrome 扩展页面后：

  1. 找到页面右上角的 Developer mode（开发者模式） 开关。
  2. 将开关切换为开启状态。

当前 StoreClaw Chrome 插件通过本地安装包安装，尚未上架 Chrome Web Store，因此需要先开启开发者模式。

第三步：安装插件

  1. 将解压后得到的 Storeclaw-AI-Browser-Operator 文件夹整体拖拽到 chrome://extensions 页面。
  2. 当 Chrome 弹出安装确认窗口时，点击 添加扩展程序。
  3. 安装完成后，扩展列表中会出现 StoreClaw AI Browser Operator。

验证连接状态

插件安装前，StoreClaw 的浏览器页面中，Chrome 卡片通常会显示 未检测到浏览器插件 或 连接 按钮。

安装完成后，回到 StoreClaw -> 设置 -> 浏览器 页面并刷新。StoreClaw 会自动检测插件状态并完成配对，无需手动输入额外参数。

Browser 页面：已连接状态

您可以通过以下方式确认连接是否成功：

  • StoreClaw 浏览器页面：Chrome 一行显示为 已连接。
  • Chrome 工具栏：右上角出现 StoreClaw 插件图标。
  • 会话测试：在会话中发送一条需要网页操作的指令，StoreClaw 可以调用本地浏览器执行任务。

连接后可以做什么

连接成功后，StoreClaw 可以在您主动发起的任务中调用本地浏览器能力，例如：

  • 打开指定网页并提取页面内容
  • 进入店铺后台查找订单、产品或报表信息
  • 在动态页面中完成点击、滚动、切换标签页等操作
  • 使用当前浏览器中的登录状态访问相关页面
  • 在需要登录或人机验证时，由您手动完成验证后继续执行任务

常见示例指令：

  • 打开这个竞品详情页，帮我提取标题、价格、评论数和主要卖点
  • 登录后进入 Shopify 后台，帮我看看今天有没有新的高风险订单
  • 打开 Amazon 搜索结果页，整理前 10 个竞品的价格区间和评论量

权限与安全说明

StoreClaw Chrome 插件仅用于执行您主动发起的浏览器任务。连接成功后，StoreClaw 不会持续访问您的浏览器，也不会在未触发任务的情况下主动操作网页。

在执行浏览器任务时，请注意：

  • 插件可能会读取当前任务相关网页的页面内容。
  • 如果页面已登录，StoreClaw 可能会基于当前登录状态访问该页面。
  • 涉及账号登录、付款、提交表单等敏感操作时，建议您在执行前确认任务内容。
  • 如任务过程中出现验证码或人机验证，请由您在本地浏览器中手动完成。

与其他功能的关系

与会话配合

本地浏览器操作通常从会话中发起。您可以直接用自然语言描述目标页面和任务，StoreClaw 会在需要时调用 Chrome 插件执行。

与技能配合

某些技能在执行过程中可能需要访问网页或后台页面。当任务依赖真实浏览器环境时，技能会调用 Browser 能力完成相关步骤。

与定时任务的区别

定时任务默认在云端执行。依赖本地 Chrome 的操作需要您的设备、Chrome 浏览器和插件保持可用，因此不适合作为完全无人值守的云端定时任务直接运行。

常见问题

Q: 安装插件后刷新页面，仍然没有显示“已连接”怎么办？

A: 请按以下顺序检查：

  1. 确认 Chrome 浏览器仍在运行。
  2. 打开 chrome://extensions，确认 StoreClaw AI Browser Operator 已安装。
  3. 确认插件开关处于开启状态。
  4. 回到 StoreClaw -> 设置 -> 浏览器 页面，刷新页面并等待几秒。
  5. 如果您使用了多个 Chrome 用户配置，请确认插件安装在当前登录 StoreClaw 的同一个 Chrome 用户配置中。

Q: 拖拽插件文件所在的文件夹时，Chrome 提示“无法添加来自此网站的应用”怎么办？

A: 通常是因为没有开启 Developer mode（开发者模式）。请先进入 chrome://extensions 页面，开启右上角的开发者模式，然后重新拖拽插件文件夹安装。

Q: Chrome 提示“此扩展程序可能会降低 Chrome 的安全性”，正常吗？

A: 正常。这是 Chrome 对非 Chrome Web Store 安装扩展的通用提示。 StoreClaw Chrome 插件仅在您主动发起任务，或某个明确触发的技能需要调用 Browser 能力时执行浏览器操作。

Q: 连接后，StoreClaw 会一直访问我的浏览器吗？

A: 不会。StoreClaw 只会在您主动发送指令，或明确触发的任务需要调用 Browser 能力时，才会操作本地浏览器。

Q: 可以同时使用多个 Chrome 窗口吗？

A: 可以。但为了减少任务执行中断，建议将目标网页所在的窗口保持打开，并避免在任务执行期间关闭 Chrome 或切换到无关页面。

Q: Edge 和 Safari 支持什么时候上线？

A: 当前 Edge 和 Safari 支持仍在规划中。如果页面显示为 Coming Soon，表示相关浏览器支持尚未开放。

注意事项

  • 执行任务期间，请不要关闭 Chrome，否则当前浏览器任务可能中断。
  • 如果同时打开多个 Chrome 窗口，建议将目标网页所在窗口保持打开，方便观察执行过程。
  • 如果页面需要登录、授权或人机验证，请在本地浏览器中手动完成。
  • 当前版本仍处于 Beta 阶段。如遇异常行为，可通过 设置 -> 获取帮助 反馈。