← Back to Skills Marketplace
193
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install feishu-cron-setup
Description
设置飞书定时任务投递，确保 cron 任务能稳定地将结果发送到飞书。当需要创建、修复或调试飞书频道的定时任务时使用此技能，特别是当 cron 任务执行成功但消息无法投递到飞书时。
README (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>
Usage Guidance
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.
Capability Analysis
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.
Capability Assessment
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.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install feishu-cron-setup - After installation, invoke the skill by name or use
/feishu-cron-setup - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
feishu-cron-setup 1.0.0 - Initial release
- 提供设置飞书定时任务投递的详细方法和故障排查指南
- 明确 isolated session 下需显式指定 --account 参数才能投递消息到飞书
- 补充命令示例和关键参数说明
- 集成常见错误的原因和解决方法
- 提供任务投递验证流程和 open_id 查找方法
Metadata
Frequently Asked Questions
What is 定时任务投递skill?
设置飞书定时任务投递，确保 cron 任务能稳定地将结果发送到飞书。当需要创建、修复或调试飞书频道的定时任务时使用此技能，特别是当 cron 任务执行成功但消息无法投递到飞书时。 It is an AI Agent Skill for Claude Code / OpenClaw, with 193 downloads so far.
How do I install 定时任务投递skill?
Run "/install feishu-cron-setup" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is 定时任务投递skill free?
Yes, 定时任务投递skill is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does 定时任务投递skill support?
定时任务投递skill is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created 定时任务投递skill?
It is built and maintained by Nicccmy (@nicccmy); the current version is v1.0.0.
More Skills