使用指南
从注册到自定义技能，一步步带你掌握 ecommclaw 的全部能力。
注册账号
ecommclaw 采用邀请制注册，每个账号对应一个独立的 AI Agent 工作区，数据完全隔离。
访问注册页面
点击右上角「注册」按钮，或直接访问 ecommclaw.com/register。填写邮箱和邀请码完成账号创建。
获取 Agent UUID
注册成功后，系统会自动为你创建专属 AI Agent，并分配唯一的 UUID（格式如 ffffffff-ffff-ffff-ffff-ffffffffffff）。请妥善保存，连接插件时需要用到。
选择订阅套餐（可选）
新账号享有 7 天免费试用，体验全部功能。试用期结束后可选择按需付费或月度套餐继续使用。
安装浏览器插件
ecommclaw 以 Chrome 扩展程序的形式运行在你的浏览器中。无需服务器，无需命令行。
点击下方按钮跳转到 Chrome Web Store，点「添加至 Chrome」即可，无需以下手动步骤。安装成功后直接跳到下一节「连接账号」。
🧩 在 Chrome Web Store 安装备用 如果是国内用户、访问 Chrome Web Store 困难，可下载 zip 包手动加载，按下面 5 步操作。两种方法完全等价。
下载并解压插件
前往 下载页面 获取最新版插件压缩包，解压到本地任意目录（建议放在不会被误删的固定位置，如 ~/ecommclaw-extension/）。解压后目录内应包含 manifest.json 文件。
开启开发者模式
在 Chrome 地址栏输入 chrome://extensions 并回车，打开扩展程序管理页。点击右上角的「开发者模式」开关将其打开（开启后呈蓝色）。开启后页面左上角会出现三个新按钮。
加载未打包的扩展程序
点击页面左上角的「加载未打包的扩展程序」按钮，在弹出的系统文件选择器中，找到并选中第 1 步解压出的插件目录（选目录本身，不是目录内的某个文件），点击「选择」确认。
加载成功后，扩展程序列表中会出现「Rich Browser - OpenClaw」卡片，状态指示灯为绿色，说明插件已正常运行。若卡片右下角显示「错误」红色按钮，点击查看错误详情，通常是目录选择错误（选到了子目录）或文件不完整。
固定插件到工具栏
点击 Chrome 右上角的拼图图标 🧩，在扩展程序列表中找到「Rich Browser - OpenClaw」，点击右侧的 📌 图钉图标将其固定到工具栏，图钉变为深色表示已固定。
点击图标唤起侧边栏
固定后，工具栏中会出现 Rich Browser - OpenClaw 图标（灰色方块带 R 字样）。点击该图标，浏览器右侧弹出 ecommclaw 侧边栏，顶部显示「● 已连接」即表示插件已与云端 Agent 正常通信，可以开始对话。
侧边栏可随浏览器窗口保持常驻，切换到任意网页后仍可继续与 AI 对话，AI 操控的始终是当前活动标签页。
连接与配置
插件安装后需要输入你的 Agent UUID，将本地浏览器与云端 AI Agent 绑定，之后所有对话和操作都通过这条加密通道完成。
打开插件设置
点击工具栏中的 🦞 图标，侧边栏弹出后，点击右上角齿轮⚙️进入设置页。
填写 Agent UUID
将注册时获得的 UUID 粘贴到「Agent ID」输入框中，点击「连接」。连接成功后状态栏显示绿色 ● 已连接。
开始对话
连接成功后，侧边栏下方出现对话输入框。此时可以直接用中文告诉 AI 你想做什么，也可以输入 /help 查看可用命令。
示例：1688 以图搜货
以「1688 搜图找货源」为例，演示如何通过粘贴商品图片 + 一句话指令，让 AI 自动在 1688 上以图搜索匹配供应商和同款商品。
准备商品图片
从任意电商网站（如 Ozon、速卖通、拼多多等）截取你感兴趣的商品图片，或从本地磁盘选择已保存的图片。支持同时上传多张图片，AI 会逐一搜索。
粘贴图片到插件对话框
点击插件侧边栏的对话输入框，将图片直接粘贴（Ctrl+V / Cmd+V）或点击上传按钮选择图片。图片会显示为缩略图预览。
输入触发指令，等待结果
在对话框中输入 1688 搜图 并发送。AI 会自动：上传图片到 1688 → 执行以图搜索 → 提取匹配商品信息 → 生成对比分析报表。
查看搜图报表
执行完成后，报表自动在浏览器中弹出，展示每张图片匹配到的 1688 供应商商品列表，包含价格、销量、供应商信息等，方便快速比价选品。
完整演示视频：
提示 输入「1688 搜图」即可触发该技能。支持同时粘贴多张图片，AI 会逐一搜索并汇总到同一份报表中。
示例：多步骤复杂功能
以「多店铺巡检」为例，AI 会在你的浏览器中自动遍历所有店铺页面，采集数据后汇总生成报表——整个过程你无需点击任何按钮。
发出指令
在对话框输入触发短语，如「巡店」或「帮我检查所有店铺的运营状态」。
AI 自动执行多步骤操作
AI 依次：登录验证 → 获取店铺列表 → 逐家切换店铺 → 采集余额/备货/错误指数 → 汇总分析。你可在侧边栏实时看到进度日志。
查看可视化报表
执行完成后，报表自动在浏览器中弹出，以表格形式呈现所有店铺的关键运营指标，支持截图或导出。
巡查看板报告示例：
完整演示视频（店铺名称已隐去）：
示例：带数据库的功能开发
当技能需要持久化存储数据（如历史价格记录、竞品对比），可在 handler.js 中使用内置的 SQLite 支持，数据文件保存在你的私有工作区。
提示
数据文件路径相对于你的工作区根目录，框架会自动创建父目录。使用 tenantFs.resolvePath() 获取绝对路径传给 better-sqlite3。
示例：人工参与的交互功能
以「看今天爆款」为例，AI 先在云端把当日 Ozon 平台的爆款 SKU 候选清单整理好，再把交互面板推到你的浏览器侧边栏，由你勾选感兴趣的款，AI 接着自动跑后续的 1688 找货流水线——关键决策权始终在你手上，AI 只做重复劳动。
Phase 1：AI 拉取当日爆款候选
云端每天凌晨自动跑 Ozon 爆款挖掘流水线（按销量、增速、新晋、类目龙头等多种策略），输出当日候选清单。你只要在对话框输入「看今天爆款」，AI 即刻把这份清单加载到侧边栏，每个候选附中俄文商品名、缩略图、价格、销量信号、类目。
Phase 2：你勾选关心的 SKU 并提交
这一步是整条流水线唯一需要"人脑"的环节——选不选、选哪些，由你的选品经验决定。提交后，所选 SKU 会落到本次任务目录，作为下一步 1688 图搜的输入。
Phase 3：AI 接力跑完 1688 找货
AI 自动下载所选 SKU 的主图，逐张到 1688 走图搜，把每个款匹配到的供应商列表（价格、起订量、销量、供应商等级）汇总成报表，再次弹回浏览器供你二次决策——挑供应商、定价、上架。
完整演示视频：
提示 对话框输入「看今天爆款」即可触发；如需查看历史某天，告诉 AI 日期即可（如「看 5 月 3 日的爆款」）。整条流水线把你的精力锁在"选品"这一步，前后两端的搜数据、找供应商都交给 AI。
示例：技能开发
私有技能是你专属的自动化模块，存放在你的工作区中，只有你的 Agent 能调用。每个技能由三个文件组成：
handler.js
技能入口文件，用 defineSkill() 包裹业务逻辑，使用 execJs、sendToClient、log 等框架 API。
SKILL.md
技能说明文件，YAML frontmatter 声明 framework_version: 2、触发短语 action_command 等元数据。
browser.js（可选）
纯浏览器侧辅助函数文件，适合封装无循环的单页数据提取逻辑，不可使用 async/await。
告诉 Agent 开发新技能
直接在对话中描述需求，例如：「帮我开发一个技能，采集 Ozon 各店铺的商品数量统计」。Agent 会自动读取开发规范并生成代码。
Agent 生成并试运行
代码生成后，Agent 会立即调用 run_tenant_skill 进行试运行，并将完整日志呈现给你确认。
更新技能路由表
确认无误后，Agent 运行 generate-skill-routes.sh 更新路由表，之后你只需说触发短语就能直接调用。
示例：技能调用
技能调用无需记忆命令，直接用自然语言触发即可。Agent 会根据路由表自动匹配并调用正确的技能。
statistics-of-store-product-data正在执行，请稍候…
skill-ozon-seller-shopcheck-homepage正在为您遍历 21 家店铺…
提示
输入 /skills 可查看当前可用的全部技能和触发短语。
示例：电商图片处理
把"拍商品图—P 背景—合成模特—批量出图"这一整条流水线压成对话框里的一句话。AI 调用你挂载的图像模型，按你的要求出图，全程在浏览器侧边栏可见。
自定义图像模型
侧边栏「自定义 AI 模型」里挂任意符合 OpenAI / Gemini API 协议的图像模型——Gemini 3.1 Flash Image、GPT-image-2、国产模型都行，运行时按需切换。
展示图自动生成
上传商品原图 + 一句话描述（"国风高级感"、"户外阳光"、"极简白底"），AI 直接产出可上架的成品图，不必再去抠图、调色、加字。
批量处理
给一组 SKU 或一个图片文件夹，AI 按统一 prompt 逐张处理并落盘，期间在侧边栏可见每张的实时进度。
挂载你自己的图像模型
设置 → 自定义 AI 模型，把 API 地址和密钥填进去，AI 出图时即可在多个模型间挑选：
案例 1：一张原图 → 任意风格电商展示图
告诉 AI 你想要的风格（"国风、淡墨山水、字标题"等），它会从一张普通商品照生成构图完整、可直接上架的展示图。
完整演示视频：
案例 2：两张原图 + 提示词 → 模特展示图
没有现成模特实拍？把人物图和产品图同时丢给 AI，加一句话提示词（"让她拿着这个手包逛美术馆"），自动合成。
完整演示视频：
提示
批量处理只需把 SKU 列表或图片文件夹丢给 AI 并指定统一 prompt，处理过程中可在侧边栏看到逐张进度，结果会落到 tasks/<id>/output/ 目录可直接下载。
技能中心
技能中心分为「公共技能」和「私有技能」两类。公共技能由平台维护，开箱即用；私有技能由你或你的 Agent 自行开发，仅限你的账号使用。
查看私有技能
输入 /skills 或 ls skills/，列出当前工作区所有已安装的私有技能及其触发短语。
生成新技能
直接描述需求，Agent 自动开发、测试、注册技能，无需手动编写代码（除非你希望精细控制实现细节）。
删除技能
告诉 Agent「删除技能 XXX」，Agent 会删除对应目录并更新路由表，删除前会向你确认。
针对 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 不会存储或读取你的账号密码。
命令列表
在对话框中输入以下命令可控制 Agent 的行为。命令以斜杠 / 开头，区分大小写。
| 命令 | 说明 |
|---|---|
/new |
开启一个新的对话会话，清除当前上下文，Agent 状态重置为初始状态。 |
/status |
查看当前 Agent 运行状态：已连接的浏览器标签、正在执行的技能、内存使用情况。 |
/model [模型名] |
切换 AI 大模型。例如 /model gemini-3-flash-preview。不带参数则列出可用模型。 |
/skills |
列出当前 Agent 可用的所有技能（公共 + 私有），包含触发短语和简要说明。 |
/help |
显示帮助信息，列出所有可用命令及简要说明。 |
/clear |
清除对话框中的所有消息显示（不影响 Agent 的记忆和会话状态）。 |
/logs [taskId] |
查看指定任务的完整执行日志。不带参数则显示最近一次任务的日志。 |
/stop |
中断当前正在执行的技能或任务，立即停止浏览器自动化操作。 |
/memory |
查看 Agent 的长期记忆内容，包括你偏好的操作方式和历史学习内容。 |
/compact |
手动触发对话上下文压缩，在长对话中释放 Token 用量，保留关键信息。 |
常见问题
找不到答案？使用顶部搜索框或在对话中直接问你的 Agent。
/logs 查看最近一次任务的完整执行日志。重点关注 [ERROR] 行。常见原因：页面未登录、元素选择器失效、execJs 超时。日志中会有精确的报错行号。
/model 命令可手动指定使用稳定的模型。
node --check handler.js 永远会报 await is only valid in async functions 的假错误，因为框架运行时会将 handler.js 包在 async 函数中，node --check 不知道这一点。请忽略此错误，直接调用 run_tenant_skill 进行试运行。
return JSON.stringify({...})。这会返回一个字符串，在 Node.js 侧访问 .属性 当然是 undefined。正确写法是直接 return { key: value } 返回对象。
sleep 等待时间。