← Back to Skills Marketplace
EnglishTutor
by
PandaltsGo
· GitHub ↗
· v2.0.0
· MIT-0
101
Downloads
0
Stars
0
Active Installs
2
Versions
Install in OpenClaw
/install the-english-tutor
Description
英语口语陪练助手。触发词:「练习英语」「我要说英语」「英语陪练」。功能:上传生词表 → 每日定时情景对话 → 语音输入即时纠错 → 飞书语音推送 → 自动艾宾浩斯复习。
Usage Guidance
Before installing or running this skill:
- Expect to provide Feishu credentials (FEISHU_APP_ID, FEISHU_APP_SECRET, FEISHU_USER_OPEN_ID), a MiniMax TTS key (or other TTS provider keys), and optional ASR/cloud keys — only supply credentials you trust and limit their scope where possible.
- The skill will create/modify ~/.openclaw/english-tutor/config.json and may write a .env next to an existing Node.js feishu-voice.js (it looks for agents/english-tutor paths). Review the target feishu-voice.js file and be cautious about allowing writes to shared agents directories.
- The scripts download large model files (hundreds of MB) from external hosts (GitHub, hf-mirror.com, modelscope.cn). Verify download URLs and, if possible, checksums before running in production. Run downloads in a sandbox or isolated environment first.
- The SKILL.md and code reference many env vars that the registry metadata did not declare; confirm required variables and avoid providing unrelated secrets.
- If you only want cloud TTS/ASR, avoid enabling local model downloads; conversely, if you enable local models, ensure sufficient disk space and verify sources.
- Run scripts like scripts/check_env.py and inspect feishu-voice.js (the Node implementation the Python wrapper calls) before invoking; do not run as root and consider running in a disposable container or VM.
If you want, I can list the exact env vars the code reads and the file paths the skill will write to, or help draft a minimal test plan to validate behavior in a sandbox.
Capability Analysis
Type: OpenClaw Skill
Name: the-english-tutor
Version: 2.0.0
The skill bundle implements a legitimate English tutoring service but employs high-risk credential handling and execution patterns. Specifically, `scripts/feishu_voice.py` writes sensitive API keys (Feishu, MiniMax) to a temporary `.env` file on the filesystem to pass them to a Node.js subprocess, which could lead to secret exposure if the script crashes or is interrupted. Additionally, `scripts/check_env.py` utilizes `shell=True` for system checks, and `scripts/download_model.sh` executes remote downloads via `curl` from ModelScope/HuggingFace, which are risky behaviors in an automated agent environment.
Capability Tags
Capability Assessment
Purpose & Capability
The skill's code, SKILL.md, and scripts implement Feishu voice push, local/cloud ASR, local TTS, cron scheduling and a local config store — all coherent with an English tutoring assistant. However the registry metadata claims no required environment variables or credentials while the SKILL.md and scripts clearly expect many secrets (FEISHU_*, MINIMAX_*, BITABLE_*, ASR provider keys). That metadata mismatch is an incoherence the user should be aware of.
Instruction Scope
Runtime instructions and scripts perform broad operations: downloading large ML models, running ffmpeg/node/subprocesses, writing/reading ~/.openclaw/config.json, and writing a .env file into other code locations (a Node.js feishu-voice.js directory). The feishu_voice.py will modify files outside the skill bundle (it searches/updates agents/english-tutor/feishu-voice.js directories), and the scripts can call cloud ASR/TTS APIs. These actions go beyond simple in-memory behavior and could affect other agent components or exfiltrate data if misconfigured.
Install Mechanism
There is no formal install spec, but scripts instruct downloading binaries and large model files from external hosts: GitHub releases, hf-mirror.com, and modelscope.cn. Downloading/extracting large artifacts and pip installing with --break-system-packages is higher-risk in managed environments. The modelscope.cn URL (for sherpa model) is less familiar than canonical HF or GitHub releases, increasing supply-chain risk.
Credentials
The skill requires multiple sensitive environment variables (Feishu app id/secret, user open_id, MiniMax API key, optional ASR cloud keys, Bitable tokens/IDs) which are proportionate to the stated features, but the registry metadata declares none required — an inconsistency. The number of secrets is significant; only provide the minimal credentials you trust and understand. Some env vars (e.g., ASR_API_KEY, XFyun_*) are referenced in code but not surfaced in registry metadata.
Persistence & Privilege
The skill writes persistent configuration to ~/.openclaw/english-tutor/config.json (expected) and also writes/restores a .env into a Node.js script directory that may belong to a shared agents installation (it searches /vol1/@apphome/... and user home agents paths). While the script attempts to restore previous .env content, modifying files outside the skill's own directory increases blast radius and can affect other skills; cron scheduling and model downloads add persistent on-disk state.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install the-english-tutor - After installation, invoke the skill by name or use
/the-english-tutor - Provide required inputs per the skill's parameter spec and get structured output
Version History
v2.0.0
English Tutor 1.0.1 — major update with new features and architecture
- Added essential scripts for configuration, Feishu voice integration, and wordlist parsing.
- Refactored skill documentation for clarity: now details flow, modules, environment variables, and setup.
- Added support for uploading custom wordlists and daily scenario-based practice sessions.
- Introduced intelligent Ebbinghaus-based vocabulary review with multi-dimensional table tracking.
- Enhanced voice interaction: text-to-speech outputs (via Feishu), local/offline TTS/ASR fallback logic.
- Modularized the skill with clear APIs for main agent logic, Feishu messaging, local TTS, ASR, and memory.
v1.0.0
English Tutor 1.0.0 — Initial Release
- Added local and online ASR (automatic speech recognition) setup guides, with model download and verification scripts.
- Introduced TTS (text to speech) options including piper, espeak-ng, gTTS, and several online providers, with detailed environment variable instructions.
- Provided spoken English practice and correction workflow, with Chinese explanations attached to each response.
- Included Ebbinghaus-based vocabulary review system.
- Added scripts for environment check, model download, and transcription.
Metadata
Frequently Asked Questions
What is EnglishTutor?
英语口语陪练助手。触发词:「练习英语」「我要说英语」「英语陪练」。功能:上传生词表 → 每日定时情景对话 → 语音输入即时纠错 → 飞书语音推送 → 自动艾宾浩斯复习。 It is an AI Agent Skill for Claude Code / OpenClaw, with 101 downloads so far.
How do I install EnglishTutor?
Run "/install the-english-tutor" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is EnglishTutor free?
Yes, EnglishTutor is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does EnglishTutor support?
EnglishTutor is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created EnglishTutor?
It is built and maintained by PandaltsGo (@pandaltsgo); the current version is v2.0.0.
More Skills