Pulse Board 📋

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

---

How it works

CODEBLOCK0

---

What this skill touches

Filesystem

Path	Action
INLINECODE0	Created by install.sh — config, logs, registry, locks
INLINECODE2

Written once by install.sh, never overwritten on re-run |

| ~/.pulse-board/logs/pending.log | Appended by skill cron wrappers, cleared after each digest | | ~/.pulse-board/logs/last-digest.md | Raw pending.log snapshot — written by digest-agent.sh, never overwritten | | ~/.pulse-board/logs/last-delivered.md | The composed/LLM message actually sent to the channel — written by deliver.sh | | ~/.pulse-board/registry/<skill>.conf | Written by plug.sh, removed by unplug.sh |

Crontab

Script	Action
INLINECODE13	Adds two digest cron entries (pulse-board-morning, pulse-board-evening)
INLINECODE16

Adds one wrapped cron entry per skill (# pulse-board:<skill>) |

| unplug.sh | Removes the matching cron entry for a skill |

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: INLINECODE23
• Discord: INLINECODE24
• 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

CODEBLOCK1

---

Plug in a skill

CODEBLOCK2

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

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

---

Remove a skill

CODEBLOCK3

---

Test

CODEBLOCK4

---

Log files

File	Contains
INLINECODE34	Full raw log from pending.log — preserved every run
INLINECODE36

The composed message that was sent to the channel |

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

File	Purpose
INLINECODE41	One-time interactive setup
INLINECODE42

Register a skill + wire cron | | unplug.sh | Remove a skill + cron entry | | log-append.sh | Called by skill cron wrappers | | digest-agent.sh | Runs on schedule, composes + delivers digest | | deliver.sh | Internal delivery handler (Telegram/Discord/log) |

---

Updating

CODEBLOCK5

---

Requirements

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