feishu-e2e-test — скилл для Claude Code: локальное тестирование Feishu-бота
Скилл feishu-e2e-test для Claude Code помогает отлаживать и E2E-тестировать Feishu-бота на машине разработчика, проверяя ответы и работу с документами через веб-интерфейс.
MIT 122 установок ★ 4 217 обновлён 2026-03-29
npx skills add m1heng/clawdbot-feishu --skill feishu-e2e-test -a claude-codeЧто делает feishu-e2e-test
Скилл даёт инструменты для локального тестирования интеграции OpenClaw и Feishu: запускаешь браузер с agent-browser, логишься в Feishu через веб, отправляешь боту сообщения буквой за буквой и смотришь, что происходит в логах шлюза. Нужны установленные OpenClaw, agent-browser CLI и доступ к веб Feishu по адресу https://feishu.cn/next/messenger.
Фреймворк включает стратегии взаимодействия с UI Feishu: поиск чатов через Cmd+K вместо кликов, фокус на инпут клавишей "/", посимвольный ввод текста, так как type команда часто ошибается на спецсимволах. Китайские иероглифы через press не работают — используй только английский. Полные ссылки на документы срабатывают надёжнее, чем ID.
Чтобы изменения кода вступили в силу, нужно каждый раз перезагружать OpenClaw шлюз командой openclaw gateway restart. Логирование помогает отследить, достигнуло ли сообщение агента и какие инструменты он вызвал — смотри ~/.openclaw/logs/gateway.log.
Какие задачи решает
- отладить поток сообщений между ботом и Feishu
- проверить ответы бота на разные команды
- убедиться, что бот читает документы Feishu
- протестировать инструменты на веб-интерфейсе
Примеры запросов агенту
- Запусти браузер для локального тестирования:
agent-browser --headed --session feishu-test open "https://feishu.cn/next/messenger", найди бота по имени (Cmd+K), отправь ему «ping» - Проверь, что бот вызывает инструмент
feishu_doc: отправь ему URL документаhttps://feishu.cn/docx/YOUR_DOC_IDи посмотри логиtail -f ~/.openclaw/logs/gateway.log - После изменения кода перезагрузи шлюз
openclaw gateway restartи отправь боту тестовое сообщение, чтобы убедиться, что новая версия работает
Как установить feishu-e2e-test
1Через Skills CLI (Vercel)
npx skills add m1heng/clawdbot-feishu --skill feishu-e2e-test -a claude-code2Вручную: положить файлы
~/.claude/skills/feishu-e2e-test/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/feishu-e2e-test/
1Через Skills CLI (Vercel)
npx skills add m1heng/clawdbot-feishu --skill feishu-e2e-test -a codex2Вручную: положить файлы
.agents/skills/feishu-e2e-test/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add m1heng/clawdbot-feishu --skill feishu-e2e-test -a cursor2Вручную: положить файлы
.cursor/skills/feishu-e2e-test/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install m1heng/clawdbot-feishu .claude/skills/feishu-e2e-test2Вручную: положить файлы
.github/skills/feishu-e2e-test/SKILL.md1Через Skills CLI (Vercel)
npx skills add m1heng/clawdbot-feishu --skill feishu-e2e-test -a gemini-cli2Командой платформы
gemini skills install https://github.com/m1heng/clawdbot-feishu --path .claude/skills/feishu-e2e-testВручную: положить файлы
.devin/skills/feishu-e2e-test/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add m1heng/clawdbot-feishu --skill feishu-e2e-test -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о feishu-e2e-test
Как установить feishu-e2e-test в Claude Code?
Выполни по порядку: npx skills add m1heng/clawdbot-feishu --skill feishu-e2e-test -a claude-code, затем открой ~/.claude/skills/feishu-e2e-test/SKILL.md.
Что делает feishu-e2e-test?
Позволяет локально тестировать Feishu-бота: открываешь браузер через agent-browser, пишешь боту сообщения и проверяешь его ответы и логи. Помогает отловить ошибки перед деплоем.
Почему бот не отвечает на китайский текст?
Команда press не поддерживает иероглифы — используй только латиницу. Отправляй на английском или русском, если нужно протестировать обработку текста.
Исходный текст
SKILL.md · MIT
--- name: feishu-e2e-test description: 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.** ```bash # Restart gateway (required after code changes) openclaw gateway restart # Check if gateway is running ps aux | grep openclaw # View gateway logs tail -f ~/.openclaw/logs/gateway.log ``` ## agent-browser Usage Always use `--headed` mode so user can see the browser and help with login: ```bash 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: ```bash # 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: ```bash 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: ```bash # Instead of: 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. Chinese Characters Do NOT Work **Chinese characters cannot be typed with `press` command.** Use English only: ```bash # BAD - Chinese won't render for char in $(echo "读取文档" | grep -o .); do agent-browser --session feishu-test press "$char" # Will fail silently done # GOOD - Use English for 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 `" "`: ```bash # 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: ```bash # 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 || true done ``` ### 7. Avoid JS eval on Feishu Do NOT use `eval` to set input values - it can break the page: ```bash # 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: ```bash # 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: ```bash 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 - `[feishu] deliver called: text=...` - agent response - `[feishu] dispatch complete` - response sent ### Verify Tool Usage Ask bot explicitly to confirm tool usage: ``` use feishu_doc tool to read YOUR_DOC_TOKEN ``` Look for confirmation in response like: > "我已经用 **Feishu Doc Tool** 读过了这个文档" ## Common Errors ### Permission Error (99991672) ``` Access denied. One of the following scopes is required: [contact:contact.base:readonly...] ``` This means bot lacks contact permission. Doesn't affect core messaging but prevents resolving sender names. ### Other Log Locations ```bash # Error logs tail -f ~/.openclaw/logs/gateway.err.log # All log files ls -la ~/.openclaw/logs/ # Raw agent session records (tool calls, responses, etc.) ls ~/.openclaw/agents/main/sessions/ # View specific session cat ~/.openclaw/agents/main/sessions/<session-id>.json ``` ## Test Workflow 1. Start browser: `agent-browser --headed --session feishu-test open "https://feishu.cn/next/messenger"` 2. User scans QR to login 3. Search for bot: `Cmd+K` → type bot name → `Enter` 4. Focus input: press `/` then `Backspace` 5. Type message (English only, letter by letter) 6. Press `Enter` to send 7. Wait 10-20 seconds for response 8. Take screenshot and check logs to verify ## Testing feishu_doc Tool ```bash # 1. Focus input agent-browser --session feishu-test press "/" && \ agent-browser --session feishu-test press "Backspace" # 2. Type full doc 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. Send agent-browser --session feishu-test press "Enter" # 4. Wait and check logs sleep 15 && tail -30 ~/.openclaw/logs/gateway.log ```
© m1heng · MIT · m1heng/clawdbot-feishu