OpenClaw学习笔记

OpenClaw 学习笔记

这篇笔记偏实操，尽量只保留后续高频会查到的信息。

1. 基础命令

# 启动命令行交互
openclaw tui

# 查看网关状态
openclaw gateway status --json

# 重启网关
openclaw gateway restart

# 修复常见配置问题
openclaw doctor --fix

# 新增 agent
openclaw agents add <name>

# 查看插件
openclaw plugins list

2. 我这台机器当前的浏览器控制结论

这一段是这次排查后确认过的，不是网上旧教程。

当前可用的两条链路

openclaw profile：OpenClaw 自己启动一个受管 Chrome
chrome-relay profile：通过 Chrome 扩展接管我当前已打开的标签页

当前端口

主 Gateway：18789
Browser Relay：18792

当前扩展目录

1	`~/.openclaw/browser/chrome-extension`

当前 token 获取方式

1	`jq -r '.gateway.auth.token' ~/.openclaw/openclaw.json`

3. Chrome 扩展接管当前浏览器

安装与配置

1 2	`openclaw browser extension install openclaw browser extension path`

Chrome 里：

打开 chrome://extensions
开启 Developer mode
Load unpacked
选择 ~/.openclaw/browser/chrome-extension
固定扩展图标

扩展弹窗里填写：

Port：18792
Gateway token：来自 ~/.openclaw/openclaw.json 里的 gateway.auth.token

验证 relay 是否正常

1	`openclaw browser --browser-profile chrome-relay tabs`

如果已经附着标签页，会看到 tab 列表。

当前确认过的一个坑

网上一些文章会写：

1	`openclaw browser --browser-profile user start`

这在我当前环境里不是最佳路径。现在应该优先区分：

复用当前 Chrome 标签页：chrome-relay
新开受管浏览器：openclaw

4. OpenClaw 自己新开浏览器

如果我希望 OpenClaw 单独开一个受管浏览器，而不是复用当前 Chrome：

1 2	`openclaw browser --browser-profile openclaw start openclaw browser --browser-profile openclaw tabs`

适合：

不想污染自己日常浏览器
想让任务环境更可控
不想先点扩展 attach tab

5. 为什么我明明已经 attach 了标签页，OpenClaw 还是新开了一个 Chrome

这是这次最关键的结论之一。

原因

任务里只说了“用浏览器”，并没有明确要求“只用我当前已附着的标签页”
OpenClaw 不会自动把“用浏览器”理解成“必须走 Browser Relay”
如果任务没有显式约束 profile，它可能回退到默认浏览器 profile
在我当前环境里，这种情况下它可能直接选 openclaw，然后新开一个 Chrome

正确做法

如果我想强制它只使用当前已 attach 的标签页，提示词开头要加这一段：

1
2
3

只使用我当前已经通过 OpenClaw Browser Relay 附着的浏览器标签页（profile=chrome-relay）完成任务。
不要启动新的 OpenClaw-managed Chrome，不要回退到 openclaw profile。
如果当前没有附着标签页，先告诉我，再等我处理。

可选配置

如果希望默认优先走 relay，可以在 ~/.openclaw/openclaw.json 中显式配置：

1
2
3

"browser": {
  "defaultProfile": "chrome-relay"
}

但这个配置的代价是：如果当前没有 attach tab，浏览器任务会失败，而不是自动新开受管浏览器。

6. 自然语言浏览器任务怎么写

核心思路：不要只说“帮我看看”，而是把范围、验证动作、输出格式写清楚。

推荐骨架：

Use the browser to inspect <site or page>.

Task:
<what you want done>

Requirements:
1. Verify by browsing the site; do not rely on memory.
2. Prefer information visible on the page itself.
3. If multiple pages are needed, gather them before summarizing.
4. Output in <table/list/json/markdown>.
5. If something is uncertain, label it clearly instead of guessing.

中文版实用原则

先要求它浏览，再要求它总结
定义什么叫“相关”
规定输出字段
给结果数量上限
不确定的内容单独列出

不建议这样写：

