Browser Config

配置和管理 OpenClaw-CN 浏览器模式（openclaw/chrome），解决浏览器连接问题

Security Scan

The skill's requests and instructions match its stated purpose (configuring OpenClaw-CN browser modes); it is an instruction-only utility that edits local OpenClaw config and runs the openclaw-cn CLI.

Purpose & Capability

Name/description describe configuring OpenClaw-CN browser modes and the skill only requires the openclaw-cn binary and edits OpenClaw config files — these requirements are appropriate and expected for this purpose.

Instruction Scope

SKILL.md directs the user/agent to edit C:\Users\Administrator\.openclaw\openclaw.json, restart the OpenClaw gateway, and run openclaw-cn browser commands. This is within scope for a browser-config skill but requires write access to the user's OpenClaw config and ability to restart the gateway; no unrelated files, credentials, or external endpoints are referenced.

Install Mechanism

No install spec or downloaded code is included; the skill is instruction-only and relies on the existing openclaw-cn binary, which is low-risk from an install perspective.

Credentials

The skill requests no environment variables or external credentials. It references local OpenClaw config paths (in the Administrator user's home), which is expected for configuring the product and proportional to its function.

Persistence & Privilege

Skill is not marked always:true and is user-invocable; it does not request persistent elevated privileges or attempt to modify other skills or global agent settings. Autonomous invocation is permitted by platform default but not otherwise unusual here.

Assessment

This skill appears coherent with its purpose, but take simple precautions before using it: (1) confirm the openclaw-cn binary you have is from a trusted source; (2) back up C:\Users\Administrator\.openclaw\openclaw.json before editing; (3) be aware the instructions require restarting the OpenClaw gateway and write access to that user profile (you may need administrative rights); (4) if using chrome mode, only install/use a trusted OpenClaw Browser Relay extension; (5) avoid running provided commands as an elevated user unless necessary — test changes in a safe environment first.

Browser Config - 浏览器配置技能

描述

配置和管理 OpenClaw-CN 浏览器模式。支持两种浏览器模式：

• openclaw - OpenClaw 独立管理的浏览器（推荐，稳定）
• chrome - Chrome 扩展中继模式（需要扩展连接）

触发词

• 配置浏览器
• 切换浏览器模式
• 浏览器打不开
• 浏览器配置
• 设置浏览器

两种模式对比

特性	openclaw 模式	chrome 模式
依赖扩展	❌ 不需要	✅ 需要 OpenClaw Browser Relay 扩展
稳定性	⭐⭐⭐⭐⭐ 高	⭐⭐⭐ 中（依赖扩展连接）
登录状态	独立保存	使用 Chrome 现有登录
适用场景	长期稳定使用、需要登录的网站	临时使用、想共用 Chrome 书签
启动命令	openclaw-cn browser --browser-profile openclaw start	openclaw-cn browser --browser-profile chrome start

配置方法

切换到 openclaw 模式（推荐）

编辑 C:\Users\Administrator\.openclaw\openclaw.json，添加或修改：

{
  "browser": {
    "enabled": true,
    "defaultProfile": "openclaw",
    "headless": false,
    "noSandbox": false,
    "attachOnly": false,
    "profiles": {
      "openclaw": {
        "cdpPort": 18800,
        "color": "#FF4500"
      }
    }
  }
}

然后重启网关：

openclaw-cn gateway restart

启动浏览器：

openclaw-cn browser --browser-profile openclaw start

切换到 chrome 模式

编辑 C:\Users\Administrator\.openclaw\openclaw.json：

{
  "browser": {
    "enabled": true,
    "defaultProfile": "chrome",
    "headless": false,
    "noSandbox": false,
    "attachOnly": false
  }
}

重启网关后，需要：

1. 打开 Chrome 浏览器
2. 点击 OpenClaw Browser Relay 扩展图标
3. 确保扩展连接到当前标签页（图标显示 ON）

常见问题排查

问题 1：浏览器服务连不上

错误信息： Can't reach the OpenClaw-CN browser control service

解决方案：

1. 检查浏览器状态：openclaw-cn browser --browser-profile <profile名> status
2. 如果 运行中：false，启动它：openclaw-cn browser --browser-profile <profile名> start
3. 如果是 chrome 模式，确保扩展已连接

问题 2：chrome 扩展模式一直连不上

原因： 扩展中继服务通信问题

解决方案： 改回 openclaw 模式（更稳定）

问题 3：网关重启后浏览器没了

解决方案： 重新运行启动命令：

openclaw-cn browser --browser-profile openclaw start

使用示例

打开网页

openclaw-cn browser --browser-profile openclaw open https://www.xiaohongshu.com

查看状态

openclaw-cn browser --browser-profile openclaw status

截图

通过 browser 工具调用：

browser: screenshot, targetId=<标签页 ID>

注意事项

1. 登录状态保存 - openclaw 模式的登录数据保存在 C:\Users\Administrator\.openclaw\browser\openclaw\user-data
2. 不要混用模式 - 频繁切换模式可能导致登录状态丢失
3. 推荐 openclaw 模式 - 更稳定，不依赖扩展，适合长期使用
4. 发小红书/微博等 - 登录一次后会话会保持，不需要每次都登录

配置文件位置

• 主配置：C:\Users\Administrator\.openclaw\openclaw.json
• 浏览器数据：C:\Users\Administrator\.openclaw\browser\openclaw\user-data
• 网关日志：C:\Users\Administrator\.openclaw\logs\gateway.log