Local E2E debug and test framework for clawd-feishu plugin development. Use when debugging message flow, testing bot responses, verifying Feishu web UI interactions, or performing end-to-end validation of the OpenClaw-Feishu integration during development.
Local E2E debug and test framework for clawd-feishu plugin development. Use when debugging message flow, testing bot responses, verifying Feishu web UI interactions, or performing end-to-end validation of the OpenClaw-Feishu integration during development.
allowed-tools
Bash(agent-browser:*)
Feishu E2E Test Framework
Local development testing using agent-browser CLI to interact with Feishu web app.
Prerequisites
Feishu web logged in at https://feishu.cn/next/messenger
agent-browser CLI available
OpenClaw locally installed
Feishu bot appid/secret given in chat or in .env
User given bot name which will display in Feishu web UI
Important Notes
Every time you modify extension code, you MUST restart OpenClaw Gateway for changes to take effect.
# Restart gateway (required after code changes)
openclaw gateway restart
# Check if gateway is running
ps aux | grep openclaw
# View gateway logstail -f ~/.openclaw/logs/gateway.log
agent-browser Usage
Always use --headed mode so user can see the browser and help with login:
agent-browser --headed --session feishu-test open "https://feishu.cn/next/messenger"
Feishu Web UI Tips
Feishu web has complex UI that makes direct clicking unreliable. Use these strategies:
1. Use Search (Cmd+K) Instead of Clicking
Clicking on chat list items often misses or selects wrong item. Use global search:
# Open search
agent-browser --session feishu-test press "Meta+k"# Type bot name letter by letter
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"# Select first result
agent-browser --session feishu-test press "Enter"
2. Focus Input with "/" Key
After entering a chat, press "/" to focus the message input:
agent-browser --session feishu-test press "/"
agent-browser --session feishu-test press "Backspace"# Remove the "/"# Then type your message
3. Type Characters One by One
The type command often fails with special characters. Use press for each character:
Chinese characters cannot be typed with press command. Use English only:
# BAD - Chinese won't renderfor char in $(echo"读取文档" | grep -o .); do
agent-browser --session feishu-test press "$char"# Will fail silentlydone# GOOD - Use Englishfor char in r e a d " " d o c; do
agent-browser --session feishu-test press "$char"done
5. Typing Spaces
Spaces must be quoted as " ":
# Type "read doc"for char in r e a d " " d o c; do
agent-browser --session feishu-test press "$char"done
6. Typing Long Strings Efficiently
Use a for loop to type URLs or long text:
# Type a full 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 || truedone
7. Avoid JS eval on Feishu
Do NOT use eval to set input values - it can break the page:
# BAD - will corrupt page
agent-browser eval"document.activeElement.innerText = 'text'"# GOOD - use keyboard input
agent-browser press "t" && agent-browser press "e" ...
8. Full URLs Work Better Than IDs
When testing document tools, send full URLs rather than just document IDs:
# Better - bot recognizes as document link"https://feishu.cn/docx/YOUR_DOC_TOKEN"# Less reliable - may not trigger tool"read YOUR_DOC_TOKEN"
Verifying Tool Calls
Log Patterns
Monitor gateway logs to verify tool execution:
tail -f ~/.openclaw/logs/gateway.log
Key log entries:
[feishu] received message from ... - incoming message
[feishu] dispatching to agent - sent to agent
[feishu] added typing indicator reaction - bot is processing
