Installation
Environment preparation before first use
Quick Usage
User: install environment
User: initialize
Dependency List
| Dependency | Usage | Install Command |
|---|---|---|
| Node.js | Run scripts | brew install node |
| FFmpeg | Video editing | brew install ffmpeg |
| curl | API calls | Built-in (macOS) |
API Configuration
Volcengine Speech Recognition
Console: https://console.volcengine.com/speech/new/experience/asr?projectName=default
- Register a Volcengine account
- Enable the speech recognition service
- Obtain the API Key
Configure it in the project directory .claude/skills/.env:
# File path: clip-agent/.claude/skills/.env
VOLCENGINE_API_KEY=your_api_key_here
Installation Process
1. Install Node.js + FFmpeg
|
2. Configure Volcengine API Key
|
3. Verify environment
Execution Steps
1. Install Dependencies
# macOS
brew install node ffmpeg
# Verify
node -v
ffmpeg -version
2. Configure API Key
# Create the .env file in the project's .claude/skills/ directory
echo "VOLCENGINE_API_KEY=your_key" >> .claude/skills/.env
3. Verify Environment
# Check Node.js
node -v
# Check FFmpeg
ffmpeg -version
# Check API Key (run in the project directory)
cat .claude/skills/.env | grep VOLCENGINE
Frequently Asked Questions
Q1: Where do I get the API Key?
Volcengine Console → Speech Technology → Speech Recognition → API Key
Q2: ffmpeg command not found
which ffmpeg # Should output a path
# If not, reinstall: brew install ffmpeg
Q3: Filename with colon causes error
FFmpeg commands require the file: prefix:
ffmpeg -i "file:2026:01:26 task.mp4" ...