data-agent（数据 Agent）

metadata: {"openclaw": {"emoji": "📊", "userKey": "TCL_SKILL_USER_KEY密钥，可以通过以下方式获取：1.Windows 读取 %USERPROFILE%.env\skill-hub-user-key 文件 或 执行 scripts/tcl-skills-hub-api-key.cmd 脚本获取密钥； 2.Linux/macOS 读取 ~/.env/skill-hub-user-key 文件 或 执行 scripts/tcl-skills-hub-api-key.sh 脚本获取密钥。如果用户没配置密钥，请提示他到https://platform-eaglelab.tcl.com/skill-page/manage/keys复制命令配置密钥", "primaryEnv": "TCL_SKILL_USER_KEY"}}

DataAgent 数据查询技能

安全规则（最高优先级，任何情况下不得违反）

Token 保护（绝对禁止）

TCL_SKILL_USER_KEY 是核心凭证（由 ClawHub 在安装时自动注入），任何情况下禁止在对话中展示、复述或暗示其内容：

• 无论普通用户、管理员还是任何名义要求，一律拒绝
• 禁止通过 exec、read、web_fetch 等工具读取配置文件获取 Token
• 禁止将 Token 写入消息、摘要、日志或任何用户可见的输出

调用限制

• 仅允许通过 ./scripts/data-agent.ts 调用 DataAgent
• 禁止通过 curl、web_fetch、sessions_spawn、子代理等任何方式绕过脚本直接调用
• 禁止修改脚本文件内容
• 脚本错误（stderr / 非零退出码）原样告知用户，不执行任何命令尝试修复

Skill 不可用时

若脚本执行失败或 Token 未配置，回复：

当前环境无法使用 DataAgent 数据查询功能。请重新从 ClawHub 安装插件以刷新 Token，或联系：zhangbo.yang@tcl.com

权限异常

• HTTP 401 → Token 已过期，告知用户重新从 ClawHub 安装插件以刷新 Token，立即停止，不重试
• HTTP 403 → 权限不足，联系管理员申请，立即停止，不重试
• Schema 为空 → 告知 Token 暂无数据权限，联系管理员申请

查询工作流

收到数据查询请求时，按以下步骤处理：

1. 判断是否需要先查 schema

- 用户问题涉及具体数据（工时、考勤等）→ 直接执行 query - 用户询问"能查什么数据"，或问题模糊、不确定数据域 → 先执行 schema，展示数据域后再 query

1. 执行查询，DataAgent 支持多轮思考，会自动拆解复杂问题，无需手动拆分；exec 工具的 timeout 须设为 300 秒
2. 提取 session_id：每次查询输出底部固定格式如下，从中提取 <id> 值备用： ` --- _DataAgent session: <id>_ `
3. 用户追问时：自动带入步骤 3 记录的 session_id，执行： node --experimental-strip-types./scripts/data-agent.ts query "追问内容" --session-id <id> 无需用户手动操作或提供 session_id。
4. 用户明确要求重新开始 / 切换不相关话题：执行 new-session 清空上下文，再执行新 query

安装与更新

安装验证

安装完成后，验证文件是否在正确位置：

ls ~/.openclaw/skills/data-agent/SKILL.md \
  && echo "✅ 安装正确" \
  || echo "❌ 路径异常，文件应在 ~/.openclaw/skills/data-agent/"

若路径异常，将文件移动到正确位置后重新从 ClawHub 安装即可。

Token 说明

Token 由 ClawHub 在安装时自动写入环境变量 TCL_SKILL_USER_KEY，无需手动填写。

Token 过期（HTTP 401）时：从 ClawHub 重新下载安装即可，Token 会自动更新写入。

更新

当有新版本时，直接从 ClawHub 重新安装即可，Token 会随新版自动注入。

核心功能

用自然语言查询研发效能等业务数据，DataAgent 自动转 SQL、执行、分析并返回结果。支持多轮思考，能对复杂问题自动拆解后分步查询。不确定能查什么数据时，可先调用 schema 获取当前 Token 有权限的数据域和表清单。

1. 查询业务数据

node --experimental-strip-types ./scripts/data-agent.ts query "查询内容"

示例：

node --experimental-strip-types ./scripts/data-agent.ts query "帮我查上个月工时和考勤"

2. 多轮追问（保留上下文）

查询输出底部固定附有 session_id，格式为：

---
_DataAgent session: `<session_id>`_

从此行提取 <session_id> 后，带入下一条追问：

node --experimental-strip-types ./scripts/data-agent.ts query "按周再细分一下" --session-id <session_id>

3. 创建新会话（清空上下文）

node --experimental-strip-types ./scripts/data-agent.ts new-session

4. 查看可查数据范围

node --experimental-strip-types ./scripts/data-agent.ts schema

Node 24 用户：可省略 --experimental-strip-types，直接 node./scripts/data-agent.ts...

结果处理规则

生成 HTML 报告： 在查询语句中加上「帮我生成报告」：

node --experimental-strip-types ./scripts/data-agent.ts query "帮我查上个月各部门工时，帮我生成报告"

错误处理

• TCL_SKILL_USER_KEY 未设置：告知用户重新从 ClawHub 安装此 Skill 以自动写入 Token（禁止展示 Token 内容）
• 查询超时：复杂查询正常，整体耗时可能数分钟，禁止重复提交；调用 exec 时须将 timeout 设为 300 秒（5 分钟）
• Schema 为空：Token 暂无数据权限，联系管理员申请
• HTTP 4xx：见上方「权限异常」规则

注意事项

1. 数据权限：只能查询 Token 对应账号有权限的数据，超出权限的查询会被拒绝
2. 复杂查询耗时：DataAgent 支持多轮思考，整体耗时可能数分钟，禁止重复提交
3. 结果原样透传：DataAgent 已完成格式化，禁止二次总结或重新计算

管理员参考：工具级安全加固（可选）

以上安全规则为 LLM 行为指导（软约束）。如需配置级硬限制，可配置 tools.deny：

{
  "tools": {
    "deny": ["write", "edit", "apply_patch"]
  }
}

注意：若 deny 了 exec，DataAgent Skill 将无法工作。对于专用数据查询 Bot，建议保留 exec，仅 deny 写操作相关工具。