Live2d

Live2D 桌面宠物控制 Skill

概述

通过 HTTP API 控制屏幕上的 Live2D 桌面宠物。不杀 llama-server，不需要 sessions_spawn，直接 exec 调用即可。

Bridge 运行在: localhost:19200 (HTTP) + 19201 (WebSocket)

快速开始（一行命令）

# 表情/动作/气泡 三合一
Invoke-WebRequest -Uri "http://localhost:19200/api/emotion?motion=Tap摸头&text=主人~" -Method GET | Out-Null

# 只发气泡
Invoke-WebRequest -Uri "http://localhost:19200/api/message?text=こんにちは" -Method GET | Out-Null

先决条件

若 bridge 未在线（/api/status 不可达），启动它：

try { Invoke-WebRequest -Uri "http://localhost:19200/api/status" -TimeoutSec 2 -UseBasicParsing | Out-Null } catch { Start-Process -FilePath node -ArgumentList "live2d-bridge.mjs" -WorkingDirectory "$env:USERPROFILE\.openclaw\workspace\live2d" -WindowStyle Hidden; Start-Sleep -Seconds 2 }

API 速查

👩 Motion 速查表（按角色）

四季夏目 (natsume) — 当前默认角色

每个 motion group 有多个变体（如 Tap外框_00 ~ Tap外框_06），用 group 名即可自动随机选变体播放。 Idle 后台也会自动随机播放 Idle_00 ~ Idle_06。

亚托莉 (atri)

ATRI 只有 3 个 motion 组（已验证）：

Expression 文件 16 组（Expressions_0 ~ Expressions_15），前端未做 expression 路由。

⚠️ voice 组 620 个只有 mp3 无动画 JSON，hair+face 只有 8 个动画。功能严重受限，强烈建议用夏目模型。

Enola

暂未配置 Enola Live2D 模型。

对话中情绪 → Motion 映射

调用模板

# 单次情绪+动作+气泡（最常用）
Invoke-WebRequest -Uri "http://localhost:19200/api/emotion?motion=Tap摸头&text=主人~" -Method GET | Out-Null

# 只动不说
Invoke-WebRequest -Uri "http://localhost:19200/api/motion?name=Tap外框" -Method GET | Out-Null

# 只说不动
Invoke-WebRequest -Uri "http://localhost:19200/api/message?text=主人今天想做什么？" -Method GET | Out-Null

# 登场+欢迎
Invoke-WebRequest -Uri "http://localhost:19200/api/emotion?motion=Start&text=おかえりなさい、主人！" -Method GET | Out-Null

TTS + Live2D 口型联动

# 1. 开嘴
Invoke-WebRequest -Uri "http://localhost:19200/api/speak?action=start&text=主人" -Method GET | Out-Null
# 2. spawn TTS...
# 3. TTS done → 闭嘴
Invoke-WebRequest -Uri "http://localhost:19200/api/speak?action=end" -Method GET | Out-Null

角色切换

# 夏目
powershell -ExecutionPolicy Bypass -File "$env:USERPROFILE\.openclaw\workspace\live2d\switch_model.ps1" natsume

# 亚托莉
powershell -ExecutionPolicy Bypass -File "$env:USERPROFILE\.openclaw\workspace\live2d\switch_model.ps1" atri

切换后需刷新浏览器中的 index.html。

故障排查