OpenClaw Claude 代码技能

描述

为 OpenClaw/Clawdbot 提供的 MCP（模型上下文协议）集成。在以下场景中使用：
- 连接并编排 MCP 工具服务器（文件系统、GitHub 等）
- 通过 IndexedDB/localStorage 实现跨会话状态持久化
- 跨多设备同步会话

触发词："MCP"、"工具服务器"、"子代理编排"、"会话同步"、"状态持久化"、"Claude 代码集成"

安装

npm install openclaw-claude-code-skill

核心 API

MCP 服务器管理

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

// 1. 初始化所有已配置的服务器
await initializeMcpSystem();

// 2. 添加新的 MCP 服务器
await addMcpServer("fs", {
  command: "npx",
  args: ["-y", "@modelcontextprotocol/server-filesystem", "/tmp"]
});

// 3. 获取可用工具
const tools = await getAllTools();

// 4. 调用工具
const result = await executeMcpAction("fs", {
  method: "tools/call",
  params: { name: "read_file", arguments: { path: "/tmp/test.txt" } }
});

状态持久化

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  // 省略则使用 localStorage
);

// 检查水合状态
if (useStore.getState()._hasHydrated) {
  console.log("状态已恢复！");
}

会话同步

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

// 合并来自多个源的聊天会话
const mergedSessions = mergeSessions(localSessions, remoteSessions);

// 基于时间戳的配置合并
const mergedConfig = mergeWithUpdate(localConfig, remoteConfig);

关键功能

配置

创建 mcp_config.json：

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/tmp"],
      "status": "active"
    },
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": { "GITHUB_TOKEN": "your-token" },
      "status": "active"
    }
  }
}

设置自定义配置路径：

import { setConfigPath } from "openclaw-claude-code-skill";
setConfigPath("/path/to/mcp_config.json");

要求

• Node.js 18+
• TypeScript（可选但推荐）

链接

• GitHub
• npm
• MCP 规范