使用指南 — ecommclaw

01 · 快速开始

注册账号

ecommclaw 采用邀请制注册，每个账号对应一个独立的 AI Agent 工作区，数据完全隔离。

1

访问注册页面

点击右上角「注册」按钮，或直接访问 ecommclaw.com/register。填写邮箱和邀请码完成账号创建。

2

获取 Agent UUID

注册成功后，系统会自动为你创建专属 AI Agent，并分配唯一的 UUID（格式如 ffffffff-ffff-ffff-ffff-ffffffffffff）。请妥善保存，连接插件时需要用到。

注册成功

✅ 账号创建成功

邮箱：your@email.com

Agent 名称：我的电商助手

Agent UUID：

                  ffffffff-ffff-ffff-ffff-ffffffffffff
                

3

选择订阅套餐（可选）

新账号享有 7 天免费试用，体验全部功能。试用期结束后可选择按需付费或月度套餐继续使用。

02 · 快速开始

安装浏览器插件

ecommclaw 以 Chrome 扩展程序的形式运行在你的浏览器中。无需服务器，无需命令行，解压后即可加载使用。

1

下载并解压插件

前往下载页面获取最新版插件压缩包，解压到本地任意目录（建议放在不会被误删的固定位置，如 ~/ecommclaw-extension/）。解压后目录内应包含 manifest.json 文件。

2

开启开发者模式

在 Chrome 地址栏输入 chrome://extensions 并回车，打开扩展程序管理页。点击右上角的「开发者模式」开关将其打开（开启后呈蓝色）。开启后页面左上角会出现三个新按钮。

🔵 chrome://extensions

重新启动即可更新

☰ 扩展程序

开发者模式

加载未打包的扩展程序

打包扩展程序

更新

↑ 开启开发者模式后出现这三个按钮

3

加载未打包的扩展程序

点击页面左上角的「加载未打包的扩展程序」按钮，在弹出的系统文件选择器中，找到并选中第 1 步解压出的插件目录（选目录本身，不是目录内的某个文件），点击「选择」确认。

加载成功后，扩展程序列表中会出现「Rich Browser - OpenClaw」卡片，状态指示灯为绿色，说明插件已正常运行。若卡片右下角显示「错误」红色按钮，点击查看错误详情，通常是目录选择错误（选到了子目录）或文件不完整。

R

Rich Browser - OpenClaw

Browser side panel connected to OpenClaw AI agent

ID：iomgemcoogchphjhpaijckcaofdhakad

检查视图：Service Worker

详情

移除

错误

↺

✅ 加载成功后即出现此卡片，蓝色开关表示插件已启用

4

固定插件到工具栏

点击 Chrome 右上角的拼图图标 🧩，在扩展程序列表中找到「Rich Browser - OpenClaw」，点击右侧的 📌 图钉图标将其固定到工具栏，图钉变为深色表示已固定。

扩展程序 ✕

不需要任何访问权限

这些扩展程序不需要查看和更改此网站上的信息。

1688采购助手插件版 📌 ⋮

OZONBIGSELL - 专注OZ… 📌 ⋮

R

Rich Browser - OpenClaw

📌

⋮

固定

⚙️ 管理扩展程序

↑ 点击红框内的图钉图标完成固定

5

点击图标唤起侧边栏

固定后，工具栏中会出现 Rich Browser - OpenClaw 图标（灰色方块带 R 字样）。点击该图标，浏览器右侧弹出 ecommclaw 侧边栏，顶部显示「● 已连接」即表示插件已与云端 Agent 正常通信，可以开始对话。

侧边栏可随浏览器窗口保持常驻，切换到任意网页后仍可继续与 AI 对话，AI 操控的始终是当前活动标签页。

https://seller.ozon.ru

R

🧩

⋮

🦞

Rich Browser

●已连接

👋 你好！我是你的 AI 电商助手，有什么我可以帮你？

巡店

输入消息…

↑ 点击工具栏 R 图标后，右侧弹出 ecommclaw 侧边栏，顶部绿点表示连接正常

03 · 快速开始

连接与配置

插件安装后需要输入你的 Agent UUID，将本地浏览器与云端 AI Agent 绑定，之后所有对话和操作都通过这条加密通道完成。

1

打开插件设置

