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
- 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.
- 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.