Vendor OpenClaw source as Adolf fork baseline

Adolf is a fork/vendored clone of github.com/openclaw/openclaw (v2026.6.11),
free to diverge. Tree copied sans upstream .git; upstream remote added for
future syncs. Node pinned to 24 (.nvmrc); engines already require >=22.19.
Preserves docs/ARCHITECTURE.md.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01LeqyaxJF2nbRXJtae2kNB2

skills/openai-whisper-api/SKILL.md

@@ -0,0 +1,71 @@
+---
+name: openai-whisper-api
+description: "OpenAI Audio Transcriptions API via curl; gpt-4o-transcribe, mini, diarize, or whisper-1."
+homepage: https://platform.openai.com/docs/guides/speech-to-text
+metadata:
+  {
+    "openclaw":
+      {
+        "emoji": "🌐",
+        "requires": { "bins": ["curl", "node"], "env": ["OPENAI_API_KEY"] },
+        "primaryEnv": "OPENAI_API_KEY",
+        "install":
+          [
+            {
+              "id": "brew",
+              "kind": "brew",
+              "formula": "curl",
+              "bins": ["curl"],
+              "label": "Install curl (brew)",
+            },
+          ],
+      },
+  }
+---
+
+# OpenAI transcriptions API
+
+Transcribe audio through `/v1/audio/transcriptions`. Set `OPENAI_BASE_URL` for an OpenAI-compatible proxy or local gateway.
+
+## Quick start
+
+```bash
+{baseDir}/scripts/transcribe.sh /path/to/audio.m4a
+```
+
+Defaults:
+
+- Model: `gpt-4o-transcribe`
+- Output: `<input>.txt`
+
+## Useful flags
+
+```bash
+{baseDir}/scripts/transcribe.sh /path/to/audio.ogg --model gpt-4o-transcribe --out /tmp/transcript.txt
+{baseDir}/scripts/transcribe.sh /path/to/audio.ogg --model gpt-4o-mini-transcribe
+{baseDir}/scripts/transcribe.sh /path/to/audio.ogg --model gpt-4o-transcribe-diarize --json
+{baseDir}/scripts/transcribe.sh /path/to/audio.ogg --model whisper-1
+{baseDir}/scripts/transcribe.sh /path/to/audio.m4a --language en
+{baseDir}/scripts/transcribe.sh /path/to/audio.m4a --prompt "Speaker names: Peter, Daniel"
+{baseDir}/scripts/transcribe.sh /path/to/audio.m4a --json --out /tmp/transcript.json
+```
+
+Notes:
+
+- Supported upload formats include `mp3`, `mp4`, `mpeg`, `mpga`, `m4a`, `wav`, `webm`.
+- 25 MB upload limit on the hosted API.
+- Use diarize for speaker labels; script sends `chunking_strategy=auto` and rejects `--prompt`.
+
+## API key
+
+Set `OPENAI_API_KEY`, or configure it in the active OpenClaw config file (`$OPENCLAW_CONFIG_PATH`, default `~/.openclaw/openclaw.json`). Optionally set `OPENAI_BASE_URL`:
+
+```json5
+{
+  skills: {
+    "openai-whisper-api": {
+      apiKey: "OPENAI_KEY_HERE",
+    },
+  },
+}
+```

skills/openai-whisper-api/scripts/transcribe.sh

