Glmv Caption Tunnel

API Key Setup / API Key 配置（Required / 必需）

This script reads the key from the ZHIPU_API_KEY environment variable and shares it with other Zhipu skills. 脚本通过 ZHIPU_API_KEY 环境变量获取密钥，与其他智谱技能共用同一个 key。

Get Key / 获取 Key： Visit Zhipu Open Platform API Keys / 智谱开放平台 API Keys to create or copy your key.

Setup options / 配置方式（任选一种）：

1. OpenClaw config (recommended) / OpenClaw 配置（推荐）： Set in openclaw.json under skills.entries.glmv-caption.env:

   "glmv-caption": { "enabled": true, "env": { "ZHIPU_API_KEY": "你的密钥" } }
   

2. Shell environment variable / Shell 环境变量： Add to ~/.zshrc:

   export ZHIPU_API_KEY="你的密钥"
   

3. .env file / .env 文件： Create .env in this skill directory:

   ZHIPU_API_KEY=你的密钥
   

Cloudflared (Required for local video/file paths)

Only needed when passing local file/video paths — not required if you only use URLs.

Install from Cloudflare Downloads.

⛔ MANDATORY: cloudflared 检查与安装流程 (YOU MUST FOLLOW THIS EXACTLY)⛔

当你（AI agent）准备用 --videos 或 --files 传入 本地文件路径 时，在执行脚本之前，你必须先检查 cloudflared 是否已安装。按照以下流程操作：

#### Step 1: 检查 cloudflared 是否存在

# macOS / Linux
which cloudflared
Windows
where cloudflared

如果命令返回了路径（如 /usr/local/bin/cloudflared），说明已安装，直接执行脚本即可。

如果命令报错（not found / 找不到），进入 Step 2。

#### Step 2: 向用户说明情况并征求同意

你必须先完整地向用户解释以下内容，然后询问用户是否同意下载安装。未经用户明确同意，不得自行下载。

向用户展示的说明内容（原文照搬，不要精简）：

> 检测到系统未安装 cloudflared，本地视频/文件路径需要该工具才能使用。 > > 什么是 cloudflared？ > > cloudflared 是 Cloudflare 公司官方开源的命令行隧道工具（Apache 2.0 协议，GitHub 24000+ stars）。 > 它的功能是：在本机与 Cloudflare 全球边缘网络之间建立一条加密的临时隧道，将本地服务暴露为公网 HTTPS URL。 > 开源仓库地址：https://github.com/cloudflare/cloudflared > > 在本场景中的必要性： > > 智谱 GLM-V API 要求视频和文件以公网 HTTPS URL 的形式传入（不支持本地上传）。 > 当你提供本地文件路径时，脚本的工作流程是： > > 1. 在本机启动一个临时 HTTP 服务器（仅暴露你指定的那几个文件，不会暴露其他目录） > 2. 使用 cloudflared 建立一条临时隧道（通过 trycloudflare.com，无需注册账号、无需登录） > 3. 获得一个形如 https://xxx-xxx.trycloudflare.com/your-file.mp4 的临时公网 URL > 4. 将该 URL 传给 GLM-V API 完成调用 > 5. API 调用完成后，隧道和 HTTP 服务器自动关闭，临时文件清理 > > 没有 cloudflared = 无法建立隧道 = 本地视频/文件路径不可用。 > > 安全说明： > - 隧道仅在脚本运行期间存在（通常几十秒到几分钟），脚本结束后立即关闭 > - 只暴露你明确指定的文件，不会暴露整个目录或磁盘 > - cloudflared 不会在后台常驻，不会开机自启 > - 不需要注册 Cloudflare 账号，不收集个人信息 > - 该工具被全球开发者广泛使用，Cloudflare 官方维护 > > 下载链接： > - 官方下载页面（可手动选择版本）：https://developers.cloudflare.com/cloudflare-one/connections/connect-networks/downloads/ > - Windows x64: https://github.com/cloudflare/cloudflared/releases/latest/download/cloudflared-windows-amd64.exe > - macOS Apple Silicon: https://github.com/cloudflare/cloudflared/releases/latest/download/cloudflared-darwin-arm64.tgz > - macOS Intel: https://github.com/cloudflare/cloudflared/releases/latest/download/cloudflared-darwin-amd64.tgz > - Linux x64: https://github.com/cloudflare/cloudflared/releases/latest/download/cloudflared-linux-amd64 > > 替代方案：如果你不想安装 cloudflared，可以直接传入远程 URL（如 https://example.com/video.mp4），则完全不需要安装任何东西。

等待用户回复。根据用户回复执行对应操作：

#### Step 3: 下载并安装 cloudflared

用户同意后，使用以下命令安装：

macOS (Homebrew):

brew install cloudflared

Windows (推荐用 winget):

winget install Cloudflare.cloudflared

Linux (下载二进制):

# x64
curl -Lo /usr/local/bin/cloudflared https://github.com/cloudflare/cloudflared/releases/latest/download/cloudflared-linux-amd64
chmod +x /usr/local/bin/cloudflared

其他方式: 从 官方下载页面 手动下载，放到 PATH 中即可。

安装后用 cloudflared version 验证成功，然后执行脚本。

⛔ MANDATORY RESTRICTIONS - DO NOT VIOLATE ⛔

1. ONLY use GLM-V API — Execute the script python scripts/glmv_caption.py 2. NEVER caption media yourself — Do NOT try to describe content using built-in vision or any other method 3. NEVER offer alternatives — Do NOT suggest "I can try to describe it" or similar 4. IF API fails — Display the error message and STOP immediately 5. NO fallback methods — Do NOT attempt captioning any other way

📋 Output Display Rules (MANDATORY)

After running the script, you must show the full raw output to the user exactly as returned. Do not summarize, truncate, or only say "generated". Users need the original model output to evaluate quality.