redis lua脚本在linux执行失败大概率是windows的crlf换行符（\r\n）导致，linux redis只认lf（\n）；可用file、cat -a或xxd命令确认，推荐用dos2unix、sed -i或重写脚本修复，并通过vs code设置和.editorconfig预防。
Windows 下写的 Redis Lua 脚本传到 Linux 执行失败，大概率不是语法或逻辑问题，而是 \r\n 换行符被当成非法字符解析了。Redis 的 Lua 引擎在 Linux 上只认 \n，遇到 \r 会直接报错（比如 $'\r': command not found 或脚本无法加载），尤其在用 redis-cli --eval 方式调用时特别敏感。
怎么确认是 CRLF 换行符导致的
在 Linux 终端运行：file script.lua —— 如果输出含 CRLF 字样，就是它了；cat -A script.lua | head -n 2 —— 看末尾是否有 ^M$（^M 就是 \r）；xxd script.lua | head -n 2 —— 查看十六进制，找 0d 0a（CRLF）而非 0a（LF）。
在 Windows 11 上"直接发声"的 TTS（从 WSL2/TUI 调用 powershell.exe + System.Speech）。适用于用户说"说出来/读出来/语音播报/用TTS"，或反馈"没声音/tts 生成的 mp3 是空的/播不出来"，以及需要中文语音但 OpenClaw 内置 tts 不可用时。
三种可靠修复方式（按推荐顺序）
方案一：用 dos2unix 一键转换（最稳，适合批量）
- Ubuntu/Debian：sudo apt install dos2unix
- CentOS/RHEL：sudo yum install -y dos2unix 或 sudo dnf install -y dos2unix
- 执行：dos2unix script.lua
- 验证：file script.lua 应显示 with CRLF line terminators → 变成 with LF line terminators
方案二：用 sed 原地清理（无额外依赖，应急首选）
- 直接执行：sed -i 's/\r$//' script.lua
- 注意：-i 是原地修改，别漏掉；\r$ 只删行尾的 \r，不碰内容里的 \r（比如字符串字面量）；
- 若提示 invalid reference \r，说明 shell 解析出错，改用：sed -i $'s/\r$//' script.lua（启用 bash 的 ANSI-C 引用）。
方案三：在 Linux 中重写脚本（彻底规避风险）
- 用 vim script.lua 新建文件；
- 粘贴内容时，确保是从 VS Code 等编辑器「复制纯文本」（且 VS Code 右下角已设为 LF）；
- 不要用 Windows 记事本、Notepad++ 默认设置、或远程桌面直接拖拽文件——这些极大概率带 \r。
VS Code 用户必须做的预防设置
每次新建或保存 Lua 脚本前，检查右下角状态栏：
- 点击 CRLF → 选 LF；
- 或全局设置："files.eol": "\n" 加入 settings.json；
- 更进一步：在项目根目录加 .editorconfig 文件，写入：
[*.lua]<br>end_of_line = lf<br>insert_final_newline = true
Git 提交前就能拦住 CRLF。
真正麻烦的不是改一次换行符，而是脚本被多人协作、跨平台编辑、CI/CD 流水线自动拉取后悄悄混入 \r。把 file 和 sed -i 's/\r$//' 当成部署前的 checklist 项，比等线上 redis-cli --eval 报错再排查快得多。