@@ -0,0 +1,154 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+usage() {
+  cat >&2 <<'EOF'
+Usage:
+  transcribe.sh <audio-file> [--model gpt-4o-transcribe] [--out /path/to/out.txt] [--language en] [--prompt "hint"] [--json]
+EOF
+  exit 2
+}
+
+if [[ "${1:-}" == "" || "${1:-}" == "-h" || "${1:-}" == "--help" ]]; then
+  usage
+fi
+
+in="${1:-}"
+shift || true
+
+model="gpt-4o-transcribe"
+out=""
+language=""
+prompt=""
+json_output=0
+
+while [[ $# -gt 0 ]]; do
+  case "$1" in
+    --model)
+      model="${2:-}"
+      shift 2
+      ;;
+    --out)
+      out="${2:-}"
+      shift 2
+      ;;
+    --language)
+      language="${2:-}"
+      shift 2
+      ;;
+    --prompt)
+      prompt="${2:-}"
+      shift 2
+      ;;
+    --json)
+      json_output=1
+      shift 1
+      ;;
+    *)
+      echo "Unknown arg: $1" >&2
+      usage
+      ;;
+  esac
+done
+
+if [[ ! -f "$in" ]]; then
+  echo "File not found: $in" >&2
+  exit 1
+fi
+
+if [[ "${OPENAI_API_KEY:-}" == "" ]]; then
+  echo "Missing OPENAI_API_KEY" >&2
+  exit 1
+fi
+
+if [[ "$out" == "" ]]; then
+  base="${in%.*}"
+  if [[ "$json_output" == "1" ]]; then
+    out="${base}.json"
+  else
+    out="${base}.txt"
+  fi
+fi
+
+mkdir -p "$(dirname "$out")"
+
+api_base="${OPENAI_BASE_URL:-https://api.openai.com/v1}"
+api_base="${api_base%/}"
+
+request_format="text"
+if [[ "$json_output" == "1" ]]; then
+  request_format="json"
+fi
+
+diarize=0
+case "$model" in
+  gpt-4o-transcribe | gpt-4o-mini-transcribe | gpt-4o-mini-transcribe-*)
+    request_format="json"
+    ;;
+  gpt-4o-transcribe-diarize)
+    diarize=1
+    request_format="diarized_json"
+    ;;
+esac
+
+if [[ "$diarize" == "1" && "$prompt" != "" ]]; then
+  echo "--prompt is not supported with gpt-4o-transcribe-diarize" >&2
+  exit 2
+fi
+
+target="$out"
+tmp=""
+if [[ "$json_output" == "0" && ( "$request_format" == "json" || "$request_format" == "diarized_json" ) ]]; then
+  tmp="$(mktemp)"
+  trap '[[ "$tmp" == "" ]] || rm -f "$tmp"' EXIT
+  target="$tmp"
+fi
+
+curl_args=(
+  -sS "${api_base}/audio/transcriptions"
+  -H "Authorization: Bearer $OPENAI_API_KEY"
+  -H "Accept: application/json"
+  -F "file=@${in}"
+  -F "model=${model}"
+  -F "response_format=${request_format}"
+)
+if [[ "$language" != "" ]]; then
+  curl_args+=(-F "language=${language}")
+fi
+if [[ "$prompt" != "" ]]; then
+  curl_args+=(-F "prompt=${prompt}")
+fi
+if [[ "$diarize" == "1" ]]; then
+  curl_args+=(-F "chunking_strategy=auto")
+fi
+
+curl "${curl_args[@]}" >"$target"
+
+if [[ "$target" != "$out" ]]; then
+  node -e '
+const fs = require("fs");
+const input = process.argv[1];
+const output = process.argv[2];
+const payload = JSON.parse(fs.readFileSync(input, "utf8"));
+if (Array.isArray(payload.segments)) {
+  const lines = payload.segments
+    .map((segment) => {
+      const text = typeof segment?.text === "string" ? segment.text.trim() : "";
+      if (!text) return "";
+      const speaker = typeof segment?.speaker === "string" ? segment.speaker.trim() : "";
+      return speaker ? `${speaker}: ${text}` : text;
+    })
+    .filter(Boolean);
+  if (lines.length > 0) {
+    fs.writeFileSync(output, lines.join("\n"));
+    process.exit(0);
+  }
+}
+if (typeof payload.text !== "string") {
+  throw new Error("Transcription response missing text");
+}
+fs.writeFileSync(output, payload.text);
+' "$target" "$out"
+fi
+
+echo "$out"