Skip to content
clay-install-auth logo

Clay Install & Auth

clay-install-auth

Install and configure Clay SDK/CLI authentication. Use when setting up a new Clay integration, configuring API keys, or initializing Clay in your project. Trigger with phrases like "install clay", "setup clay", "clay auth", "configure clay API key".

SKILL.md

Full skill instructions

Clay Install & Auth

Overview

Set up Clay SDK/​CLI and configure authentication credentials.

Prerequisites

  • Node.js 18+ or Python 3.10+
  • Package manager (npm, pnpm, or pip)
  • Clay account with API access
  • API key from Clay dashboard

Instructions

Step 1: Install SDK

# Node.js
npm install @clay/​sdk

# Python
pip install clay

Step 2: Configure Authentication

# Set environment variable
export CLAY_API_KEY="your-api-key"

# Or create .env file
echo 'CLAY_API_KEY=your-api-key' >> .env

Step 3: Verify Connection

// Test connection code here

Output

  • Installed SDK package in node_modules or site-packages
  • Environment variable or .env file with API key
  • Successful connection verification output

Error Handling

ErrorCauseSolution
Invalid API KeyIncorrect or expired keyVerify key in Clay dashboard
Rate LimitedExceeded quotaCheck quota at https://docs.clay.com
Network ErrorFirewall blockingEnsure outbound HTTPS allowed
Module Not FoundInstallation failedRun npm install or pip install again

Examples

TypeScript Setup

import { ClayClient } from '@clay/​sdk';

const client = new ClayClient({
  apiKey: process.env.CLAY_API_KEY,
});

Python Setup

from clay import ClayClient

client = ClayClient(
    api_key=os.environ.get('CLAY_API_KEY')
)

Resources

Next Steps

After successful auth, proceed to clay-hello-world for your first API call.