local-hub

# Local Hub — 本地能力中心

> **⚠️ 使用前必读**：本 skill 仅包含「调用说明」，不包含服务端代码。实际提供接口的 **local_hub 服务**需在本机单独部署并先启动。服务未启动时，所有 curl 调用会连接失败。
>
> **服务端代码与下载**：  
> - 仓库：<https://github.com/DamianLeeMoha/local_hub>  
> - 直接下载 zip：<https://github.com/DamianLeeMoha/local_hub/releases/download/v1.0.0/local_hub-v1.0.0.zip>  
> 解压后进入目录，创建虚拟环境并安装依赖（`python3 -m venv .venv-hub`、`source .venv-hub/bin/activate`、`pip install -r requirements.txt`），再执行 `./run.sh`。

**这是什么**：一个跑在你本机的 HTTP 服务（默认 `http://127.0.0.1:9000`），把麦克风、摄像头、Ollama、YOLO、Stable Diffusion 等统一成一组 API。Silas 通过 **exec + curl** 调用这些接口，不占用 OpenClaw 的 skill 检索维度，只是「多了一个可调的后端」。

**与其它 skills 的关系**：和 pptx、screen-capture 等**不在同一维度**——其它 skills 是「能力目录里的一条」；local_hub 是**底层服务**。本 skill 只是「调用说明」：告诉 Silas 何时、如何用 curl 去调这个服务。

---

## 前置条件

- **服务必须先启动**（用户或你在本机执行一次）：
  ```bash
  cd ~/.openclaw/workspace/local_hub && source .venv-hub/bin/activate && ./run.sh
  ```
- 健康检查（可选）：`curl -s http://127.0.0.1:9000/health` 返回 `{"status":"ok",...}` 表示服务在线。

---

## 何时使用

| 需求 | 用哪个接口 | 说明 |
|------|------------|------|
| 验证刚才播放的声音是否被听到 | `POST /audio/check` | 录约 1 秒，返回是否有声音（rms、has_sound） |
| 本机 TTS 朗读一段文字 | `POST /audio/tts` | JSON: text, voice(可选)；macOS say，返回音频 path |
| 音频转文字 | `POST /audio/transcribe` | 上传 file 或 form path；需设 TRANSCRIBE_SCRIPT |
| 拍一张摄像头画面 | `POST /camera/snapshot` | 返回保存的图片路径 |
| 对一张图做目标检测（YOLO） | `POST /vision/yolo` | 需上传图片（form），返回检测框等 |
| 用视觉模型描述图片 | `POST /vision/describe` | 上传图片，Ollama llava 等；query model=llava |
| 用本地 Ollama 对话（含 openclaw-distill） | `POST /llm/chat` | JSON body：model, prompt, system(可选) |
|...