点击工具栏中的 🦞 图标，侧边栏弹出后，点击右上角齿轮⚙️进入设置页。

2

填写 Agent UUID

将注册时获得的 UUID 粘贴到「Agent ID」输入框中，点击「连接」。连接成功后状态栏显示绿色 ● 已连接。

⚙️ 插件设置

Agent ID

                  ffffffff-ffff-ffff-ffff-ffffffffffff
                

连接

● 已连接 · 延迟 42ms

3

开始对话

连接成功后，侧边栏下方出现对话输入框。此时可以直接用中文告诉 AI 你想做什么，也可以输入 /help 查看可用命令。

04 · 示例教程

示例：简单功能

以「查询 Ozon 某个商品的当前价格」为例，演示最基础的 AI 交互流程——你说话，AI 打开浏览器取回数据，结果直接呈现在侧边栏。

Rich Browser · 已连接

👤

查一下 Ozon 商品 ID 825463920 现在的价格和库存

🤖

正在调用 ozon-seller API 查询商品信息…

🤖

📦 商品 825463920
名称：USB 充电线 3 合 1
当前价格：￥28.90
可售库存：143 件
状态：销售中

提示对于已有的公共技能（如 ozon-seller），AI 会自动识别意图并调用对应技能，无需你手动指定命令。

05 · 示例教程

示例：多步骤复杂功能

以「多店铺巡检」为例，AI 会在你的浏览器中自动遍历所有店铺页面，采集数据后汇总生成报表——整个过程你无需点击任何按钮。

1

发出指令

在对话框输入触发短语，如「巡店」或「帮我检查所有店铺的运营状态」。

2

AI 自动执行多步骤操作

AI 依次：登录验证 → 获取店铺列表 → 逐家切换店铺 → 采集余额/备货/错误指数 → 汇总分析。你可在侧边栏实时看到进度日志。

[✓] 获取店铺列表：找到 21 家店铺
[→] 处理 кит (3867393) …
余额: 442₽ · 备货: 0 · 错误指数: 0%
[→] 处理 Hong Kong 10 (4440031) …
余额: 5,589₽ · 备货: 1 · 错误指数: 0%
… (共 21 家)
[✓] 报表生成完毕，正在渲染…

3

查看可视化报表

执行完成后，报表自动在浏览器中弹出，以表格形式呈现所有店铺的关键运营指标，支持截图或导出。

06 · 示例教程

示例：带数据库的功能开发

当技能需要持久化存储数据（如历史价格记录、竞品对比），可在 handler.js 中使用内置的 SQLite 支持，数据文件保存在你的私有工作区。

// handler.js — 将采集到的价格写入本地 SQLite
defineSkill(async function(payload) {
  const Database = require('better-sqlite3');
  const dbPath = tenantFs.resolvePath('data/prices.db');
  const db = new Database(dbPath);

  // 建表（首次运行时自动创建）
  db.prepare(`CREATE TABLE IF NOT EXISTS prices (
    product_id TEXT, price REAL, recorded_at INTEGER
  )`).run();

  // 采集价格（浏览器侧）
  const price = await execJs(`
    return { price: parseFloat(document.querySelector('.price').textContent) }
  `);

  // 写入数据库
  db.prepare('INSERT INTO prices VALUES (?, ?, ?)')
    .run(payload.product_id, price.price, Date.now());

  log('价格已记录: ' + price.price);
  return { status: 'success', price: price.price };
});
      

提示数据文件路径相对于你的工作区根目录，框架会自动创建父目录。使用 tenantFs.resolvePath() 获取绝对路径传给 better-sqlite3。

07 · 示例教程

示例：人工参与的交互功能

ecommclaw 支持「Workflow 模式」：AI 先完成数据采集，暂停并弹出交互面板，等你确认关键决策后再执行后续操作——彻底避免 AI 的误操作风险。

1

Phase 1：AI 采集并展示数据

技能自动从各店铺采集待处理订单，生成交互面板弹出到浏览器，等待你的操作。

📋 待处理订单确认

共找到 3 条需要手动确认的订单，请勾选后点击「确认处理」：

订单 #99234561 · 退款申请 · 金额￥156

订单 #99234789 · 取消申请 · 金额￥89（建议拒绝）

确认处理

取消

2

