StoreClaw 桌面端将 StoreClaw 从浏览器带到您的电脑上。除了保留 Web 端的主要经营能力，它还可以在获得授权后访问指定的本地工作目录、处理本地文件，并调用电脑中已安装的应用打开任务结果。
您可以使用桌面端完成商品与店铺分析、SEO 分析、内容营销、素材处理和文档生成等电商经营任务，并在个人版与团队版之间切换。
重要提示： StoreClaw 的模型、连接器和任务服务依赖云端。桌面端需要连接网络才能正常使用，目前不支持完全离线运行。
桌面端可以做什么
随时开始经营任务
安装后，StoreClaw 可以常驻在 macOS Dock、Windows 任务栏或系统托盘中。您无需每次打开浏览器并输入网址，即可快速进入 StoreClaw。
在新任务页面中，您可以：
- 输入经营需求并创建任务；
- 上传图片、视频、表格和文档；
- 上传和使用个人 Skill；
- 将任务关联到项目；
- 通过本地麦克风进行语音输入；
- 按需选择一个本地工作目录，让 StoreClaw 处理目录中的文件。
处理本地文件和素材
授权工作目录后，StoreClaw 可以在授权范围内：
- 查看目录结构；
- 搜索文件名或文本内容；
- 读取文本文件；
- 上传目录中的本地文件供任务使用；
- 在获得相应批准后创建、编辑或覆盖文件；
- 使用本地工具打开生成的 PPT、Excel、Word、Markdown 等文件。
这适合需要处理大量商品原图、视频素材、详情页文档、运营报表和数据文件的工作流，也可以减少反复手动上传、下载和查找文件的操作。
管理 StoreClaw 的常用能力
桌面端与 Web 端共用主要业务能力和数据，包括：
- 会话和历史任务；
- 项目；
- 定时任务；
- 插件 -> 技能页面中的「我的 Skill」和「Skill Hub」；
- 插件和连接器；
- 消息渠道；
- 资产库；
- 个人账户与团队设置。
订阅升级、支付、发票、注册和部分第三方授权会在外部浏览器中完成。完成登录、注册或连接器 OAuth 授权后，系统会自动返回 StoreClaw 桌面端的对应页面。
支持的平台
StoreClaw 桌面端计划支持以下平台和处理器架构：
| 操作系统 | 支持的处理器架构 |
|---|---|
| macOS | Apple Silicon、Intel |
| Windows | x64、ARM64 |
具体最低系统版本和可用安装包请以 StoreClaw 下载页面显示的信息为准。
如何下载和安装
- 前往 StoreClaw 下载页面。
- 根据您的操作系统和处理器架构选择正确的安装包。
- 下载完成后打开安装包，按照系统提示完成安装。
- 启动 StoreClaw 桌面端，点击 登录。
- 系统会打开浏览器完成身份验证；验证成功后将自动返回桌面端。
如果您还没有 StoreClaw 账户，请在浏览器中的注册页面完成注册，然后返回桌面端继续使用。
桌面端与 Web 端使用同一个 StoreClaw 账户。退出桌面端只会退出当前桌面应用，不会同时退出 Web 端或其他设备。
如何授权本地工作目录
本地工作目录是您允许 StoreClaw 处理文件的目录。选择目录不是创建任务的必选步骤；只有需要处理本地文件时才需要授权。
添加工作目录
- 在桌面端创建一个新任务。
- 点击输入框旁的 目录添加 按钮。
- 选择 本地目录。
- 在系统文件选择器中选择需要处理的文件夹。
- 阅读权限说明并确认授权。
当前一次只能使用一个活动工作目录。授权对该目录及其全部子目录和文件递归生效。
例如，您授权了 Projects/StoreClaw：
- StoreClaw 可以在授权范围内处理
Projects/StoreClaw及其子目录和文件； - StoreClaw 的内置文件工具不能访问它的父目录
Projects； - StoreClaw 的内置文件工具不能访问同级目录，例如
Projects/AnotherApp。
目录授权范围
选择 始终允许 后，目录授权会保存在 StoreClaw 中。当前会话、其他已有会话和之后创建的新会话均可读取该目录及其子目录，无需再次申请目录读取权限。您可以随时断开目录并撤销持续授权。
如果选择 此会话允许，StoreClaw 在新的会话中需要访问该目录时，会再次请求您的授权。
授权后可以执行哪些操作
授权范围和批准方式会根据操作风险有所不同：
| 操作类型 | 默认处理方式 |
|---|---|
| 列出目录、读取和搜索文件 | 在已授权工作目录内自动执行 |
| 上传已授权目录中的文件 | 在已授权工作目录内自动执行 |
| 创建、编辑或覆盖文件 | 执行前请求批准；部分操作可设置为持续允许 |
| 安全的只读命令 | 在活动工作目录内可自动执行 |
| 危险命令或未知命令 | 每次执行前请求批准 |
| 删除、清空、覆盖等不可撤回操作 | 每次执行前请求批准，不能设为永久允许 |
| 打开本地浏览器执行自动化 | 执行前请求批准 |
批准敏感操作时，您可能会看到 拒绝、仅允许此次操作、允许完成本次请求 或 允许当前任务 等选项。实际可选范围取决于操作类型；不可撤回操作不会提供永久允许选项。有关不同授权范围的说明，请参阅敏感操作确认与授权。
请在批准前检查操作内容： 目录写入权限可能允许 StoreClaw 创建、编辑或删除文件。任务还可能把文件内容提供给您已连接的第三方工具。请勿授权包含无关敏感信息、账号密钥或私人资料的宽泛目录。
工作目录与系统权限的关系
工作目录授权限制的是 StoreClaw 内置文件工具的访问边界。部分任务还可能通过本地 Shell 执行命令；Shell 同时受到以下限制：
- StoreClaw 的命令审批规则；
- 当前活动工作目录；
- macOS 或 Windows 自身的文件与账户权限。
StoreClaw 不会因为您选择了一个工作目录而自动获得更高的系统权限。为降低风险，建议只选择完成当前工作所必需的最小目录，不要直接授权整个用户目录、磁盘根目录或包含多个无关项目的上级目录。
如何撤销目录授权
如果不再希望 StoreClaw 访问某个目录，您可以断开该目录：
- 打开当前任务或工作目录管理入口。
- 找到已连接的目录。
- 点击 断开文件夹 或 断开连接。
- 在确认窗口中再次点击 断开连接。
您也可以前往 设置 → 本地设备，统一查看和管理已授权设备的所有目录，并点击 断开连接 撤销目录授权。
断开后，StoreClaw 将不能再通过该工作目录读取或修改其中的文件。断开目录不会删除电脑中的原文件，也不会删除已保存在 StoreClaw 服务端的会话、任务结果或资产。
本地文件会上传到云端吗
StoreClaw 会优先在本地访问您选择的目录，但这并不代表所有处理都完全离线完成。
出现以下情况时，文件内容或从文件中提取的必要信息可能会发送到 StoreClaw 云端或您主动连接的第三方服务：
- 您把本地文件添加到任务中；
- 任务需要云端模型分析文件内容；
- 您要求 StoreClaw 将文件上传到连接器或第三方工具；
- 任务需要把本地文件与店铺、营销或协作服务结合处理。
在批准涉及敏感文件的操作前，请确认目标文件、任务目的和第三方服务符合您的数据安全要求。
定时任务和系统休眠
您可以在桌面端创建、查看和管理定时任务。为了让依赖本地文件或本地环境的任务按时执行，请确保：
- 电脑保持开机；
- StoreClaw 桌面端保持登录并处于运行状态；
- 网络连接正常；
- 任务所需的工作目录仍处于连接状态；
- 操作系统没有让电脑进入休眠。
关闭窗口后任务还会运行吗
点击窗口右上角或标题栏中的关闭按钮，只会关闭主窗口，StoreClaw 仍会在系统托盘或后台运行。
如果需要完全关闭 StoreClaw，请从系统托盘、菜单栏或应用菜单中选择 退出。完全退出后，依赖本地目录或本地环境的任务将无法继续使用这台电脑。
如何更新桌面端
StoreClaw 会在应用启动时检查更新，并每天进行一次自动检查。您也可以前往 个人中心 → 设置 → 版本 查看当前版本并手动检查更新。
发现新版本后：
- StoreClaw 会下载更新包并提示您更新。
- 按照提示重启应用。
- 新版本将在重启后生效。
如何卸载桌面端
Windows
通过 Windows 的 设置 → 应用 → 已安装的应用 找到 StoreClaw，然后选择 卸载。
macOS
退出 StoreClaw 后，在 应用程序 文件夹中将 StoreClaw 拖到废纸篓。
卸载桌面端不等于注销 StoreClaw 账户，也不会删除 Web 端或服务端保存的会话、项目、定时任务、资产、Skill 和连接器记录。
卸载或清理应用数据时，桌面端的登录 Token、本地缓存和临时文件可能会被移除。您电脑中原有的工作文件不会因为卸载 StoreClaw 而被删除。
多端数据如何同步
StoreClaw 桌面端与 Web 端共用同一套服务端数据。会话、项目、资产、定时任务、Skill 和连接器状态会在应用启动、页面切换、操作完成或手动刷新时同步。
如果两个设备上显示的内容短暂不一致，请先确认网络连接正常，然后刷新页面或重新打开应用。
常见问题
Q：为什么我看不到本地目录功能？
A： 请确认您正在使用 StoreClaw 官方桌面端，而不是浏览器中的 Web 版，并检查应用是否已更新到最新版本。
Q：为什么 StoreClaw 无法读取某个文件？
A： 可能的原因包括：
- 文件不在当前授权的工作目录中；
- 工作目录已经断开；
- 文件被移动、重命名或删除；
- macOS 或 Windows 拒绝了访问权限；
- 文件正在被其他应用占用；
- 当前用户账户没有读取该文件的系统权限。
请重新选择正确的工作目录，并确认文件仍然存在且可由当前系统账户访问。
Q：为什么写入或删除文件时仍然需要确认？
A： 目录授权不等于无限制执行所有操作。创建、覆盖、移动、删除文件以及危险或未知命令可能造成数据丢失，因此 StoreClaw 会根据风险再次请求批准。不可撤回操作不能设为永久允许。
Q：为什么定时任务没有使用我的本地文件？
A： 请确认电脑处于开机和联网状态、StoreClaw 仍在运行、工作目录没有断开，并根据需要开启 保持系统唤醒。
Q：StoreClaw 可以完全离线使用吗？
A： 不可以。StoreClaw 的核心模型、连接器和服务端任务依赖网络。断网时，本地文件仍保留在您的电脑中，但不能正常发起或继续需要云端服务的任务。
Q：桌面端可以直接控制我的整个电脑吗？
A： 当前版本不提供 Computer Use 能力，也不开放用户自定义本地 MCP Server。StoreClaw 主要在您选择的工作目录内处理文件；涉及本地命令、写入、删除或浏览器自动化等敏感操作时，会按照风险请求批准。
Q：连接器为什么会打开外部浏览器？
A： 第三方连接器通常通过 OAuth 在外部浏览器中完成安全授权。授权完成后，系统会自动返回 StoreClaw 桌面端的连接器页面。
Q：桌面端退出后，Web 端为什么仍然保持登录？
A： 桌面端和 Web 端分别维护当前设备的登录状态。退出桌面端只影响当前桌面应用，不会自动退出 Web 端或其他设备。
仍然需要帮助
如果问题仍未解决，请在联系支持团队时提供以下信息：
- StoreClaw 桌面端版本号；
- 操作系统和版本；
- 处理器架构；
- 问题发生时间；
- 错误提示或截图；
- 问题发生前执行的操作。