用途：本地端到端调试与测试 clawd-feishu 插件开发，适用于调试消息流转、测试机器人响应、验证飞书网页端交互及文档工具调用。
前提条件：已在 https://feishu.cn/next/messenger 登录飞书网页版；agent-browser CLI 可用；本地安装 OpenClaw；聊天中或 .env 提供飞书机器人 appid/secret；已知机器人名称。
关键限制：每次修改扩展代码后必须重启 OpenClaw Gateway 才生效，命令为 openclaw gateway restart。
使用方式：始终以 --headed 模式启动浏览器便于用户手动登录，例如 agent-browser --headed --session feishu-test open "https://feishu.cn/next/messenger"。飞书网页 UI 复杂，建议用 Cmd+K 全局搜索机器人而非点击列表；进入会话后按 / 聚焦输入框再按 Backspace 删除；字符需逐个用 press 输入；中文字符无法用 press 输入，只能用英文；空格须写成 " "；长字符串（如 URL）用 for 循环逐字符输入；避免用 eval 设置输入值；测试文档工具时发送完整 URL 更可靠。
验证方式：通过 tail -f ~/.openclaw/logs/gateway.log 监控日志，关注 [feishu] received message、dispatching to agent、deliver called、dispatch complete 等条目；错误日志见 gateway.err.log，原始会话记录在 ~/.openclaw/agents/main/sessions/。
已知错误：权限错误 99991672 表示机器人缺少通讯录权限，不影响核心消息功能，但无法解析发送者姓名。
典型流程：启动浏览器→用户扫码登录→搜索机器人→聚焦输入框→逐字符输入英文消息→回车发送→等待 10-20 秒→截图并查日志验证。