Skip to content
Documentation

Start typing to search...

Connect Ditto to OpenClaw

Paste one prompt into OpenClaw: it installs the Ditto skill, signs itself up, and sends you a claim link. No API key required.

OpenClaw uses Ditto through a ClawHub skill that calls the Ditto CLI. You don’t need a Ditto account before you start; OpenClaw sets everything up itself and sends you a claim link.

Paste this into OpenClaw

The fastest path: hand the whole job to the agent.

Install the Ditto skill from ClawHub:
  openclaw skills install ditto
Confirm the skill is the one at https://clawhub.ai/ditto/ditto.
Install the CLI the skill needs:
  npm install -g @heyditto/cli@latest
Check existing authentication with: heyditto status --output json
If a key is already configured, reuse it. Do not log out or create a new account.
Otherwise create a claimable agent account:
  heyditto init --agent --agent-caller "openclaw" --json
Send me only the claimURL from the response so I can claim the account.
Keep the full claim link private; never print the API key or local credential file.
Verify with: heyditto status --output json
Report the connection result and available tools. Do not create a test memory.
Help me append the Memory workflow instruction below to my workspace AGENTS.md.

OpenClaw installs the skill, creates a free account with the key stored locally (it is never printed), and replies with a claimURL. Open it, sign in, and the account is yours; the agent keeps its key and memories after you claim. See Agent-Native Signup for how the claim flow works.

Prefer to run the commands yourself?

Install the skill:

openclaw skills install ditto

Install the CLI with npm install -g @heyditto/cli@latest, then run heyditto status --output json. Reuse a configured key. If none is configured, let OpenClaw sign itself up:

npx -y @heyditto/cli init --agent --agent-caller "openclaw" --json

You can inspect the public skill page first: Ditto on ClawHub. The skill installs the Ditto CLI as part of setup. If you already manage your own key, heyditto login <key> still works instead.

Verify

npx -y @heyditto/cli status

If the status confirms authentication and lists the live tools, OpenClaw is connected and will use Ditto memory when the conversation calls for it.

Troubleshooting

SymptomFix
The skill won’t installConfirm OpenClaw uses ClawHub skill sources and clawhub.ai/ditto/ditto is reachable.
error: no Ditto API key configuredRe-run the init command above, then check npx -y @heyditto/cli status.
The claim link doesn’t workRe-send the full claimURL, including everything after ?t=.

After setup, add the memory workflow instruction to your persistent instructions. Keep claim links private; they authorize ownership of the agent account.