m5stack-chrome-browser-control — M5Stack Chrome 浏览器控制

M5Stack | Chrome 浏览器控制 Skill 通过 MCP 协议远程控制用户本地 Chrome 浏览器，完成网页访问、Outlook 邮件查看、内容搜索等自动化任务。

一、用户需要做的准备工作 第一步：在 Chrome 中开启远程调试 打开 Chrome 浏览器（普通版 Chrome，不是 Chrome Beta） 在地址栏访问：chrome://inspect/#devices 在页面顶部找到 "Remote debugging" 开关，点击开启 确认页面显示："Server running at: 127.0.0.1:9222" 每次重启 Chrome 后需要重新开启此开关。

第二步：配置 OpenClaw MCP 编辑 ~/.openclaw/openclaw.json（Windows 下为 C:\Users\<用户名>\.openclaw\openclaw.json）。 只在已有 JSON 对象中新增 mcp 字段，绝对不要修改或删除文件中其他已有字段（如 plugins、gateway 等），否则 OpenClaw 将无法启动。 { "（其他已有字段保持不变）": "...", "mcp": { "servers": { "chrome-devtools": { "command": "npx", "args": [ "chrome-devtools-mcp@latest", "--autoConnect" ] } } } } 严禁： 不能加 --channel=beta（会寻找 Chrome Beta 安装路径，必然失败） 不能覆盖整个文件，只能新增 mcp 字段 修改前建议备份原文件 配置完成后在终端运行 openclaw gateway restart 重启网关使配置生效。

二、MCP 工具说明 所有工具均来自 chrome-devtools-mcp，通过 chrome-devtools__* 前缀调用。 chrome-devtools__list_pages 列出当前浏览器所有打开的标签页，返回每个页面的 pageId 和 URL。 用途：确认 MCP 是否连接成功；查找已登录的目标标签页 成功标志：返回页面列表 失败标志：Could not find DevToolsActivePort → 用户未开启调试模式 chrome-devtools__select_page(pageId) 切换到指定标签页，后续操作将作用于该页面。 用途：当浏览器有多个标签时，切换到目标标签（如已登录的 Outlook 或 X） chrome-devtools__new_page(url) 新建标签页并导航到指定 URL。 用途：打开一个全新页面 chrome-devtools__navigate_page(type, url) 在当前选中标签页中导航到指定 URL。 type="url" → 跳转到新地址 type="reload" → 刷新当前页 用途：在已登录的标签页内跳转到目标页面（避免登录状态丢失） chrome-devtools__take_snapshot() 获取当前页面的无障碍树（a11y tree），返回所有可见元素及其 uid。 用途：读取页面内容（邮件列表、推文、正文等）；获取可交互元素的 uid 供后续点击/输入使用 注意：页面加载中时需等待后再调用 chrome-devtools__click(uid) 点击页面中指定 uid 的元素。 用途：打开邮件、点击按钮、展开折叠内容 chrome-devtools__fill(uid, value) 向指定 uid 的输入框填入文本。 用途：填写搜索框、表单输入 chrome-devtools__wait_for(text) 等待页面出现指定文本后再继续。 用途：等待页面加载完成，避免在未加载时读取空内容 chrome-devtools__take_screenshot() 截取当前页面截图（返回图片）。 用途：当 snapshot 无法准确反映页面状态时，用截图辅助判断

三、常见任务流程 查看 Outlook 邮件（支持任意 Outlook 账号）

• chrome-devtools__list_pages → 查找 URL 含 "outlook.cloud.microsoft" 的标签页
• 若存在已登录标签：chrome-devtools__select_page(pageId=N) chrome-devtools__take_snapshot() → 读取收件箱邮件列表
• 若不存在：chrome-devtools__new_page(url="https://outlook.cloud.microsoft/mail/") → 提示用户手动登录，完成后告知 AI 继续
• 点击目标邮件：chrome-devtools__click(uid="邮件元素uid") chrome-devtools__take_snapshot() → 读取邮件正文

• chrome-devtools__list_pages → 查找已登录 X 的标签页（URL 含 "x.com"）
• 若存在：chrome-devtools__select_page(pageId=N) chrome-devtools__navigate_page(type="url", url="https://x.com/search?q=关键词&f=live") chrome-devtools__wait_for(text="推文关键词或用户名") chrome-devtools__take_snapshot() → 读取推文列表并总结
• 若不存在： → 提示用户先在浏览器手动登录 X，完成后告知 AI 继续

四、故障排查 问题 原因 解决方法 Could not find DevToolsActivePort Chrome 未开启调试 重新在 chrome://inspect 开启远程调试 Could not find Chrome Beta executable MCP 含 --channel=beta 去掉该参数，重启网关 gateway closed (1008): pairing required OpenClaw 网关配对失效 重启 OpenClaw 或重新配对 Outlook 跳转到产品宣传页 浏览器未登录或标签错误 用 list_pages 找 outlook.cloud.microsoft 标签并 select_page X 跳转到登录页 未登录或 Cookie 失效 用户手动在浏览器登录 X 后告知 AI 页面内容为空 页面尚未加载完成 先调用 wait_for 等待关键文字出现