Installation

Get started with ClawLayer SDK to enhance your OpenClaw AI agents with enterprise-ready features.

Prerequisites

Before installing ClawLayer, ensure you have:

• Node.js (v20.x or higher)

• npm, yarn, or pnpm (package manager)

• OpenClaw installed in your project

Verify Prerequisites

node --version  # Should be v20.x or higher
npm --version   # Should be 9.x or higher

Installation Methods

Option 1: npm

npm install @clawlayer/sdk openclaw

Option 2: yarn

yarn add @clawlayer/sdk openclaw

Option 3: pnpm

pnpm add @clawlayer/sdk openclaw

Required Dependencies

ClawLayer integrates seamlessly with OpenClaw. Ensure you have both installed:

{
  "dependencies": {
    "@clawlayer/sdk": "^1.0.0",
    "openclaw": "^1.0.0"
  }
}

Environment Configuration

Create a .env file in your project root with the required API keys:

# AI Provider API Keys (for OpenClaw)
ANTHROPIC_API_KEY=your_anthropic_key
OPENAI_API_KEY=your_openai_key

# ClawLayer Configuration (optional)
CLAWLAYER_API_KEY=your_clawlayer_api_key

# Memory Provider (choose one)
PINECONE_API_KEY=your_pinecone_key
# or
WEAVIATE_URL=your_weaviate_url
# or
QDRANT_URL=your_qdrant_url

# Cache Provider (optional)
REDIS_URL=redis://localhost:6379

Optional: Self-Hosted Setup

If you prefer to self-host ClawLayer's infrastructure:

1. Clone the Repository

git clone https://github.com/clawlayer/clawlayer.git
cd clawlayer

2. Install Dependencies

pnpm install

3. Configure Environment

cp .env.example .env
# Edit .env with your configuration

4. Start Services

# Start Redis (for caching)
docker-compose up -d redis

# Start vector database (for memory)
docker-compose up -d pinecone

# Start ClawLayer API
pnpm dev

Verify Installation

Create a simple test file to verify your installation:

// test.ts
import { ClawLayer } from '@clawlayer/sdk';
import { OpenClaw } from 'openclaw';

console.log('ClawLayer SDK version:', require('@clawlayer/sdk/package.json').version);
console.log('OpenClaw version:', require('openclaw/package.json').version);
console.log('✓ Installation successful!');

Run it:

npx tsx test.ts

Expected output:

ClawLayer SDK version: 1.0.0
OpenClaw version: 1.0.0
✓ Installation successful!

TypeScript Configuration

If using TypeScript, add these compiler options to your tsconfig.json:

{
  "compilerOptions": {
    "target": "ES2020",
    "module": "ESNext",
    "moduleResolution": "node",
    "esModuleInterop": true,
    "skipLibCheck": true,
    "strict": true
  }
}

Package Exports

ClawLayer SDK exports the following modules:

import {
  ClawLayer,          // Main enhancement wrapper
  PersonalityEngine,  // Personality configuration
  MemoryManager,      // Memory and state management
  CacheLayer,         // Performance optimization
  Analytics,          // Observability and metrics
  PluginSystem        // Plugin integration
} from '@clawlayer/sdk';

Next Steps

Now that ClawLayer is installed, proceed to the Quickstart guide to build your first enhanced OpenClaw agent!

Troubleshooting

Installation Issues

Error: Cannot find module '@clawlayer/sdk'

Make sure you've installed the package:

npm install @clawlayer/sdk

Error: Peer dependency openclaw not found

Install OpenClaw alongside ClawLayer:

npm install @clawlayer/sdk openclaw

TypeScript errors

Ensure your TypeScript version is 5.0 or higher:

npm install -D typescript@latest

Platform-Specific Issues

macOS M1/M2 Users

Some native dependencies may require Rosetta:

softwareupdate --install-rosetta

Windows Users

Ensure you have Visual Studio Build Tools installed for native dependencies:

npm install --global windows-build-tools

Need Help?

• Quickstart Guide

• Discord Community

• GitHub Issues

• Email Support