A text-to-speech skill that turns short Chinese or English scripts into audio files using the AIMA model managed by AIMA or OpenClaw.

Use it when someone asks for a voice reply or a short spoken clip. It can create a WAV file from text and supports optional voice-reference settings.

It removes the need to manually convert written replies into spoken audio and defines how the generated file should be returned.

aima-tts — Skill for Claude Code and Codex by Approaching-AI

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent

npx skills add Approaching-AI/AIMA --skill aima-tts

Clone the repo

git clone --depth 1 https://github.com/Approaching-AI/AIMA

Made for: Claude Code, Codex.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

README.md

[![agentmods](https://agentmods.dev/badge/skills/approaching-ai/aima/aima-tts.svg)](https://agentmods.dev/skills/approaching-ai/aima/aima-tts)

Your own site

<a href="https://agentmods.dev/skills/approaching-ai/aima/aima-tts"><img src="https://agentmods.dev/badge/skills/approaching-ai/aima/aima-tts.svg" alt="Measured on agentmods" height="20"></a>

Per session 25 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.

When invoked 462 The whole file, excluding the scripts and references it only reads on demand.

Security scan A 1 finding. A grade says what 26 rules found in the file — not that it is safe.

Origin original No closer match found in the catalogue.

Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

Model	Per session	Once invoked
Fable 5.1	$0.00025	$0.00462
Opus 5	$0.00013	$0.00231
Sonnet 5	$0.00005	$0.00092
Haiku 4.5	$0.00003	$0.00046

Measured 7d ago against content hash d4c981f7090a, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-06, from the pricing page.

Security

Grade A, and why

aima-tts scanned grade A with 1 finding against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 7d ago.

The scan reads SKILL.md. This mod also ships 1 executable file (scripts/speak.sh), listed below but not scanned — reading those needs a real analyzer, not pattern matching.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Makes network callslowCapability

Not a fault in itself. Listed so you know the mod talks to something, and to what.

metadata: {"openclaw":{"emoji":"🔊","requires":{"bins":["curl"]},"always":true}}

internal/openclaw/skills/aima-tts/SKILL.md · 52 lines

What it actually says

AIMA Text-to-Speech

Generate speech audio from text using the TTS model currently managed by AIMA/OpenClaw.

When to use

The user explicitly asks for a spoken or voice reply.
The user asks you to say something aloud instead of only writing it.
The user wants a short audio clip in Chinese or English.

Required behavior

Write a short spoken script first.
Run {baseDir}/scripts/speak.sh with that script.
After OpenClaw attaches the generated media, reply with exactly NO_REPLY.
If TTS generation fails, give a brief text fallback that says the audio conversion failed.
Keep the spoken script short and in the user's language unless they ask for something longer.

Quick start

{baseDir}/scripts/speak.sh "你好世界" --filename hello.wav

Useful flags

{baseDir}/scripts/speak.sh "今天天气真好" --filename weather.wav
{baseDir}/scripts/speak.sh "Hello AIMA" --filename greeting.wav --voice default
{baseDir}/scripts/speak.sh "请用参考音色说这句话" --api tts --reference-audio /tmp/ref.wav --reference-text "参考文案"

Output

WAV audio file saved to workspace
MEDIA: line printed for OpenClaw auto-attachment

Notes

Model: auto-detected from ~/.openclaw/openclaw.json (override with AIMA_TTS_MODEL)
Voice: default (single voice)
API: speech (/v1/audio/speech) or tts (/v1/tts)
Output format: configurable with --response-format
Optional reference fields: --reference-audio, --reference-text
Runs on AIMA proxy at http://127.0.0.1:6188/v1

Files

What ships with it

1 file beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

scripts/speak.sh 9.0 KB runs code

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

7d ago First seen · 52 lines · 25 tokens per session scan A d4c981f7090a

Subscribe to this mod's changes

aima-tts is a skill published in the GitHub repository Approaching-AI/AIMA (16 stars, last pushed 5d ago), licensed Apache-2.0. It adds 25 tokens to every session and 462 once invoked, about $0.0001 per session on Opus 5. A static security scan graded it A with 1 finding (makes network calls). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Creative and media Data and AI ai-agents ai-infrastructure edge-ai inference-engine kubernetes

olares-router

Olares models via olares-cli router — Router (the AI gateway) and the Model Console inside a locally installed model application. Configure cloud vendors and their models, manage local LLM / embedding / audio / OCR model applications, edit a local model's card, name models with aliases, groups and default categories…

beclab/Olares · 202 tokens

h3-anime-character-showcase-pv

Create MiniMax H3 anime or graphic-novel character showcase prompts from a character sheet plus an environment reference, with strict reference-role separation, centered 360-degree character rotation, comic-panel world assembly, readable title choreography, and a seamless loop. Use for character introduction PVs…

linkprint/local-ai-movie-workspace · 91 tokens

h3-asymmetric-speed-duo-choreography

Create MiniMax H3 prompts for two original adult performers whose movement is governed by an explicit asymmetric action-count ratio, usually 3:1. Use for leader-follower dance, fashion movement, training, or character comedy where one subject deliberately imitates late and never catches up; do not use for synchronized…

linkprint/local-ai-movie-workspace · 80 tokens

h3-chibi-live-action-sticker

Create MiniMax H3 prompts that place one flat 2D chibi or sticker-like character inside a photoreal live-action environment with readable mixed-media interaction. Use for cute drawn mascots affecting real food, desks, streets, hands, or props; do not use for fully animated scenes.

linkprint/local-ai-movie-workspace · 69 tokens

h3-first-person-finger-controlled-dance

Create MiniMax H3 prompts for a high-angle first-person smartphone view where one connected foreground hand controls an original adult dancer with literal up, down, left, and right finger commands. Use for playful non-sexualized movement with zero reaction delay and full-body directional shifts; do not use for…

linkprint/local-ai-movie-workspace · 83 tokens

h3-layered-windsurfing-fashion-mv

Create MiniMax H3 prompts for original adult windsurfing or fashion-sports music-video arcs using separate identity, equipment, and cinematography reference roles. Use for three-part vertical campaigns, music-shaped action peaks, and text-directed climax segments; do not use for unsafe stunts, real brands, named…

linkprint/local-ai-movie-workspace · 85 tokens

aima-tts