Pulse Board 📋

Operational heartbeat for your agent stack. Every cron job, one digest.

How it works

skill cron runs
  → log-append.sh appends one line to pending.log
  → digest-agent.sh (twice daily)
      reads pending.log
      writes full raw log to last-digest.md
      calls openclaw agent to compose human-readable summary
        (falls back to mechanical format if agent call fails)
      delivers to Telegram / Discord / log
      clears pending.log
      prunes old detail logs

What this skill touches

Filesystem

Crontab

All crontab writes are done via python3 subprocess. Existing entries are never modified.

Secrets env file

install.sh will ask for explicit confirmation before appending anything. It may add LLM_API_KEY=ollama and OPENCLAW_WORKSPACE=<path> if missing.

Network

• Telegram: POST https://api.telegram.org/bot<token>/sendMessage
• Discord: POST <your webhook URL>
• OpenClaw agent: openclaw agent --agent <id> --message <prompt> --json (local gateway call) ⚠️ The raw log is included in the prompt. If your agent uses a remote/cloud LLM, log content will be transmitted off-host. Use a local-only agent if log privacy is required.
• Log only: no network calls

Credentials

• Bot token / webhook URL read from pulse.yaml or env vars
• Secrets env sourced at runtime by digest-agent.sh, deliver.sh, and cron wrappers
• Credentials never written to logs or included in digest output

Install

chmod +x ~/.openclaw/skills/pulse-board/*.sh
bash ~/.openclaw/skills/pulse-board/install.sh

Plug in a skill

bash ~/.openclaw/skills/pulse-board/plug.sh \
  --skill my-skill \
  --cron "*/15 * * * *" \
  --cmd "bash ~/.openclaw/skills/my-skill/run.sh"

Optional flags: --label, --ok, --error, --log

Or run plug.sh with no arguments for interactive discovery mode.

Remove a skill

bash ~/.openclaw/skills/pulse-board/unplug.sh --skill my-skill

Test

bash ~/.openclaw/skills/pulse-board/log-append.sh \
  --skill test --status OK --message "Hello Pulse Board"

bash ~/.openclaw/skills/pulse-board/digest-agent.sh

Log files

The raw log is written first, before the agent call and before delivery. deliver.sh writes only to last-delivered.md and never touches last-digest.md.

To review the raw log on demand, ask your agent: "show me last night's full digest log" — it will read last-digest.md.

⚠️ Privacy note: when LLM composition is enabled, the raw log is passed to your OpenClaw agent as prompt context. If that agent uses a remote/cloud LLM, log content will leave this host. Use a local-only agent (Ollama) if log privacy is required.

Files

Updating

cd ~/.openclaw/skills/pulse-board && git pull && chmod +x *.sh

Requirements

• bash 4+, curl, python3 — standard on any modern Linux/macOS
• openclaw CLI in PATH (for LLM digest; falls back to mechanical if absent)
• No sudo. No root. No system path writes outside ~/.pulse-board/