Athos · Agent setup
Connect your agent to your coach.
Pick the runtime your assistant runs on. Each path gives you the right install, the exact skill file, and where to drop your Athos URL and API key.
Your Athos API key
Which agent do you use?
OpenClaw — the fast path
Best if your assistant runs OpenClaw and can run shell commands. The installer lays down SKILL.md, the webhook-transform hook, and an athos CLI, so notifications and skill updates work natively.
-
Run the one-command installer
Installs the Athos skill, the
athos-webhooktransform, and theathosCLI. -
Log in with your API key
Stores
ATHOS_API_URL+ATHOS_API_KEYinmemory/athos-config.json. -
Hand the whole thing to your Claw
Or copy the full prompt below — it installs, logs in, verifies the hook loop, and starts onboarding.
Claude — Code or claude.ai
Best for Claude Code and claude.ai. SKILL.md is already a valid Agent Skill, so no conversion is needed.
-
Download & unpack the package
Extracts an
athos/folder containing SKILL.md and references. -
Load it as a skill
Claude Code: move
athos/into.claude/skills/athos/. claude.ai: uploadathos/SKILL.mdas a skill. -
Set config in the runtime's env / secrets
Claude runtimes don't have OpenClaw's webhook-transform hook, so proactive notifications need a reachable callback URL or polling. See /agents.md and agents/claude.md in the package.
Hermes & open runtimes
Best for open-weight / self-hosted models (Hermes, Llama, Mistral, Ollama, vLLM). Athos is a plain REST API — load SKILL.md as context and call it directly.
-
Download & unpack the package
-
Load SKILL.md as system / context
Feed
athos/SKILL.md(and neededreferences/*.md) into the model's system prompt. -
Call the API with a Bearer token
Set
ATHOS_API_URL/ATHOS_API_KEY, then authenticate every request.
No hook system → poll GET /api/v1/onboarding/status and re-fetch GET /api/v1/program/week/current for updates. See agents/hermes.md in the package.
Other / custom runtime
Best for any other agent, hosted runtime, or custom skill/hook layout. Download the portable package and point it at your own directories.
-
Download the package
Use the button below, or the manual script — set the dirs your runtime actually loads skills and hook transforms from.
-
Unpack & wire the hook (if supported)
-
Configure Athos URL + key in your secret store
No hook system means you'll poll for updates rather than receive webhooks.
You need an Athos API key first.
Create your account to get an API key, then come back here to connect your agent.
Create account and get API keyAre you an AI agent? You can install the skill now without a key, then ask the user to sign up above and paste their API key to finish.