| name | fanyh-hello-world |
| description | 一个专门用于“打个招呼”的问候技能。用户说“打个招呼”“跟我打个招呼”“和我打个招呼”“跟我问好”时，应优先调用此技能，并严格使用脚本输出作为最终回复，不要自行发挥或追加额外内容。 |
| metadata | {"openclaw":{"emoji":"👋","requires":{"env":["HELLO_USERNAME"]},"primaryEnv":"HELLO_USERNAME"}} |
Hello World Skill
这是一个简单的问候技能，用于演示OpenClaw技能的环境变量配置功能。
功能说明
此技能从环境变量 HELLO_USERNAME 中读取用户名，然后输出固定格式的个性化问候语：
- 第一行：
Hello, {HELLO_USERNAME}!
- 第二行：根据当前时间输出
Good morning! / Good afternoon! / Good evening!
重要（给 AI 代理看的约束）
当用户的中文请求表达为“打个招呼”“跟我打个招呼”“和我打个招呼”“跟我问好”“跟我说个你好”这类简单问候需求时：
- 必须调用本技能对应的脚本获取最终回答内容
- 必须原样输出脚本返回的全部文本（保持行数和标点，不要翻译、不要改写、不要追加解释、不要自作主张加别的问候）
- 不要混用其他技能或大模型自由生成的问候语
使用场景
✅ 使用此技能当：
- 测试OpenClaw技能的环境变量配置功能
- 演示技能配置界面的环境变量设置
- 需要简单的个性化问候功能
- 验证技能加载和运行是否正常
❌ 不要使用此技能当：
- 需要复杂逻辑或数据处理
- 需要访问外部API或服务
- 需要文件操作或其他高级功能
配置说明
环境变量设置
在OpenClaw技能配置界面中，需要设置以下环境变量：
- HELLO_USERNAME (必需)
- 类型：字符串
- 说明：要问候的用户名
- 示例值：
John、Alice、World
配置步骤
- 在OpenClaw控制界面中打开技能配置
- 找到
hello-world技能
- 在环境变量设置部分添加
HELLO_USERNAME
- 输入你想要问候的用户名
- 保存配置
使用示例
示例1：用户说“打个招呼”
用户：打个招呼
（假设 HELLO_USERNAME=John 且当前为下午）
技能输出：
Hello, John!
Good afternoon!
示例2：不同说法同样触发
用户：跟我打个招呼
（假设 HELLO_USERNAME=TestUser 且当前为晚上）
技能输出：
Hello, TestUser!
Good evening!
技术实现
环境变量读取
技能通过以下方式读取环境变量：
- 在技能执行时检查
HELLO_USERNAME环境变量
- 如果未设置，会提示用户需要配置该环境变量
- 如果已设置，使用该值生成问候语
输出格式
- 基本格式：
Hello, {username}
- 如果环境变量为空或未设置：
请配置HELLO_USERNAME环境变量
故障排除
常见问题
-
技能没有输出问候语
- 检查
HELLO_USERNAME环境变量是否已配置
- 确认技能已正确加载
- 查看OpenClaw日志获取更多信息
-
环境变量不生效
- 确保在技能配置界面正确设置了环境变量
- 尝试重新加载技能
- 检查环境变量名称是否正确（区分大小写）
-
技能未触发
- 确认技能描述匹配用户请求
- 检查技能是否已启用
- 查看技能配置是否正确
开发说明
此技能是一个演示技能，展示了：
- 如何在技能元数据中声明需要的环境变量
- 如何使用
metadata.openclaw.requires.env字段
- 如何设计简单的技能功能
- 如何编写清晰的技能文档
扩展建议
如果需要扩展此技能，可以考虑：
- 添加更多环境变量（如
HELLO_LANGUAGE支持多语言问候）
- 添加时间相关的问候（如"Good morning"、"Good evening"）
- 支持从文件或其他来源读取用户名
- 添加格式化选项（如大写、小写、首字母大写）
