OpenClaw

Agent skill + MCP support

OpenClaw uses agent skills loaded from your project’s skills/ directory (and optionally from paths configured in ~/.openclaw/openclaw.json). Cognetivy installs its Agent Skills bundle - a single skill that describes workflows, runs, collections, and the full CLI - so OpenClaw can execute and track Cognetivy workflows without any plugin or extra setup. You can also connect via MCP for tool-style access.

Prerequisites

Node.js 18+, a project directory for the .cognetivy/ workspace, and OpenClaw installed. The Cognetivy skill is installed under skills/cognetivy/ in that project. No global Cognetivy install is required for the skill path; for MCP, cognetivy must be on your PATH.

Setup

Run the installer from your project directory:

npx cognetivy

Choose OpenClaw in the installer. Cognetivy will:

  • Create a .cognetivy/ workspace in your project
  • Install the Cognetivy Agent Skill bundle into skills/cognetivy/
  • Optionally apply a workflow template
  • Open Studio in your browser

To install or update the skill only (workspace already exists, Cognetivy installed globally):

cognetivy install openclaw

This writes the Agent Skills bundle (SKILL.md and REFERENCE.md) into skills/cognetivy/ in the current project.

How the Cognetivy skill works in OpenClaw

OpenClaw reads agent skills from your project’s skills/ directory. The Cognetivy skill is a single SKILL.md (plus REFERENCE.md) that tells OpenClaw when to use Cognetivy and how to run workflow, run, event, and collection commands. Once installed, OpenClaw has full context for starting runs, advancing steps, writing collections with traceability, and following next_step hints - including parallel nodes and schema-first writes. No plugins or extra configuration are required; the skill is the only integration surface we document and support for OpenClaw.

MCP connection (alternative)

You can also connect Cognetivy via MCP so its tools appear in OpenClaw’s context. Add the server to your OpenClaw MCP config:

{
  "mcpServers": {
    "cognetivy": {
      "command": "cognetivy",
      "args": ["mcp"]
    }
  }
}

If the workspace is not in your current project, add "--workspace", "/path/to/.cognetivy" to args.