OpenClaw

Install the Fokus skill so your OpenClaw agent knows not just the tools, but how Fokus actually works.

OpenClaw can drive Fokus two ways. The skill is the one we recommend: besides wiring up the tools, it teaches the agent Fokus's data model, its conventions, and the workflows that produce good plans instead of a pile of untriaged tasks.

Pick one route

Skill or MCP server — not both. Installing both just duplicates the same capabilities in the agent's context.

1. Install the CLI

Everything runs through the fokus-mcp CLI. It needs Node.js 20+ on the machine running OpenClaw.

npm install -g @fokus-app/mcp     # or run it on demand with npx -y @fokus-app/mcp

2. Log in (once, as a human)

fokus-mcp login                  # email/password
fokus-mcp login --oauth google   # or microsoft / apple
fokus-mcp whoami                 # verify
fokus-mcp workspace              # optional: pick the default workspace

Self-hosted Fokus: add --api-url http://your-host:3000.

Authentication lives in the CLI's credential store (~/.config/fokus-mcp/credentials.json), not in environment variables — so no apiKey or env entries are needed in openclaw.json.

3a. Install the skill (recommended)

From a checkout of the agent-skills repo:

openclaw skills install /path/to/agent-skills/skills/fokus

Or straight from git:

openclaw skills install git:<owner>/agent-skills#skills/fokus

The skill declares fokus-mcp as a required binary, so if it's missing OpenClaw's installer offers to install it for you.

To scope the skill to particular agents, add it to the allowlist in ~/.openclaw/openclaw.json:

{
  agents: {
    defaults: { skills: ["fokus"] }
  }
}

3b. Or use the MCP server

Point OpenClaw's MCP support at the same CLI in server mode:

// ~/.openclaw/openclaw.json — see OpenClaw's MCP docs for the current key layout
{
  mcp: {
    servers: {
      fokus: { command: "fokus-mcp" }
    }
  }
}

You get the same 44 tools plus the daily_planning and weekly_review prompts — without the skill's usage guidance.

Try it

"Add a task to finish the Q3 report by Friday, high priority"
"What does my week look like?"
"Schedule my open tasks for this week" — runs the auto-scheduler
"Take a note: design sync decided on the new onboarding flow"

Troubleshooting

Symptom	Fix
Skill greyed out or never offered	`fokus-mcp` isn't on the PATH OpenClaw uses — install it globally and restart the gateway
Tools say "not logged in"	Run `fokus-mcp login` yourself in a terminal; the agent can't do it
Auth works but the data looks wrong	Check the active workspace: `fokus-mcp workspace`
Self-hosted API ignored	Log in with `--api-url` — the credential store is keyed per API URL