“帮我看看这个网站有什么内容”
“随便找点相关文章”
“总结一下”

7. 我现在可直接复用的任务模板

模板：主题文章收集

帮我用浏览器检查 <网站名> 站内内容，找出和 <主题> 相关的文章。

要求：
1. 先在站内搜索或浏览栏目页，不要只凭记忆回答。
2. 优先找标题、正文、标签或栏目描述里明确和 <主题> 相关的文章。
3. 给我一个文章列表，每篇包含：
   - 标题
   - 链接
   - 发布时间（如果页面能看到）
   - 1 到 2 句中文摘要
4. 如果结果很多，先给最相关的 10 篇。
5. 输出用 Markdown 列表。
6. 如果有不确定是否相关的文章，单独放在“可能相关”部分。

模板：只使用当前已附着标签页

只使用我当前已经通过 OpenClaw Browser Relay 附着的浏览器标签页（profile=chrome-relay）完成任务。
不要启动新的 OpenClaw-managed Chrome，不要回退到 openclaw profile。
如果当前没有附着标签页，先告诉我，再等我处理。

任务：
<把真实任务写在这里>

模板：Scientific American + 澳大利亚相关文章

只使用我当前已经通过 OpenClaw Browser Relay 附着的浏览器标签页（profile=chrome-relay）完成任务。
不要启动新的 OpenClaw-managed Chrome，不要回退到 openclaw profile。
如果当前没有附着标签页，先告诉我，再等我处理。

帮我用浏览器检查 Scientific American 站内内容，找出和澳大利亚相关的文章。

要求：
1. 先在站内搜索或浏览栏目页，不要只凭记忆回答。
2. 优先找标题、正文、标签或栏目描述里明确和 Australia / Australian 相关的文章。
3. 给我一个文章列表，每篇包含：
   - 标题
   - 链接
   - 发布时间（如果页面能看到）
   - 1 到 2 句中文摘要
4. 如果结果很多，先给最相关的 10 篇。
5. 将结果写成一个美观且移动端友好的 html 文件，写入本地文件。
6. 如果有不确定是否相关的文章，单独放在“可能相关”部分。
7. 不要只看搜索结果标题，尽量进入文章页核实。

案例：PacificVis 抓取Paper

帮我用浏览器检查 https://pacificvis2026.github.io/  站内内容，找出PacificVis 2026的所有【可下载的】论文。
只使用我当前已经通过 OpenClaw Browser Relay 附着的浏览器标签页（profile=chrome-relay）完成任务。
不要启动新的 OpenClaw-managed Chrome，不要回退到 openclaw profile。
如果当前没有附着标签页，先告诉我，再等我处理。

  要求：
  1. 先在站内搜索或浏览栏目页，不要只凭记忆回答。
  2. 给我一个文章列表，每篇包含：
     - 标题
     - 链接
     - 学校和人员
     - 1 到 2 句中文摘要
  3. 不要有遗漏
  4. 将结果写成一个美观且移动端友好的html文件，写入本地文件。
  5. 如果有不确定是否相关的文章，单独放在“可能相关”部分。
  6. 不要只看搜索结果标题，尽量进入文章页核实。

8. 渠道接入

微信

1	`npx -y @tencent-weixin/openclaw-weixin-cli@latest install`

飞书

https://my.feishu.cn/docx/VIRYdjyJMoRmwKx2GrvcybHonHg

钉钉

之前踩过的坑：

钉钉插件没装好
插件状态是 disabled
没有配置 channels
没有在 plugins 下配置白名单

查看状态：

1	`openclaw plugins list \| grep dingtalk`

微信

Discord

https://mp.weixin.qq.com/s/AkarNHDJSmaT9uiWD5O_8A

9. 一些技巧

切换模型

参考GLM的设置：切换使用 GLM-5-Turbo 模型

创建定时任务

Create a cron job that runs every morning at 7am. It should check my email for anything urgent, summarise the top 3 items, and send me the summary on Telegram. Use sessionTarget: "isolated" so it runs independently.