Fanyh Helloworld

---
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技能配置界面中，需要设置以下环境变量：

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. 添加格式化选项（如大写、小写、首字母大写）