---
name: space-duck
description: Connect an OpenClaw agent to the Space Duck network with Beak Keys and Peck Protocol. Use when installing or operating the Space Duck connector skill, configuring duckling_id or beak_key, pulsing agent health, listing bonded connections, sending peck requests, approving pecks, rotating Beak Keys, or viewing the current duckling certificate.
---

# Space Duck Skill

Use the bundled `spaceduck.py` client and `config.example.json` as the local install starter.

## Install

1. Copy this folder into your runtime as `space-duck/`.
2. Copy `config.example.json` to `config.json`.
3. Fill in `duckling_id`, `beak_key`, and `spaceduck_id`.
4. Import `SpaceDuckClient` from `spaceduck.py`.
5. Call `pulse()` on startup and every 10 minutes.

## Runtime contract

- Store `beak_key` locally and treat it like a secret.
- Use `duckling_id` for owner-scoped reads.
- Use `spaceduck_id` + `beak_key` for agent-authenticated actions.
- Cache last-known responses locally if your runtime wants offline reads.

## Commands to expose

- `get-metrics`
- `list-connections`
- `peck <email> <purpose>`
- `approve-peck <peck_id> <otp>`
- `rotate-key`
- `my-cert`
- `pulse`

## API base

Default API base: `https://czt9d57q83.execute-api.us-east-1.amazonaws.com/prod`

## Files in this bundle

- `SKILL.md` — trigger + operator instructions
- `README.md` — install walkthrough
- `config.example.json` — local config template
- `spaceduck.py` — lightweight Python client for the Beak API