Phase 2：AI 根据你的选择继续执行

你勾选并点击确认后，AI 接收结果，自动完成后续的批量处理操作，并将最终结果写入报表。

提示 Workflow 模式的开发方法见 SKILL_DEVELOPMENT_STANDARD.md 第 9 节，框架内置了完整的状态管理，你只需实现 fetchData、buildHtml、processSubmit 三个函数。

08 · 示例教程

示例：技能开发

私有技能是你专属的自动化模块，存放在你的工作区中，只有你的 Agent 能调用。每个技能由三个文件组成：

📄

handler.js

技能入口文件，用 defineSkill() 包裹业务逻辑，使用 execJs、sendToClient、log 等框架 API。

📋

SKILL.md

技能说明文件，YAML frontmatter 声明 framework_version: 2、触发短语 action_command 等元数据。

🌐

browser.js（可选）

纯浏览器侧辅助函数文件，适合封装无循环的单页数据提取逻辑，不可使用 async/await。

// handler.js — 最小可运行技能
defineSkill(async function(payload) {
  log('开始执行: ' + RUNTIME.skill_id);

  await sendToClient({ action: 'navigate', url: 'https://seller.ozon.ru/app/dashboard' });
  await sleep(6000);

  // ✅ execJs 只收集数据，不在浏览器里解析
  const raw = await execJs(`return { title: document.title }`);

  log('页面标题: ' + raw.title);
  return { status: 'success', data: raw };
});
      

1

告诉 Agent 开发新技能

直接在对话中描述需求，例如：「帮我开发一个技能，采集 Ozon 各店铺的商品数量统计」。Agent 会自动读取开发规范并生成代码。

2

Agent 生成并试运行

代码生成后，Agent 会立即调用 run_tenant_skill 进行试运行，并将完整日志呈现给你确认。

3

更新技能路由表

确认无误后，Agent 运行 generate-skill-routes.sh 更新路由表，之后你只需说触发短语就能直接调用。

09 · 示例教程

示例：技能调用

技能调用无需记忆命令，直接用自然语言触发即可。Agent 会根据路由表自动匹配并调用正确的技能。

对话示例

👤

统计店铺商品数据

🤖

路由匹配：statistics-of-store-product-data
正在执行，请稍候…

👤

巡店

🤖

路由匹配：skill-ozon-seller-shopcheck-homepage
正在为您遍历 21 家店铺…

提示输入 /skills 可查看当前可用的全部技能和触发短语。

10 · 技能中心

技能中心

技能中心分为「公共技能」和「私有技能」两类。公共技能由平台维护，开箱即用；私有技能由你或你的 Agent 自行开发，仅限你的账号使用。

🏪 AI 技能应用商店

🔥

Ozon 爆款挖掘

自动抓取热销排行，结合 1688 比价

公共

🏪

巡店

多店铺运营数据一键巡检

公共

📊

商品统计

各店铺在售/草稿/限额汇总

私有

🖼️

1688 图搜

上传图片自动在 1688 找同款

公共

💰

价格监控

竞品价格变动实时告警

私有

📈

HTML 报表

将数据渲染为可视化报表

公共

👁️

查看私有技能

输入 /skills 或 ls skills/，列出当前工作区所有已安装的私有技能及其触发短语。

✨

生成新技能

直接描述需求，Agent 自动开发、测试、注册技能，无需手动编写代码（除非你希望精细控制实现细节）。

🗑️

删除技能

告诉 Agent「删除技能 XXX」，Agent 会删除对应目录并更新路由表，删除前会向你确认。

11 · 技能中心

针对 Ozon 的店铺管理

ecommclaw 内置一套完整的 Ozon 卖家后台自动化技能，覆盖日常运营的核心场景。所有操作在你已登录的真实浏览器中执行，无需 API 密钥，无需绕过验证。

🏪

多店铺巡检

触发短语：巡店
自动遍历所有店铺，采集余额、备货数量、错误指数、评价/取消申请，生成汇总看板。

📦

商品数量统计

触发短语：统计店铺商品数据
汇总各店铺在售/草稿/错误商品数量及上架总限额和 24h 限额。

🔥

爆款挖掘

触发短语：ozon的{类目}爆款 top5
抓取 Ozon 热销排行，同步在 1688 检索货源，输出完整竞品分析报表。

