Claude Code Skill

# OpenClaw Claude Code Skill

## Description

MCP (Model Context Protocol) integration for OpenClaw/Clawdbot. Use when you need to:
- Connect and orchestrate MCP tool servers (filesystem, GitHub, etc.)
- Persist state across sessions with IndexedDB/localStorage
- Sync sessions across multiple devices

Triggers: "MCP", "tool server", "sub-agent orchestration", "session sync", "state persistence", "Claude Code integration"

## Installation

```bash
npm install openclaw-claude-code-skill
```

## Core APIs

### MCP Server Management

```typescript
import { 
  initializeMcpSystem, 
  addMcpServer, 
  executeMcpAction, 
  getAllTools 
} from "openclaw-claude-code-skill";

// 1. Initialize all configured servers
await initializeMcpSystem();

// 2. Add a new MCP server
await addMcpServer("fs", {
  command: "npx",
  args: ["-y", "@modelcontextprotocol/server-filesystem", "/tmp"]
});

// 3. Get available tools
const tools = await getAllTools();

// 4. Call a tool
const result = await executeMcpAction("fs", {
  method: "tools/call",
  params: { name: "read_file", arguments: { path: "/tmp/test.txt" } }
});
```

### State Persistence

```typescript
import { createPersistStore, indexedDBStorage } from "openclaw-claude-code-skill";

const useStore = createPersistStore(
  { count: 0, items: [] },
  (set, get) => ({
    increment: () => set({ count: get().count + 1 }),
    addItem: (item: string) => set({ items: [...get().items, item] })
  }),
  { name: "my-store" },
  indexedDBStorage  // or omit for localStorage
);

// Check hydration status
if (useStore.getState()._hasHydrated) {
  console.log("State restored!");
}
```

### Session Synchronization

```typescript
import { mergeSessions, mergeWithUpdate, mergeKeyValueStore } from "openclaw-claude-code-skill";

// Merge chat sessions from multiple sources
const mergedSessions = mergeSessions(localSessions, remoteSessions);

// Merge configs with timestamp-based resolution
const mergedConfig = mergeWithUpdate(localConfig, remoteConfi...

# OpenClaw Claude Code Skill

A skill package for [OpenClaw](https://github.com/openclaw/openclaw) / Claude Code that enables:

- **MCP (Model Context Protocol)** integration for sub-agent orchestration
- **State persistence** and context recovery across sessions
- **Session synchronization** for multi-device support

## Features

### 🔌 MCP Integration

Full implementation of the [Model Context Protocol](https://spec.modelcontextprotocol.io/) for managing AI tool servers:

- Create and manage MCP client connections
- Execute tool calls across multiple servers
- Server lifecycle management (pause/resume/restart)

### 💾 State Persistence

Robust state management with automatic recovery:

- IndexedDB storage with localStorage fallback
- Hydration tracking to prevent data loss
- Timestamp-based merge conflict resolution

### 🔄 Session Sync

Smart synchronization utilities:

- Merge sessions from multiple sources
- Preserve message history across devices
- Key-value store merging

## Installation

```bash
npm install openclaw-claude-code-skill
# or
yarn add openclaw-claude-code-skill
```

## Quick Start

### MCP Server Management

```typescript
import {
  initializeMcpSystem,
  addMcpServer,
  executeMcpAction,
  getAllTools,
} from "openclaw-claude-code-skill";

// Initialize the MCP system
await initializeMcpSystem();

// Add a new MCP server
await addMcpServer("my-server", {
  command: "npx",
  args: ["-y", "@modelcontextprotocol/server-filesystem", "/path/to/dir"],
});

// Get all available tools
const tools = await getAllTools();
console.log(tools);

// Execute a tool call
const result = await executeMcpAction("my-server", {
  method: "tools/call",
  params: {
    name: "read_file",
    arguments: { path: "/path/to/file.txt" },
  },
});
```

### State Persistence

```typescript
import { createPersistStore, indexedDBStorage } from "openclaw-claude-code-skill";

// Create a persistent store
const useMyStore = createPersistStore(
  // Initial state
  { count: 0, ite...