文档
CLI 命令参考
`moltbot browser`

`moltbot browser`

适用范围

使用本页面当：

  • 使用 moltbot browser 并希望获得常见任务的示例
  • 需要通过 browser.controlUrl 控制远程浏览器
  • 需要使用 Chrome 扩展中继（通过工具栏按钮附加/分离）

管理 Moltbot 的浏览器控制服务器并运行浏览器操作（标签页、快照、截图、导航、点击、输入）。

相关：

常用标志

  • --url <controlUrl>: 覆盖此命令调用的 browser.controlUrl。
  • --browser-profile <name>: 选择浏览器配置文件（默认来自配置）。
  • --json: 机器可读输出（在支持的地方）。

快速开始（本地） 

moltbot browser --browser-profile chrome tabs
moltbot browser --browser-profile clawd start
moltbot browser --browser-profile clawd open https://example.com
moltbot browser --browser-profile clawd snapshot

配置文件

配置文件是命名的浏览器路由配置。实际上：

  • clawd：启动/附加到专用的 Moltbot 管理的 Chrome 实例（隔离的用户数据目录）。
  • chrome：通过 Chrome 扩展中继控制您现有的 Chrome 标签页。
moltbot browser profiles
moltbot browser create-profile --name work --color "#FF5A36"
moltbot browser delete-profile --name work

使用特定配置文件：

moltbot browser --browser-profile work tabs

标签页 

moltbot browser tabs
moltbot browser open https://docs.clawd.bot
moltbot browser focus <targetId>
moltbot browser close <targetId>

快照/截图/操作

快照：

moltbot browser snapshot

截图：

moltbot browser screenshot

导航/点击/输入（基于 ref 的 UI 自动化）：

moltbot browser navigate https://example.com
moltbot browser click <ref>
moltbot browser type <ref> "hello"

Chrome 扩展中继（通过工具栏按钮附加）

此模式允许 agent 控制您手动附加的现有 Chrome 标签页（它不会自动附加）。

将解压的扩展安装到稳定路径：

moltbot browser extension install
moltbot browser extension path

然后 Chrome → chrome://extensions → 启用"开发者模式" → “加载解压的” → 选择打印的文件夹。

完整指南：Chrome 扩展

远程浏览器控制（moltbot browser serve）

如果网关在与浏览器不同的机器上运行，请在运行 Chrome 的机器上运行独立的浏览器控制服务器：

moltbot browser serve --bind 127.0.0.1 --port 18791 --token <token>

然后使用 browser.controlUrl + browser.controlToken（或 MOLTBOT_BROWSER_CONTROL_TOKEN）将网关指向它。

安全 + TLS 最佳实践：浏览器工具)、Tailscale)、安全)

`moltbot approvals``moltbot channels`