🔄

店铺切换

触发短语：切换ozon店铺
通过 Cookie 机制无缝切换账号下的任意子店铺，后续操作自动在目标店铺执行。

📊

API 数据查询

触发短语：查询…矩阵的…数据
通过 Ozon Seller API 查询订单、财务、价格、库存等结构化数据，支持自定义过滤条件。

🖼️

1688 图片搜索

触发短语：1688搜图
上传商品图片，AI 自动在 1688 批发平台搜索同款货源，返回报价和供应商列表。

注意 Ozon 相关技能需要你已在浏览器中登录 Ozon 卖家后台（seller.ozon.ru）。AI 不会存储或读取你的账号密码。

12 · 参考

命令列表

在对话框中输入以下命令可控制 Agent 的行为。命令以斜杠 / 开头，区分大小写。

命令	说明
`/new`	开启一个新的对话会话，清除当前上下文，Agent 状态重置为初始状态。
`/status`	查看当前 Agent 运行状态：已连接的浏览器标签、正在执行的技能、内存使用情况。
`/model [模型名]`	切换 AI 大模型。例如 `/model gemini-3-flash-preview`。不带参数则列出可用模型。
`/skills`	列出当前 Agent 可用的所有技能（公共 + 私有），包含触发短语和简要说明。
`/help`	显示帮助信息，列出所有可用命令及简要说明。
`/clear`	清除对话框中的所有消息显示（不影响 Agent 的记忆和会话状态）。
`/logs [taskId]`	查看指定任务的完整执行日志。不带参数则显示最近一次任务的日志。
`/stop`	中断当前正在执行的技能或任务，立即停止浏览器自动化操作。
`/memory`	查看 Agent 的长期记忆内容，包括你偏好的操作方式和历史学习内容。
`/compact`	手动触发对话上下文压缩，在长对话中释放 Token 用量，保留关键信息。

13 · 常见问题

常见问题

找不到答案？使用顶部搜索框或在对话中直接问你的 Agent。

插件显示「连接失败」或「Offline」怎么办？ ▼

检查 UUID 是否填写正确（复制时是否有多余空格）。确认网络可以访问 bot.ecommclaw.com。尝试在插件设置中点击「断开」再「重新连接」。若问题持续，检查浏览器控制台是否有 CORS 或证书错误。

技能执行后没有任何输出，怎么排查？ ▼

输入 /logs 查看最近一次任务的完整执行日志。重点关注 [ERROR] 行。常见原因：页面未登录、元素选择器失效、execJs 超时。日志中会有精确的报错行号。

操作 Ozon 时显示「未登录」？ ▼

请确保你在同一个 Chrome 浏览器中已手动登录 seller.ozon.ru，且登录状态有效（未超时）。插件使用的是你浏览器中现有的登录 Cookie，不会自动登录。

多店铺切换后数据没有更新？ ▼

店铺切换需要等待页面重新加载并确认 headerCompanyName 已更新，通常需要 6-8 秒。如果技能跳过了确认步骤，数据可能来自切换前的店铺。建议在对话中告诉 Agent 重试并查看日志确认切换是否成功。

Agent 报「billing error」或频繁切换模型？ ▼

当某个模型提供商返回计费错误时，Gateway 会自动将该提供商标记为暂时禁用并切换到备用模型。若超过 6 小时仍未恢复，请联系管理员。使用 /model 命令可手动指定使用稳定的模型。

开发私有技能时 node --check 报语法错误？ ▼

node --check handler.js 永远会报 await is only valid in async functions 的假错误，因为框架运行时会将 handler.js 包在 async 函数中，node --check 不知道这一点。请忽略此错误，直接调用 run_tenant_skill 进行试运行。

execJs 返回的属性是 undefined？ ▼

最常见原因是在 execJs 中使用了 return JSON.stringify({...})。这会返回一个字符串，在 Node.js 侧访问 .属性 当然是 undefined。正确写法是直接 return { key: value } 返回对象。

多店铺技能运行到一半就超时了？ ▼

框架的技能超时已设置为 600 秒（10 分钟），足以处理 40+ 家店铺。如果仍然超时，检查日志确认是哪一步卡住了（通常是某个页面加载时间异常长）。可适当增加 sleep 等待时间。