OpenClaw 学习笔记

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

Agent 运行时中的模型、工具、记忆、工作区与执行

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

当前扩展目录

~/.openclaw/browser/chrome-extension

当前 token 获取方式

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

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

安装与配置

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 是否正常

openclaw browser --browser-profile chrome-relay tabs

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

当前确认过的一个坑

网上一些文章会写：

openclaw browser --browser-profile user start

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

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

4. OpenClaw 自己新开浏览器

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

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 的标签页，提示词开头要加这一段：

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

可选配置

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

"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. 渠道接入

微信

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

飞书

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

钉钉

之前踩过的坑：

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

查看状态：

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.