← Back to Skills Marketplace
263
Downloads
2
Stars
0
Active Installs
15
Versions
Install in OpenClaw
/install smart-keepalive
Description
Automatically fetches RSS headlines, generates styled smart reports via OpenClaw, and supports optional wellness notes plus launchd/cron scheduling helpers.
Usage Guidance
This skill appears to do what it claims. Before installing or enabling it: 1) review and decide where you want local state/log files (default ~/.smart-keepalive) and ensure you are comfortable with unlimited append-to-audit-log behavior; 2) only set KEEPALIVE_AGENT_COMMAND / KEEPALIVE_SEND_COMMAND to trusted commands/scripts because those environment variables allow arbitrary shell execution; 3) if you use the OpenClaw CLI integration, be aware the script will invoke the CLI and may read the local OpenClaw config/IDENTITY.md to obtain the agent name; 4) the provided --install-cron / --install-launchd helpers will create scheduled tasks if you run them — verify the generated cron/plist before activating. If you want extra assurance, inspect the full smart-keepalive.py file locally and run it in a contained environment (or with dry-run/--doctor) before granting it recurring execution.
Capability Analysis
Type: OpenClaw Skill
Name: smart-keepalive
Version: 0.1.5
The Smart Keepalive skill bundle is designed to fetch news from RSS feeds (e.g., Zhihu, Xinhua, 36kr) and weather data from the National Meteorological Center (nmc.cn) to generate scheduled briefings. It utilizes an AI agent to format these briefings based on templates in the `prompts/` directory and sends them via the OpenClaw CLI. While the Python script (`smart-keepalive.py`) includes capabilities to execute shell commands via environment variables like `KEEPALIVE_AGENT_COMMAND` and `KEEPALIVE_SEND_COMMAND`, these are documented features for extensibility and integration with other environments like Hermes. The markdown instructions and code logic are consistent with the stated purpose, and there is no evidence of data exfiltration, malicious persistence, or harmful prompt injection.
Capability Assessment
Purpose & Capability
Name/description (RSS headlines → styled keepalive reports + optional scheduling) matches the included Python and shell scripts and the prompts. The script implements RSS fetching, weighting/rotation logic, state file and audit log management, and calls to 'openclaw agent' / 'openclaw message send' or user-provided send/agent commands as described. No unrelated cloud credentials, platform-level access, or unrelated binaries are required.
Instruction Scope
SKILL.md and prompt files precisely describe the formatting and pipeline. The runtime instructions and scripts read/write only local files (state under ~/.smart-keepalive, optional logs, and local skill config), call the OpenClaw CLI (or custom commands via KEEPALIVE_AGENT_COMMAND / KEEPALIVE_SEND_COMMAND), and may read OpenClaw config/IDENTITY.md for agent name. These behaviors are consistent with the purpose. Note: the skill permits arbitrary custom shell commands via environment variables — that feature is intentional for Hermes integration but grants the operator the ability to run arbitrary commands if they set those vars.
Install Mechanism
No install spec or remote downloads are present; this is an instruction-plus-local-scripts package. All code is included; nothing is fetched from external arbitrary URLs during install. That's low-risk and consistent with a script-based skill.
Credentials
The skill declares no required environment variables or credentials (primary credential: none). The code references many optional environment variables (KEEPALIVE_* family, OPENCLAW_BIN, OPENCLAW_CONFIG, PATH, NVM_DIR) to configure behavior. This is proportionate to configurability, but be aware that setting KEEPALIVE_AGENT_COMMAND or KEEPALIVE_SEND_COMMAND gives that command full ability to run arbitrary shell code at runtime (expected for integration but a potential risk if you set those variables to untrusted values). The skill does read local OpenClaw config/IDENTITY.md if available (for agent name), which is reasonable for its messaging purpose but means it may access local agent configuration files.
Persistence & Privilege
always:false and no elevated privileges requested. The script writes its own state/log files under the user's home and can generate launchd/cron entries if you run the provided install options; this is expected for a scheduling helper. It does not modify other skills or system-wide agent settings beyond its own files unless you explicitly run its install commands.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install smart-keepalive - After installation, invoke the skill by name or use
/smart-keepalive - Provide required inputs per the skill's parameter spec and get structured output
Version History
v0.1.5
smart-keepalive v0.1.5
- 文档叙述全面移除“RSS”提及，统一为“资讯素材”“信息源”；更好兼容自定义内容源、泛用聚合平台。
- SKILL.md 样例内容与表格更新，反映内容源已不限于 RSS/RSSHub，权重池与兜底说明同步精简。
- prompts/rewrite-main.md 同步视角调整，将所有“RSS 热点”/“RSS 热榜”描述换为中性的“资讯素材”。
- 不影响 skill 配置及脚本主逻辑，仅调整说明与提示用语。
v0.1.4
smart-keepalive 0.1.4
- Improved fallback handling: when rewriting or agent calls fail, script now guarantees fallback outputs to stderr for clearer debugging.
- Enhanced fallback output format to include theme information (`theme_tag`) in logs.
- Minor documentation updates in SKILL.md for greater clarity regarding fallback logic and script responsibilities.
- No breaking changes to core workflow or external interfaces.
v0.1.3
smart-keepalive v0.1.3
- Improved README and documentation for accuracy and clarity.
- Enhanced details in SKILL.md to better describe pipeline, functions, and selection logic.
- No behavioral changes to core logic or functionality.
v0.1.2
smart-keepalive v0.1.2
- Central Meteorological Observatory "daily weather tips" (`nmc-weather-daily`) is now only used as a supplementary line for city weather, not involved in main sampling or weighting logic.
- Updated documentation in SKILL.md to clarify base weights and which sources participate in main sampling.
- No changes to the main logic or pipeline sequence; impact is only on weighting, documentation, and user expectations.
v0.1.1
smart-keepalive 0.1.1
- 新增“中央气象台每日天气提示”数据源，基准权重调整为每源 0.09，合计 0.90。
- 扩展热点兜底候选源，纳入中央气象台每日天气提示。
- SKILL.md 与脚本权重分布、数据源同步修改，文档细节完善。
- 调整加权池说明，表格与名称与最新版脚本保持一致。
v0.1.0
smart-keepalive v0.1.0
- 新增 Hermes/其他环境兼容：支持通过 KEEPALIVE_AGENT_COMMAND/KEEPALIVE_SEND_COMMAND 接入非 OpenClaw 发送与润色（如 Hermes 环境）。
- SKILL.md 增加 Hermes 兼容说明，支持自定义 CLI 路由（KEEPALIVE_CLI_BIN）。
- 默认使用 OpenClaw CLI，现可灵活切换到自定义命令，无需依赖 openclaw agent/message send。
- 脚本和文档更新，更清楚区分环境变量与角色分工，方便定制自动简报推送。
- 无 breaking change，原 OpenClaw 用法无影响，新增自定义路径。
v0.0.31
- 调整基准权重分布：主数据源各自权重从 0.09 提升至 0.10，去除纽约时报 dual 数据源。
- 移除纽约时报 dual 源及相关处理逻辑，优化热点池与轮换顺序。
- 更新兜底与热点链路，主序列不再包含不可用或已移除渠道。
- 文档（SKILL.md）同步权重、数据源说明与参数表，保证表述与代码实际逻辑一致。
v0.0.30
**重大更新：RSS 源池重构，适配 2024 失效源并提升容量。**
- 移除大部分失效或中断的 RSS 源（如联合早报、微博热搜、BBC 中文、华尔街日报等）。
- 新增、重排核心内容源，默认加权池现包含 NYT、知乎日报、南方周末、新华社、每日环球视野、少数派、36氪、法广、果壳等十路线。
- 热点兜底与主推池均已同步，主题路线与权重表已全量调整。
- RSSHub 实例同步精简，移除不可用公实例。
- 文档说明、源权重、源标签与脚本完整对齐。
v0.0.29
**Changelog for smart-keepalive v0.0.29**
- Major update: Overhauled brief selection logic for more diversity and auditability.
- RSS简报抽样机制升级为“去重+多重权重加权+盲盒”，支持每日素材唯一、时段/天气/节假日智能加权，提升内容多样性。
- 新增详细状态主文件与审计日志（brief-sources.json、audit.log），日志结构及路径可配，提升可溯性。
- SKILL.md 说明同步：更新并细化技术与交互文档，明确脚本与提示词分工、每日去重/轮换/盲盒等机制，供用户和Agent查阅。
- 支持关闭/调整盲盒、去重、时段权重等策略的环境变量，更多自定义选项。
- 调整简报兜底热点池机制，统一多轮乱序抽样及轮数限制，提升稳定性。
v0.0.28
smart-keepalive v0.0.28
- 明确文档描述了简报素材的随机选择比例与数据源（SKILL.md）。
- 补充了 build_keepalive_brief() 随机区间、各数据源占比、日志 theme_tag 等细节说明。
- 详细列出热点兜底（run_theme(4)）的数据流与流程。
- SKILL.md 文档其余部分保持未变，核心逻辑不变。
- 无破坏性更改，现有用法兼容。
v0.0.27
- 文末状态彩蛋（status-footer）提示词现已要求 assistant 以 `IDENTITY.md` 中的 `NAME` 作为助手自称。
- 新增环境变量 `KEEPALIVE_AGENT_NAME`，用于强制覆盖 agent 名称（默认会从 `~/.openclaw/agents/<agentId>/IDENTITY.md` 读取）。
- 脚本与提示词已适配上述 agent 名自动注入。
v0.0.26
**Adds status footer and config options for end-of-message state.**
- New: Adds `prompts/status-footer.md` and auto-generates a one-line "status footer" (可选文末状态彩蛋) at the end of each keepalive brief via `openclaw agent`, with fallback/override options.
- New: Supports `KEEPALIVE_STATUS_FOOTER` environment variable to provide a fixed status line or disable the footer entirely.
- New: Supports `KEEPALIVE_STATUS_STYLE_GUIDE` environment variable to fine-tune status footer tone.
- Updated main message format: status message control and new "second line" greeting/section logic (see SKILL.md for exact layout).
- Updated documentation describing new footer, message format changes, and related environment variables.
v0.0.25
- Added "保活与状态检查（给 Agent 的提示）" section to SKILL.md, providing troubleshooting advice and guideline examples for health/status reporting in keepalive messages.
- No changes to code logic or main functionality; updates are limited to documentation for improved clarity and agent support.
- All core features and configuration methods remain unchanged.
v0.0.24
- **The main report is now named "保活简报 keepalive" in both Chinese and English** for branding and consistency; all references and formatting updated accordingly.
- Main message layout enhanced: fixed bolded "保活简报 keepalive" title, explicit theme subtitle in list body, and weather information now consistently placed at the end.
- Documentation in SKILL.md rewritten to clarify roles, versioning, and message structure, reflecting renaming and UX improvements.
- Placeholder and fallback behaviors clarified; markdown prompts expected to define content style and structure (with fallback logic unchanged).
- No breaking changes to environment variables, scheduling, or RSS fetching logic.
v0.0.23
smart-keepalive v0.0.23
- Major documentation update: SKILL.md rewritten with clear deployment, configuration, and extension instructions in both Chinese and English.
- Clarified the separation between message logic (in prompts/*.md) and script responsibilities.
- Updated guidance for setting up periodic tasks, channel/target configuration, and environment variable usage.
- Outlined supported RSSHub sources, failover logic, and process troubleshooting.
- Added quick-start steps and configuration priorities for easy onboarding.
Metadata
Frequently Asked Questions
What is smart-keepalive?
Automatically fetches RSS headlines, generates styled smart reports via OpenClaw, and supports optional wellness notes plus launchd/cron scheduling helpers. It is an AI Agent Skill for Claude Code / OpenClaw, with 263 downloads so far.
How do I install smart-keepalive?
Run "/install smart-keepalive" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is smart-keepalive free?
Yes, smart-keepalive is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does smart-keepalive support?
smart-keepalive is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created smart-keepalive?
It is built and maintained by kyle (@east5ringroad-kyle); the current version is v0.1.5.
More Skills