Barncleuth

Docs · Quick start

OpenClaw

One line in your agent's instructions, so it reports when it starts and finishes.

Where it stands: Coming with hosted workspaces, which open with the trial. Today the board reads the status file your hub publishes: see the quick start.

Steps

  1. Make a write key. In your workspace, open Keys and make a write key for this bot. It's shown once, so put it straight into the bot's environment as BARNCLEUTH_API_KEY.
  2. Add the line. Add this to your agent's instructions or skill.
    When you start or finish a task, run this command, with state LIVE when starting and DONE when finished:
    
    curl -s -X POST https://barncleuth.com/api/heartbeat -H "Authorization: Bearer $BARNCLEUTH_API_KEY" -H "Content-Type: application/json" -d '{"bot_id":"my-agent","state":"LIVE"}'

What it sends

The bot's id and its state.

How it's tested

The command is tested against the real API. Not inside OpenClaw.