钉钉考勤数据获取技能
功能描述
定时从钉钉开放平台获取员工考勤数据，并保存到本地或推送到指定渠道。
配置步骤
1. 钉钉开放平台配置
- 访问 https://open.dingtalk.com
- 创建企业内部应用
- 获取 AppKey 和 AppSecret
- 添加应用权限：
- 考勤管理权限
- 通讯录权限（获取员工信息）
- 企业管理员审批授权
2. 本地配置
复制 .env.example 为 .env 并填写：
DINGTALK_APP_KEY=你的 AppKey
DINGTALK_APP_SECRET=你的 AppSecret
DINGTALK_AGENT_ID=应用的 agentId
OUTPUT_DIR=./data/attendance
OUTPUT_FORMAT=json
执行规则：
- 仅使用技能目录下的
.env读取凭证与输出配置。 - 不依赖
config.json。 - 若
.env已存在且字段完整，直接执行，不要重复要求用户在对话中提供凭证。
建议先做本地自检：
- 确认
.env文件在本技能根目录，与index.js同级。 - 确认包含
DINGTALK_APP_KEY和DINGTALK_APP_SECRET。 - 确认从本技能目录执行
node index.js（避免在其他目录启动导致找错文件）。
Windows PowerShell 示例：
Copy-Item .env.example .env
node index.js
macOS/Linux 示例：
cp .env.example .env
node index.js
3. 安装依赖
npm install axios moment
使用方法
手动运行
cd keplerjai-dingtalk-attendance
node index.js
定时任务（推荐）
在 OpenClaw 中配置 cron 任务，每天自动获取前一天的考勤数据。
输出数据
- 打卡记录（JSON/CSV）
- 考勤日报/月报
- 异常考勤提醒
注意事项
- API 调用有频率限制，建议定时获取而非实时
- 需要企业管理员授权
- 敏感数据请妥善保管
Agent 执行约定
- 先读取本技能目录下的
.env再执行任务。 - 若缺少必要字段，仅提示“本地
.env缺少必填项”，不要要求用户在聊天中粘贴密钥。 - 默认返回考勤结果与输出文件位置，不回显任何密钥值。