← 返回 Skills 市场
senseaudio-game-npc-director
作者
Wu Ruixiao
· GitHub ↗
· v1.0.1
· MIT-0
248
总下载
0
收藏
0
当前安装
2
版本数
在 OpenClaw 中安装
/install senseaudio-game-npc-director
功能描述
Use when a game, interactive story, or virtual world needs reusable NPC voice behavior, including fixed voice identity, catchphrases, relationship-aware dial...
安全使用建议
Before installing or enabling this skill, verify the following: (1) Confirm which environment variables and config files you must provide — the code expects SENSEAUDIO_API_KEY and/or SENSEAUDIO_PLATFORM_TOKEN, an ASR model env, and a Feishu app_id/app_secret stored in a workspace config, but the registry metadata lists none. (2) Ask the publisher where the _shared helper modules come from (senseaudio_env, audioclaw_paths, senseaudio_api_guard) and the audioclaw-skills-voice-reply feishu helper; these are not included and will be imported from the host environment. (3) Understand that the skill will send audio to external endpoints (api.senseaudio.cn, platform.senseaudio.cn, open.feishu.cn) and will upload/transcode audio — do not supply sensitive audio or credentials unless you trust the endpoints and code. (4) If you cannot confirm the provenance of the missing helpers and the required credentials, run the skill only in an isolated environment or decline installation. If you decide to proceed, ask the maintainer to update the registry metadata to declare required env vars and config paths and to include or document any dependent helper packages.
功能分析
Type: OpenClaw Skill
Name: senseaudio-game-npc-director
Version: 1.0.1
The skill bundle is a comprehensive toolkit for creating game NPC voice interactions using SenseAudio ASR/TTS and Feishu for delivery. The scripts (e.g., batch_tts_scene.py, senseaudio_asr.py) perform legitimate network requests to official API endpoints (api.senseaudio.cn) and handle local file operations for audio processing. While the orchestrator (run_player_voice_npc_pipeline.py) uses subprocesses and accesses a specific credential file (~/.audioclaw/workspace/state/senseaudio_credentials.json), these actions are transparently documented and strictly aligned with the functional requirements of the NPC director role.
能力评估
Purpose & Capability
The scripts and SKILL.md implement NPC voice generation, ASR, TTS, and Feishu delivery which matches the skill description. However, the registry metadata lists no required env vars or config paths even though the implementation clearly expects API keys, platform tokens, and host helper modules.
Instruction Scope
Runtime instructions and scripts call external services (SenseAudio ASR/TTS endpoints, Feishu open API), transcode and upload audio, and load helper modules from parent _shared directories and another skill (audioclaw-skills-voice-reply). They also read workspace/config files via audioclaw_paths. The SKILL.md and registry do not disclose these file/config dependencies or the exact credentials used, giving the agent access to external networks and workspace configs beyond what's declared.
Install Mechanism
No install spec is provided (instruction + scripts only), so nothing arbitrary is downloaded at install time. This lowers install-time risk. The code will run at runtime and import helper modules from the host environment.
Credentials
The code uses SENSEAUDIO_API_KEY, SENSEAUDIO_PLATFORM_TOKEN, SENSEAUDIO_ASR_MODEL (and an api-key-env argument), and expects Feishu app credentials/config (app_id/app_secret) via a workspace config — none of these were declared in the registry metadata. Requiring platform API keys and tenant credentials is normal for ASR/TTS and Feishu features, but the omission in metadata is an incoherence that could lead to surprise credential usage or accidental credential leakage.
Persistence & Privilege
The skill is not marked always:true and does not modify other skills' configurations. It does import shared modules from parent directories, but there is no evidence it attempts to persist itself or alter system-wide agent settings.
如何使用
- 确保已安装 OpenClaw（本地或 Docker 部署）
- 在对话框中输入安装命令：
/install senseaudio-game-npc-director - 安装完成后，直接呼叫该 Skill 的名称或使用
/senseaudio-game-npc-director触发 - 根据 Skill 的参数说明提供必要输入，即可获得结构化输出
版本历史
v1.0.1
- Major terminology update: "SenseAudio" renamed to "AudioClaw" throughout all user-facing documentation and skill descriptions.
- `scripts/run_player_voice_npc_pipeline.py` now supports both `--input-audio` and `--input-text`, enabling seamless NPC reply generation from either player speech or text.
- NPC voice reply mode now defaults to voice/audio unless the user explicitly requests text-only output.
- Detailed session management and reply mode logic clarified, ensuring NPC dialogue mode stays "sticky" for ongoing turns.
- API key lookup and injection updated: TTS scripts now default to using `SENSEAUDIO_API_KEY`, with improved logic for real API key substitution during voice synthesis. ASR script behavior remains unchanged.
v1.0.0
Initial release of senseaudio-game-npc-director.
- Enables reusable, fixed-identity NPC voice generation for games and interactive worlds using SenseAudio.
- Supports relationship-aware dialogue, catchphrases, event-based lines, world narration, and ASR-driven NPC reactions to player speech.
- Provides scripts for scene building, player voice intake, TTS synthesis, and audio delivery to platforms like Feishu.
- Maintains session state for each NPC, supporting dynamic player interaction and voice switching.
- Focuses on low-cost, high-immersion NPC voice assets, suitable for both static assets and fully interactive voice experiences.
元数据
常见问题
senseaudio-game-npc-director 是什么？
Use when a game, interactive story, or virtual world needs reusable NPC voice behavior, including fixed voice identity, catchphrases, relationship-aware dial... 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件，目前累计下载 248 次。
如何安装 senseaudio-game-npc-director？
在 OpenClaw 或 Claude Code 对话框中运行命令「/install senseaudio-game-npc-director」即可一键安装，无需额外配置。
senseaudio-game-npc-director 是免费的吗？
是的，senseaudio-game-npc-director 完全免费，采用 MIT-0 许可证，可自由下载、安装和使用。
senseaudio-game-npc-director 支持哪些平台？
senseaudio-game-npc-director 跨平台运行，可在任意部署了 OpenClaw / Claude Code 的环境中使用（cross-platform）。
谁开发了 senseaudio-game-npc-director？
由 Wu Ruixiao（@kikidouloveme79）开发并维护，当前版本 v1.0.1。
推荐 Skills