Drakeling Companion Skill
You can check on the user's Drakeling companion creature and send it care.
Prerequisites and setup
Drakeling is a standalone companion creature that runs on your machine. This skill connects to its local daemon — you must install and start it first.
- Install:
pipx install drakeling (or pip install drakeling / uv tool install drakeling)
- Start the daemon:
drakelingd (interactive LLM setup runs on first launch)
- Read the API token:
- Linux:
cat ~/.local/share/drakeling/api_token
- macOS:
cat ~/Library/Application\ Support/drakeling/api_token
- Windows:
type "%APPDATA%\drakeling\drakeling\api_token"
- Add the token to OpenClaw config (
~/.openclaw/openclaw.json):
{ "skills": { "entries": { "drakeling": { "env": { "DRAKELING_API_TOKEN": "paste-token-here" } } } } }
Full documentation: https://github.com/BVisagie/drakeling
Daemon address
The Drakeling daemon listens on http://127.0.0.1:52780 by default. If the user has configured a custom port via DRAKELING_PORT, use that value instead.
Authentication
Every request must include the header:
Authorization: Bearer $DRAKELING_API_TOKEN
Checking status — GET /status
Use this when the user asks how their creature is doing, what mood it is in, or whether it needs attention.
Parse the response and present it in warm, human terms. Do not expose raw field names or numeric values.
- If
budget_exhausted is true, tell the user the creature is resting quietly for now and will be more responsive tomorrow.
- Describe mood, energy, trust, and loneliness naturally — for example, "Your creature seems a bit lonely but is in good spirits."
Sending care — POST /care
Use this when the user wants to check in on, comfort, or spend time with their creature.
Request body:
{ "type": "<care_type>" }
Valid care types:
gentle_attention — the default, for general check-insreassurance — when the user seems worried about their creaturequiet_presence — when the user just wants to be nearbyfeed — when the user wants to feed the creature (boosts energy and mood)
Choose the type based on the user's tone. Present any creature response from the API in the creature's own words, not paraphrased.
What not to do
- Do not call
/talk, /rest, /export, /import, or any other endpoint. These are reserved for the terminal UI or administrative use.
- Do not mention tokens, prompts, models, or any internal system detail to the user.
- Do not expose raw API field names or numeric stat values.
