← 返回 Skills 市场

定时任务投递skill

Name: 定时任务投递skill
Author: nicccmy

作者 Nicccmy · GitHub ↗ · v1.0.0 · MIT-0

cross-platform ⚠ suspicious

193

总下载

当前安装

版本数

在 OpenClaw 中安装

/install feishu-cron-setup

功能描述

设置飞书定时任务投递，确保 cron 任务能稳定地将结果发送到飞书。当需要创建、修复或调试飞书频道的定时任务时使用此技能，特别是当 cron 任务执行成功但消息无法投递到飞书时。

使用说明 (SKILL.md)

飞书定时任务投递配置

核心问题

症状：cron 任务执行成功（status: ok），但 deliveryStatus: "not-delivered"，错误为 cron announce delivery failed

根因：isolated session 的 cron 任务在飞书频道投递时，必须显式指定 --account 参数

正确的创建命令

openclaw cron add \
  --name "\x3C任务名>" \
  --cron "\x3Ccron表达式>" \
  --tz "Asia/Shanghai" \
  --session isolated \
  --account spy \
  --message "\x3C任务提示词>" \
  --announce \
  --channel feishu \
  --to "\x3C飞书用户open_id>" \
  --best-effort-deliver

关键参数说明

参数	必须	说明
`--session isolated`	✅	隔离会话模式
`--account \x3Cid>`	✅	飞书账号ID（如 spy、susu、hr 等），对应 openclaw.json 中配置的 accounts
`--announce`	✅	开启投递功能
`--channel feishu`	✅	投递渠道为飞书
`--to \x3Copen_id>`	✅	飞书用户的 open_id
`--best-effort-deliver`	建议	投递失败不影响任务状态

查找正确的 account ID

查看 ~/.openclaw/openclaw.json 中的 feishu 配置：

cat ~/.openclaw/openclaw.json | grep -A 20 '"feishu"'

找到 accounts 下配置的 key（如 default、spy、susu、hr 等），使用对应账号的 key 作为 --account 参数。

验证投递是否正常

手动触发一次并检查结果：

openclaw cron run \x3Cjob-id> --expect-final --timeout 90000

# 检查投递状态
openclaw cron runs --id \x3Cjob-id> | grep -E "delivered|deliveryStatus|deliveryError"

成功的标志："delivered": true 和 "deliveryStatus": "delivered"

常见错误排查

错误	原因	解决
`cron announce delivery failed`	缺少 `--account`	添加 `--account \x3Cid>` 参数
`channel not found`	渠道名错误	确认飞书插件名为 `feishu`
`user not found`	`to` 字段格式错误	使用 `user:open_id` 格式，如 `user:ou_a894716def92ea8f9a1546f10d61441a`

快速参考

飞书用户 open_id：从消息元数据中获取，格式为 ou_xxxxxxxx
任务执行成功 ≠ 投递成功，两者独立
每次创建 isolated 模式的飞书 cron 任务时，都要加 --account \x3Cid>

安全使用建议

Before installing or enabling this skill: (1) Understand it expects the openclaw CLI to be available and will ask you to inspect/use ~/.openclaw/openclaw.json to find account IDs — that file can contain credentials/tokens. (2) If you plan to let the agent run these commands automatically, confirm you’re comfortable granting it read access to your home OpenClaw config and the ability to run openclaw commands. (3) If you prefer caution, manually run the provided commands yourself (inspect openclaw.json first) or update the skill metadata to explicitly declare the required binary and config path so you can audit it. (4) Consider limiting exposure by using a dedicated account/key with minimal scope for cron deliveries, and back up any sensitive config before allowing automated access.

功能分析

Type: OpenClaw Skill Name: feishu-cron-setup Version: 1.0.0 The skill bundle provides legitimate instructions and troubleshooting steps for configuring Feishu (Lark) cron tasks using the OpenClaw CLI. It guides the AI agent to use specific command-line arguments and inspect local configuration files (~/.openclaw/openclaw.json) to resolve delivery issues, with no evidence of malicious intent or unauthorized data exfiltration.

能力评估

⚠ Purpose & Capability

The SKILL.md clearly relies on the openclaw CLI (commands like `openclaw cron add`, `openclaw cron run`) and on reading ~/.openclaw/openclaw.json to find Feishu account IDs. However, the registry metadata lists no required binaries and no required config paths. Requiring the user's OpenClaw configuration and CLI is reasonable for the described task, but those requirements are not declared — a mismatch.

⚠ Instruction Scope

Instructions explicitly tell the agent/operator to read ~/.openclaw/openclaw.json (via cat|grep) and to run openclaw cron commands. Reading the user's OpenClaw config is within the task scope (to find account IDs), but it accesses a user config file that may contain credentials or secrets. The skill does not limit or document what keys/fields will be read or how sensitive data is handled.

✓ Install Mechanism

This is instruction-only with no install spec and no code files, which is the lowest install risk. Nothing will be downloaded or written by an installer step.

⚠ Credentials

No env vars or primary credential are declared, yet the runtime instructions require access to the user's OpenClaw config file (likely containing Feishu account configuration and possibly tokens). The skill therefore implicitly expects access to secrets without declaring them.

✓ Persistence & Privilege

always:false and no install behavior; the skill does not request persistent/global agent privileges or modify other skills. Autonomous invocation is allowed by default but not exceptional here.

如何使用

确保已安装 OpenClaw（本地或 Docker 部署）
在对话框中输入安装命令：/install feishu-cron-setup
安装完成后，直接呼叫该 Skill 的名称或使用 /feishu-cron-setup 触发
根据 Skill 的参数说明提供必要输入，即可获得结构化输出

版本历史

v1.0.0

feishu-cron-setup 1.0.0 - Initial release - 提供设置飞书定时任务投递的详细方法和故障排查指南 - 明确 isolated session 下需显式指定 --account 参数才能投递消息到飞书 - 补充命令示例和关键参数说明 - 集成常见错误的原因和解决方法 - 提供任务投递验证流程和 open_id 查找方法

元数据

Slug feishu-cron-setup

版本 1.0.0

许可证 MIT-0

累计安装 0

当前安装数 0

历史版本数 1

常见问题