PTBrowser 浏览器环境管理器

安装指南

1. ClawHub CLI 从源直接安装技能的最快方式。
   npx clawhub@latest install ptbrowser-mcp
2. 手动安装 将技能文件夹复制到以下位置之一
   全局模式
   ~/.openclaw/skills/
   工作区
   /skills/
   优先级：工作区 > 本地 > 内置
3. 提示词安装 将此提示词复制到 OpenClaw 即可自动安装。
   请帮我使用 Clawhub 安装 ptbrowser-mcp。如果尚未安装 Clawhub，请先安装（npm i -g clawhub）。
   更倾向于下载？
   获取包含原生技能文件的ZIP压缩包。
   下载技能 (.zip)

什么是

PTBrowser MCP 是一项 Openclaw Skills 集成，用于管理 PTBrowser Windows 客户端拥有的浏览器环境。它让 AI 编码代理能够通过客户端的本地 MCP 接口操作独立的 Chromium 配置文件、环境、分组、代理、扩展程序和回收站。
该技能提供操作指导；实际操作由 PTBrowser 执行。它专为配置文件和环境管理而设计，不用于自动执行第三方网站上的登录、发布商品或其他操作。其先读取再更改、确认并在操作后验证的工作流，有助于减少管理浏览器状态时的错误。

应用场景

在管理配置文件前，检查 PTBrowser 客户端是否已通过身份验证。
列出配置文件、环境、分组、代理、扩展程序或回收站条目，并检查其当前 ID 和状态。
查看目标并在需要时取得用户授权后，创建、更新、启动或关闭浏览器环境。
归档或恢复条目；永久删除前仔细核对回收站 ID。
管理多个配置文件时，提交结构化的批量环境创建请求，每次请求最多 100 行。
通过检查当前状态来诊断超时后再重试，尤其是在批量创建之后。

工作原理

按照技能中 references/setup.md 的说明配置 PTBrowser stdio MCP 连接；确认 tools/list 返回的工具名称带有 ptb_ 前缀。
调用 ptb_auth_status，确认 Windows PTBrowser 客户端已登录。如果应用已锁定，请让用户在客户端中解锁。
使用相关的 *_list 工具，在选择操作前获取真实 ID 和当前状态。请从实时 MCP tools/list 响应中获取工具名称和输入架构，不要猜测字段。
对于会更改状态的操作，说明目标和预期效果，取得用户授权，然后在需要时传入 confirm=true。更改环境配置需要提供完整配置并设置 riskAcknowledged=true。
通过相应的 PTBrowser 工具提交操作。批量创建时，通过 ptb_environment_batch_create 的 rows 参数提供结构化数据，每次请求最多 100 行。
再次读取相关状态以验证结果。如果请求超时，请在重试前检查列表，以避免重复操作；启动环境也可能受套餐限制、代理检查和多设备租用限制影响。

配置指南

安装或启用 PTBrowser Windows 客户端，并使用将运行 MCP 连接的 Windows 用户账户登录。
按照技能中的 references/setup.md 配置客户端的本地 stdio MCP 服务。提供的 SKILL.md 未指定命令行安装流程或固定连接配置，因此请参考设置文档和客户端提供的设置，不要自行编造命令。
将 AI 代理连接到本地 MCP 服务并调用 tools/list。确认可用工具使用 ptb_ 前缀。
更改任何内容前调用 ptb_auth_status。如果应用已锁定，请让用户直接在 PTBrowser 中解锁。
安全提示：客户端使用本地随机令牌桥接。不要读取或分享会话文件中的令牌。通过 tools/list 动态发现工具名称和输入架构。更新配置时，请先读取当前环境值，并提供完整配置，同时设置 riskAcknowledged=true。
PTBrowser 浏览器环境管理器 数据架构与分类体系
PTBrowser 通过其实时 MCP 接口提供操作数据和工具架构；该技能不定义单独的数据库、生成文件格式或静态元数据分类体系。
数据或接口 处理方式
MCP 工具 运行时通过 tools/list 发现；PTBrowser 工具以 ptb_ 为前缀。
ID 和状态 更改前使用相关的 *_list 工具获取；请使用实际返回的 ID，不要推测标识符。
环境配置 编辑前读取当前值；更新时需要提供完整配置并设置 riskAcknowledged=true。
批量创建 使用 ptb_environment_batch_create 的 rows 参数提交结构化行数据；每次请求最多 100 行。
回收站 请求永久删除前，核实准确的回收站条目 ID；支持归档和恢复工作流。
身份验证 使用本地客户端桥接；不要访问或分发会话文件令牌。

高级特性

通过本地 MCP 客户端管理独立的 Chromium 配置文件及相关 PTBrowser 环境、分组、代理和扩展程序。
动态发现工具名称、说明和输入架构，而不是依赖硬编码或假定的字段。
每次请求最多以 100 行的结构化批次创建环境。
对状态更改使用明确的确认控制；更新环境配置时要求进行风险确认。
使用先读取再重试的工作流安全处理超时并防止重复提交。
操作后验证最终状态，同时考虑套餐配额、代理检查和多设备租用限制。
将集成范围限定于 PTBrowser 管理；它不会执行第三方网页自动化。

name: ptbrowser-mcp description: "PTBrowser 浏览器环境管理 AI Skill。通过已登录 Windows 客户端的本机 MCP 管理独立 Chromium profiles、环境、分组、代理、扩展和回收区。Use for PTBrowser profile and browser environment management; not third-party webpage automation." license: MIT-0

PTBrowser 浏览器环境管理 · Chromium Profiles MCP

本 skill 连接当前 Windows 用户已登录的 PTBrowser 客户端。先按 连接说明 配置 stdio MCP 服务；tools/list 应返回 ptb_ 开头的工具。Skill 只是操作说明，实际动作由客户端执行。

使用方法
调用 ptb_auth_status，确认客户端已登录；若应用锁已开启，请用户在客户端解锁。
先用对应的 *_list 工具读取真实 ID 与当前状态，再执行创建、修改、启动、关闭、归档或恢复。
变更状态的工具在展示目标和效果并获得用户授权后传 confirm=true；永久删除尤其要核对回收区条目 ID。
调用后重新读取状态，确认最终结果。启动环境可能受套餐额度、代理检查和多设备租约限制。

若创建或修改请求超时，先用列表工具核对实际状态，不要立即重复提交，尤其是批量创建。

工具名、入参 schema 和说明由客户端的 MCP tools/list 实时提供，勿推测字段。环境配置修改需提供完整配置和 riskAcknowledged=true，可先读取环境当前值。批量创建通过 ptb_environment_batch_create 的 rows 参数提交结构化数据，每次最多 100 个。

客户端使用本机随机令牌桥接，不要读取或分享会话文件中的 token。ptb_ 工具管理 PTBrowser 自身的环境与配置；不会代替用户在第三方网站执行登录、上架或批量网页操作。

PTMail 邮件管理 MCP
Qique 员工 AI 助手