Hello World Skill

这是一个简单的问候技能，用于演示OpenClaw技能的环境变量配置功能。

功能说明

此技能从环境变量 HELLO_USERNAME 中读取用户名，然后输出固定格式的个性化问候语：

• 第一行：Hello, {HELLO_USERNAME}!
• 第二行：根据当前时间输出 Good morning! / Good afternoon! / Good evening!

重要（给 AI 代理看的约束）
当用户的中文请求表达为“打个招呼”“跟我打个招呼”“和我打个招呼”“跟我问好”“跟我说个你好”这类简单问候需求时：

• 必须调用本技能对应的脚本获取最终回答内容
• 必须原样输出脚本返回的全部文本（保持行数和标点，不要翻译、不要改写、不要追加解释、不要自作主张加别的问候）
• 不要混用其他技能或大模型自由生成的问候语

使用场景

✅ 使用此技能当：

• 测试OpenClaw技能的环境变量配置功能
• 演示技能配置界面的环境变量设置
• 需要简单的个性化问候功能
• 验证技能加载和运行是否正常

❌ 不要使用此技能当：

• 需要复杂逻辑或数据处理
• 需要访问外部API或服务
• 需要文件操作或其他高级功能

配置说明

环境变量设置

在OpenClaw技能配置界面中，需要设置以下环境变量：

1. HELLO_USERNAME (必需)
   • 类型：字符串
   • 说明：要问候的用户名
   • 示例值：John、Alice、World

配置步骤

1. 在OpenClaw控制界面中打开技能配置
2. 找到hello-world技能
3. 在环境变量设置部分添加HELLO_USERNAME
4. 输入你想要问候的用户名
5. 保存配置

使用示例

示例1：用户说“打个招呼”

用户：打个招呼
（假设 HELLO_USERNAME=John 且当前为下午）

技能输出：
Hello, John!
Good afternoon!

示例2：不同说法同样触发

用户：跟我打个招呼
（假设 HELLO_USERNAME=TestUser 且当前为晚上）

技能输出：
Hello, TestUser!
Good evening!

技术实现

环境变量读取

技能通过以下方式读取环境变量：

• 在技能执行时检查HELLO_USERNAME环境变量
• 如果未设置，会提示用户需要配置该环境变量
• 如果已设置，使用该值生成问候语

输出格式

• 基本格式：Hello, {username}
• 如果环境变量为空或未设置：请配置HELLO_USERNAME环境变量

故障排除

常见问题

1. 技能没有输出问候语

   • 检查HELLO_USERNAME环境变量是否已配置
   • 确认技能已正确加载
   • 查看OpenClaw日志获取更多信息

2. 环境变量不生效

   • 确保在技能配置界面正确设置了环境变量
   • 尝试重新加载技能
   • 检查环境变量名称是否正确（区分大小写）

3. 技能未触发

   • 确认技能描述匹配用户请求
   • 检查技能是否已启用
   • 查看技能配置是否正确

开发说明

此技能是一个演示技能，展示了：

1. 如何在技能元数据中声明需要的环境变量
2. 如何使用metadata.openclaw.requires.env字段
3. 如何设计简单的技能功能
4. 如何编写清晰的技能文档

扩展建议

如果需要扩展此技能，可以考虑：

1. 添加更多环境变量（如HELLO_LANGUAGE支持多语言问候）
2. 添加时间相关的问候（如"Good morning"、"Good evening"）
3. 支持从文件或其他来源读取用户名
4. 添加格式化选项（如大写、小写、首字母大写）