飞书网页界面技巧

飞书网页界面复杂，直接点击通常不可靠。请使用以下策略：

1. 使用搜索 (Cmd+K) 替代点击

点击聊天列表项经常错过或选错项目。请使用全局搜索：

# 打开搜索
agent-browser --session feishu-test press "Meta+k"

# 逐个字母输入机器人名称
agent-browser --session feishu-test press "o"
agent-browser --session feishu-test press "p"
agent-browser --session feishu-test press "e"
agent-browser --session feishu-test press "n"

# 选择第一个结果
agent-browser --session feishu-test press "Enter"

2. 使用 "/" 键聚焦输入框

进入聊天后，按 "/" 键来聚焦消息输入框：

agent-browser --session feishu-test press "/"
agent-browser --session feishu-test press "Backspace"  # 删除 "/"
# 然后输入你的消息

3. 逐个字符输入

type 命令在处理特殊字符时经常失败。请对每个字符使用 press 命令：

# 不要使用：agent-browser type "ping"
agent-browser --session feishu-test press "p"
agent-browser --session feishu-test press "i"
agent-browser --session feishu-test press "n"
agent-browser --session feishu-test press "g"

4. 中文字符无法输入

无法使用 press 命令输入中文字符。 请仅使用英文：

# 错误 - 中文无法渲染
for char in $(echo "读取文档" | grep -o .); do
  agent-browser --session feishu-test press "$char"  # 会静默失败
done

# 正确 - 使用英文
for char in r e a d " " d o c; do
  agent-browser --session feishu-test press "$char"
done

5. 输入空格

空格必须用引号引起来，如 " "：

# 输入 "read doc"
for char in r e a d " " d o c; do
  agent-browser --session feishu-test press "$char"
done

6. 高效输入长字符串

使用 for 循环来输入 URL 或长文本：

# 输入完整 URL
url="https://feishu.cn/docx/YOUR_DOC_TOKEN"
for char in $(echo "$url" | grep -o .); do
  agent-browser --session feishu-test press "$char" 2>/dev/null || true
done

7. 避免在飞书上使用 JS eval

请勿使用 eval 来设置输入框的值——这可能会破坏页面：

# 错误 - 会损坏页面
agent-browser eval "document.activeElement.innerText = 'text'"

# 正确 - 使用键盘输入
agent-browser press "t" && agent-browser press "e" ...

8. 完整 URL 比 ID 效果更好

测试文档工具时，发送完整 URL 比仅发送文档 ID 更可靠：

# 更好 - 机器人能识别为文档链接
"https://feishu.cn/docx/YOUR_DOC_TOKEN"

# 不太可靠 - 可能无法触发工具
"read YOUR_DOC_TOKEN"

验证工具调用

日志模式

监控网关日志以验证工具执行：

tail -f ~/.openclaw/logs/gateway.log

关键日志条目：

• [feishu] received message from ... - 收到消息
• [feishu] dispatching to agent - 已发送给代理
• [feishu] added typing indicator reaction - 机器人正在处理
• [feishu] deliver called: text=... - 代理响应
• [feishu] dispatch complete - 响应已发送

验证工具使用情况

明确要求机器人确认工具使用情况：

use feishu_doc tool to read YOUR_DOC_TOKEN

在响应中寻找类似这样的确认信息：

"我已经用 Feishu Doc Tool 读过了这个文档"

常见错误

权限错误 (99991672)

Access denied. One of the following scopes is required: [contact:contact.base:readonly...]

这意味着机器人缺少联系人权限。不影响核心消息功能，但会阻止解析发送者姓名。

其他日志位置

# 错误日志
tail -f ~/.openclaw/logs/gateway.err.log

# 所有日志文件
ls -la ~/.openclaw/logs/

# 原始代理会话记录（工具调用、响应等）
ls ~/.openclaw/agents/main/sessions/
# 查看特定会话
cat ~/.openclaw/agents/main/sessions/<session-id>.json

测试工作流程

1. 启动浏览器：agent-browser --headed --session feishu-test open "https://feishu.cn/next/messenger"
2. 用户扫描二维码登录
3. 搜索机器人：Cmd+K → 输入机器人名称 → Enter
4. 聚焦输入框：按 / 然后按 Backspace
5. 输入消息（仅限英文，逐个字母输入）
6. 按 Enter 发送
7. 等待 10-20 秒获取响应
8. 截图并检查日志以验证

测试 feishu_doc 工具

# 1. 聚焦输入框
agent-browser --session feishu-test press "/" && \
agent-browser --session feishu-test press "Backspace"

# 2. 输入完整的文档 URL
url="https://feishu.cn/docx/YOUR_DOC_ID"
for char in $(echo "$url" | grep -o .); do
  agent-browser --session feishu-test press "$char" 2>/dev/null || true
done

# 3. 发送
agent-browser --session feishu-test press "Enter"

# 4. 等待并检查日志
sleep 15 && tail -30 ~/.openclaw/logs/gateway.log

每周安装量

93

代码仓库

m1heng/clawdbot-feishu

GitHub 星标数

4.3K

首次出现

2026年2月11日

安全审计

Gen Agent Trust HubFailSocketPassSnykFail

安装于

opencode82

gemini-cli80

github-copilot80

codex80

cursor80

amp79