Feishu Browser Skill
通过 OpenClaw browser tool (profile=openclaw) 操控飞书网页版，模拟真人操作。
前置条件
本 skill 不需要飞书 API 权限。 它通过浏览器模拟真人操作飞书网页版，只需要：
- OpenClaw browser 已启动（
browser action=start profile=openclaw） - 一个已登录飞书的浏览器 session（手动扫码登录一次即可）
💡 适合场景：外部群（API 机器人进不去）、需要以个人账号身份操作
环境信息
| 项目 | 值 |
|---|---|
| 租户域名 | ja484frx8z.feishu.cn |
| 消息页 | https://ja484frx8z.feishu.cn/next/messenger/ |
| Browser Profile | openclaw |
| Viewport | 1280×800（最低要求，聊天列表需要 ≥1280 宽度） |
前置条件
- 浏览器已启动：
browser action=start profile=openclaw - 飞书账号已登录（瓦力账号）
- Viewport 设为 1280×800
核心操作
1. 发送消息
导航到消息页 → 点击目标群聊 → 清空输入框 → 写入内容 → 点击发送按钮。
关键点：
- 必须用
document.execCommand('insertText')写入内容（innerHTML/innerText 不触发飞书框架）✅ 已验证 - 必须点击发送按钮（Enter 键无法发送）✅ 已验证
- 发送按钮位置：viewport 1280×800 下 x>1210, y>730 ✅ 已验证
👉 详细流程见 references/send-message.md
2. 读取消息
通过 browser action=snapshot 获取当前聊天窗口的消息列表，解析文本内容。
快速读取（已验证）：
// ✅ 已验证 - 获取聊天窗口可见消息
(function(){
var msgs = document.querySelectorAll('[class*="message"]');
var result = [];
msgs.forEach(function(m){ if(m.textContent.trim()) result.push(m.textContent.trim()); });
return JSON.stringify(result.slice(-10));
})()
也可以直接用 browser action=snapshot 拿 aria tree，搜索消息内容。
3. @人
在输入框中输入 @ 字符，等待选人下拉列表出现，然后点击目标人名。
👉 详细流程见 references/send-message.md
4. 创建文档
通过飞书文档页面创建新文档，使用富文本编辑器输入内容。
👉 详细流程见 references/create-doc.md
5. 设置文档权限
通过文档右上角「分享」按钮设置权限。
👉 详细流程见 references/doc-permissions.md
6. 群消息监控
定期截图 + snapshot 对比检测新消息，判断是否需要回复。
👉 详细流程见 references/monitor-chat.md
常用 Browser 调用模式
# 启动浏览器
browser action=start profile=openclaw
# 导航
browser action=navigate profile=openclaw targetUrl="https://ja484frx8z.feishu.cn/next/messenger/"
# 截图查看当前状态
browser action=screenshot profile=openclaw
# 获取页面结构
browser action=snapshot profile=openclaw
# 执行 JS
browser action=act profile=openclaw request={kind:"evaluate", fn:"..."}
# 点击元素（通过 snapshot 拿到的 ref）
browser action=act profile=openclaw request={kind:"click", ref:"e42"}
常见问题
Q: 输入框写入内容后飞书没检测到？
A: 必须用 execCommand('insertText')，不能用 innerHTML 或 innerText。
Q: 发送按钮找不到？
A: 检查 viewport 是否 ≥1280×800。发送按钮在右下角，坐标约 x>1210, y>730。
Q: 聊天列表不显示？
A: viewport 宽度必须 ≥1280px。
Q: 页面加载后操作失败？
A: 导航后等待 2-3 秒再操作。可用 screenshot 确认页面状态。
Q: @人列表不出现？
A: 确保输入框已 focus，然后用 execCommand 插入 @ 字符，等待 1-2 秒。
Q: 聊天区域无法滚动？
A: 飞书使用虚拟列表，scrollTop 和 scrollBy 不生效。必须用键盘 PageUp/PageDown：
# 先 hover 到聊天区域（main ref），再按 PageUp/PageDown
browser action=act request={kind:"hover", ref:"<main_area_ref>"}
browser action=act request={kind:"press", key:"PageUp"} # 向上滚
browser action=act request={kind:"press", key:"PageDown"} # 向下滚
⚠️ 已验证：JS 的 scrollTop/scrollBy/WheelEvent 对飞书虚拟列表无效，只有 PageUp/PageDown 有效。