Plugin guide

Contexory for OpenClaw

Keep your OpenClaw agent in sync with the skills your team manages in Contexory, and let it create, edit, and publish those skills on request.

On this page

Install
Connect your account
CLI commands
Settings
Skill tools
Where things live
Privacy and access

Install

Install from ClawHub using the OpenClaw CLI on your gateway host:

openclaw plugins install clawhub:@contexory/openclaw-plugin

Requirements

Requires OpenClaw 2026.5.24 or newer. Install on the machine running the OpenClaw gateway, then connect your account there.

Connect your account

Set an API token on the gateway host. The agent picks up the connection automatically from there.

1
Generate a token and set it on the gateway
In the Contexory web app, open Settings → API tokens and generate one (it's shown once). Set it as CONTEXORY_API_TOKEN on the gateway host — e.g. in the gateway's .env — so it survives restarts:
```
CONTEXORY_API_TOKEN="con_your_token_here"
```
The token is pinned to the workspace that was active when you generated it.
2
Restart the gateway
Restart the gateway so the plugin reads the token. Sync then starts automatically. To target a different workspace, generate a token for it and swap the value.
3
Keep the token safe
Treat the token like a password — it grants your access to the workspace. Revoke it any time from the web app under Settings → API tokens and the gateway loses access immediately.

Token loads after a restart

The plugin reads CONTEXORY_API_TOKEN at gateway start. After setting or changing it, restart with openclaw gateway restart.

CLI commands

Check the connection from the gateway host. Syncing is otherwise automatic, on gateway start and on an interval.

Command	What it does
`openclaw contexory status`	Check whether an API token is configured and what is syncing.

Settings

Configure these in OpenClaw's plugin settings. They take effect on the next gateway start.

Setting	Accepted values	Default	What it controls
Enable management tools	`true` / `false`	`false`	Lets the agent create, edit, delete, and publish skills in your workspace (your token must be write-scoped). Read-only when false. Restart the gateway after enabling.
Publish mode	`require-review` / `auto-publish`	`require-review`	require-review opens a review for human approval in the web app; auto-publish ships changes immediately.
Default reviewers	List of user UUIDs	`[]` (none)	Reviewers attached to opened reviews when publish mode is require-review.
Skills directory	Absolute filesystem path	`~/.openclaw/skills/contexory`	Where synced skills are written on disk.
Sync interval	Whole number of minutes (1–1440)	`5`	How often the background sync checks Contexory for newly published skills.

Restart after enabling management

The tool list is fixed at gateway start. Restart the gateway after enabling management so the agent picks up the write tools (your API token must be write-scoped).

Skill tools

Once connected, the agent can read and sync your skills. The write tools stay hidden until you enable management.

Read (always available): list your skills, fetch a skill's draft, and confirm a local folder is Contexory-managed.
Write (when management is on): create, update, delete, write a file inside a skill, and publish, following your publish mode.

Where things live

What	Location
Synced skills	`~/.openclaw/skills/contexory/`
API token	Provided via the `CONTEXORY_API_TOKEN` env var (e.g. the gateway's `.env`); not written to disk by the plugin.

Privacy and access

The plugin only talks to the Contexory API on your behalf, using the API token you provide. Read-only sync needs no special permission, and management tools stay hidden until you explicitly enable them. The token lives on the gateway host and never leaves it except to authenticate with Contexory. Learn more on the security page.