浏览器设置

快速开始¶

openclaw browser --browser-profile openclaw doctor
openclaw browser --browser-profile openclaw doctor --deep
openclaw browser --browser-profile openclaw status
openclaw browser --browser-profile openclaw start
openclaw browser --browser-profile openclaw open https://example.com
openclaw browser --browser-profile openclaw snapshot

“Browser disabled” 表示插件或 browser.enabled 已关闭；请参阅 配置 和 插件控制。

浏览器控制错误会指出已记录的策略拒绝或插件加载失败。如果 browser 未包含在 plugins.allow 中，请先将其添加到现有列表，再运行 openclaw plugins enable browser；仅重启无法修复该策略。请遵循错误提示中的启用步骤或 Doctor 命令。如果没有记录可用性原因，请运行 openclaw doctor 并检查 Gateway 日志。

如果 openclaw browser 完全缺失，或智能体表示浏览器工具不可用，请跳转到 浏览器命令或工具缺失。

插件控制¶

默认的 browser 工具是一个捆绑插件。禁用它，以替换为另一个注册相同 browser 工具名称的插件：

{
  plugins: {
    entries: {
      browser: {
        enabled: false,
      },
    },
  },
}

默认配置需要同时满足 plugins.entries.browser.enabled 和 browser.enabled=true。仅禁用插件会将 openclaw browser CLI、browser.request 网关方法、智能体工具和控制服务作为一个整体移除；你的 browser.* 配置会保留，供替换插件使用。

配置文件、启动设置、快照默认值、标签页清理和 browser.allowSystemProfileImport 支持热重载。导入权限变更适用于新的导入；正在进行中的导入会保留其准入状态。浏览器启用、评估、SSRF 策略和扩展中继设置需要重启 Gateway。请参阅 配置热重载。

智能体指南¶

工具 profile 说明：tools.profile: "coding" 包含 web_search 和 web_fetch，但不包含完整的 browser 工具。若要允许智能体或派生的子智能体使用浏览器自动化，请在 profile 阶段添加 browser：

{
  tools: {
    profile: "coding",
    alsoAllow: ["browser"],
  },
}

对于单个智能体，请使用 agents.entries.*.tools.alsoAllow: ["browser"]。仅使用 tools.subagents.tools.allow: ["browser"] 是不够的，因为子智能体策略是在 profile 过滤之后应用的。

浏览器插件提供两个层级的智能体指导：

• browser 工具描述带有紧凑的常驻契约：选择正确的 profile，在同一标签页上保留 refs，使用 tabId/标签进行标签页定向，并为多步骤工作加载浏览器技能。
• 捆绑的 browser-automation 技能包含更长的操作循环：先检查状态/标签页，为任务标签页打标签，在操作前拍摄快照，在 UI 变化后重新拍摄快照，仅恢复过期 refs 一次，并将登录/2FA/captcha 或摄像头/麦克风阻塞报告为手动操作，而非自行猜测。

当插件启用时，插件捆绑的技能会列在智能体的可用技能中。完整的技能说明按需加载，因此常规轮次不会消耗全部的 token 成本。

对于页面文本，请使用选择器范围限定的快照或 act:evaluate，只返回相关文本或结构化数据，然后让当前活跃的智能体模型基于这个有界结果进行推理。对于控件和动作发现，请使用高效快照；它们会刻意省略大多数非交互式文本。

浏览器命令或工具缺失¶

如果在升级后 openclaw browser 未知、browser.request 缺失，或智能体报告浏览器工具不可用，通常原因是 plugins.allow 列表未包含 browser，且不存在根级 browser 配置块。请添加它：

{
  plugins: {
    allow: ["telegram", "browser"],
  },
}

显式的根级 browser 块（browser 下的任意键，例如 browser.enabled=true 或 browser.profiles.<name>）即使在限制性的 plugins.allow 下也能激活捆绑的浏览器插件，这与捆绑频道配置的行为一致。plugins.entries.browser.enabled=true 和 tools.alsoAllow: ["browser"] 本身不能替代 allowlist 成员资格。完全移除 plugins.allow 也会恢复默认行为。