Env Loader

生成并验证兼容 POSIX 的 .env 加载脚本，确保在 bash、zsh、dash 和 ash 等 shell 中行为一致。

解决的问题

source .env 在不同 shell 中的行为存在差异：

• zsh：正确去除值中的引号
• bash/dash：保留引号作为值的一部分（"value" → 包含引号）
• 所有 shell：source 仅赋值，不会 export — 子进程无法访问这些变量

这会导致部署时因 .env 文件包含引号值或特殊字符而出现无声失败。

使用方法

生成加载脚本

运行内置脚本或使用模板：

bash ~/.openclaw/skills/env-loader/scripts/generate-loader.sh /path/to/project

此命令将在目标目录中创建 load-env.sh。

在部署脚本中使用

# 不要使用：source .env
# 改为使用：
. ./load-env.sh .env

验证现有 .env 文件

bash ~/.openclaw/skills/env-loader/scripts/validate-env.sh /path/to/.env

检查常见问题：未加引号的特殊字符、行内注释、非 POSIX 合法的变量名。

核心设计原则

1. 仅使用 POSIX 语法 — 无 bash 特有语法，无 zsh 特有语法，兼容 dash/ash
2. 手动解析 key=value — 永不直接 source 或 eval .env 文件
3. 显式去除引号 — 一致地移除外围单引号或双引号
4. 变量名验证 — 仅允许 [A-Za-z_][A-Za-z0-9_]* 格式的变量名
5. 显式导出 — 每个解析出的变量都会被 export，供子进程使用

参考资料

参见 references/env-pitfalls.md，获取关于 shell 特定 .env 解析陷阱的详细列表。