К основному содержанию
скилл CX Codex

feishu-e2e-test — скилл для Claude Code: локальное тестирование Feishu-бота

Скилл feishu-e2e-test для Claude Code помогает отлаживать и E2E-тестировать Feishu-бота на машине разработчика, проверяя ответы и работу с документами через веб-интерфейс.

MIT 122 установок ★ 4 217 обновлён 2026-03-29

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add m1heng/clawdbot-feishu --skill feishu-e2e-test -a claude-code
Открыть на GitHub

Что делает 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-code

2Вручную: положить файлы

~/.claude/skills/feishu-e2e-test/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/feishu-e2e-test/

По шагам, с командами для каждой платформы: Как установить скилл в 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

Похожие скиллы

Все скиллы по теме «Тесты и QA» →
feishu-lark OpenClaudia Скилл feishu-lark для Claude Code и Codex — отправляет текстовые и интерактивные карточки в Feishu и Lark через вебхуки или Bot API. Работает также с Cursor, GitHub Copilot, Gemini CLI и OpenCode. CX Codex +1 1 600установок e2e-test-builder patricio0312rev Скилл e2e-test-builder генерирует сквозные браузерные тесты для Playwright и Cypress с паттерном Page Object, фикстурами и селекторами по ролям. CX Codex +1 273установок feishu-wiki openclaw Находит пространства, обходит дерево узлов и готовит страницы Feishu Wiki к чтению через инструмент feishu_wiki. CX Codex +1 ★ 395 001звёзд репо skillshare-cli-e2e-test runkids Скилл skillshare-cli-e2e-test запускает изолированные E2E-тесты CLI в devcontainer по сценариям из ai_docs/tests с отчётами через mdproof. CX Codex +1 ★ 3 269звёзд репо feishu-doc-scraper daymade Скилл feishu-doc-scraper для Claude Code извлекает документы Feishu/Lark в локальный Markdown. Запускается, когда нужно сохранить содержимое по ссылке или преобразовать экспортированный .docx. CX Codex +1 683установок e2e-testing affaan-m Скилл e2e-testing для Claude Code содержит паттерны E2E-тестирования на Playwright: настройку Page Object Model, конфигов запуска и изоляцию нестабильных сценариев. CX Codex +1 7 200установок

Из того же набора8

feishu-doc Скилл feishu-doc читает, создаёт и обновляет документы Feishu через Markdown, а также управляет комментариями прямо из ассистента. CX Codex +1 1 900установок feishu-drive Управляет файлами и папками в Feishu Drive: показывает содержимое, создаёт папки, переносит и удаляет файлы. CX Codex +1 880установок feishu-wiki Скилл feishu-wiki управляет базой знаний Feishu через агента. Позволяет смотреть список пространств, строить дерево узлов и создавать новые страницы. CX Codex +1 464установок feishu-perm Управляет правами доступа к файлам и документам Feishu через единственный инструмент feishu_perm. Включается, когда упоминают шаринг, коллабораторов или разрешения. CX Codex +1 264установок feishu-task Скилл feishu-task для Claude Code управляет задачами, списками дел, подзадачами, комментариями и вложениями в Feishu через ИИ-агента. Ведёт трекер задач без переключения в браузер. CX Codex +1 175установок feishu-message Скилл feishu-message даёт агенту доступ к сообщениям Feishu: можно запросить одно сообщение по ID или вывести недавние сообщения из чата с фильтрацией по времени и сортировкой. CX Codex +1 145установок release Скилл release автоматизирует выпуск плагина Feishu: проверяет типы, собирает список изменений, делает релиз на GitHub и публикует пакет в npm. CX Codex +1 111установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой