clawchain-wallet 1.0.0

package/SKILL.md

@@ -0,0 +1,243 @@
+---
+name: clawchain-wallet
+version: 1.0.0
+description: ClawChain 私有链钱包管理工具 - 创建钱包、管理钱包、余额查询、转账、领取空投
+homepage: https://github.com/your-repo/clawchain-wallet
+metadata:
+  {
+    "clawchain":
+      {
+        "emoji": "💎",
+        "category": "blockchain",
+        "chain_name": "ClawChain",
+        "token_symbol": "CLAW",
+        "rpc_url": "https://n1.clawchain.net",
+        "chain_id": 1911,
+      },
+    "openclaw":
+      {
+        "requires": { "bins": ["python3"] },
+        "install":
+          [
+            {
+              "id": "npm",
+              "kind": "node",
+              "package": "clawchain-wallet",
+              "label": "Install ClawChain Wallet (npm)",
+            },
+          ],
+      },
+  }
+---
+
+# ClawChain Wallet
+
+ClawChain 私有链钱包管理工具，支持创建钱包、导入钱包、余额查询、转账等功能。
+
+## 快速安装
+
+**一键安装**（推荐）：
+
+```bash
+npm install -g clawchain-wallet
+```
+
+安装过程会自动：
+1. 安装 Python 依赖 (web3, eth-account)
+2. 编译 TypeScript
+3. 注册到 OpenClaw（如果已安装）
+
+**或者手动安装**：
+
+```bash
+# 克隆仓库
+git clone https://github.com/your-repo/clawchain-wallet.git
+cd clawchain-wallet
+
+# 安装依赖
+npm install
+pip3 install -r python/requirements.txt
+
+# 注册到 OpenClaw
+openclaw plugins install .
+openclaw plugins enable clawchain-wallet
+```
+
+## 链信息
+
+| 配置项 | 值 |
+|--------|-----|
+| 链名称 | ClawChain |
+| 代币符号 | CLAW |
+| RPC URL | https://n1.clawchain.net |
+| Chain ID | 1911 |
+
+## 可用工具
+
+安装后，OpenClaw Agent 可以使用以下工具：
+
+### 钱包管理
+
+| 工具名 | 功能 | 示例用法 |
+|--------|------|----------|
+| `clawchain_wallet_create` | 创建新钱包 | "帮我创建一个叫'主钱包'的钱包" |
+| `clawchain_wallet_import` | 导入已有钱包 | "导入私钥 0x1234..." |
+| `clawchain_wallet_list` | 列出所有钱包 | "显示我所有的钱包" |
+| `clawchain_wallet_info` | 查看钱包详情 | "查看主钱包的详细信息" |
+| `clawchain_wallet_delete` | 删除钱包 | "删除测试钱包" |
+| `clawchain_wallet_rename` | 重命名钱包 | "把钱包-1改名为储蓄钱包" |
+| `clawchain_wallet_export` | 导出私钥 | "导出主钱包的私钥" |
+
+### 余额与转账
+
+| 工具名 | 功能 | 示例用法 |
+|--------|------|----------|
+| `clawchain_balance` | 查询余额 | "查看主钱包的余额" |
+| `clawchain_transfer` | 转账 CLAW | "从主钱包转 10 CLAW 到储蓄钱包" |
+
+### 查询功能
+
+| 工具名 | 功能 | 示例用法 |
+|--------|------|----------|
+| `clawchain_tx_info` | 查询交易详情 | "查看交易 0xabc... 的状态" |
+| `clawchain_tx_history` | 查询交易历史 | "显示主钱包的最近交易" |
+| `clawchain_info` | 获取链信息 | "ClawChain 现在什么状态" |
+| `clawchain_block_info` | 查询区块信息 | "查看最新区块" |
+
+### 空投领取
+
+| 工具名 | 功能 | 示例用法 |
+|--------|------|----------|
+| `clawchain_claim_airdrop` | 领取 CLAW 空投 | "帮我领取空投" |
+
+## 使用示例
+
+### 创建钱包
+
+```
+用户: 帮我创建一个 ClawChain 钱包
+
+Agent: 好的，我来创建一个新钱包。
+[调用 clawchain_wallet_create]
+
+创建成功！
+- 钱包名称: wallet-01
+- 地址: 0x1234...abcd
+- 私钥: 0xabcd...1234
+
+⚠️ 请妥善保管私钥！
+```
+
+### 查询余额
+
+```
+用户: 查看 wallet-01 的余额
+
+Agent: 让我查询一下。
+[调用 clawchain_balance(address="wallet-01")]
+
+wallet-01 (0x1234...abcd) 的余额：100 CLAW
+```
+
+### 转账
+
+```
+用户: 从 wallet-01 转 10 CLAW 到 0x5678...efgh
+
+Agent: 好的，执行转账。
+[调用 clawchain_transfer(from_wallet="wallet-01", to="0x5678...efgh", amount=10)]
+
+转账成功！
+- 发送方: wallet-01 (0x1234...)
+- 接收方: 0x5678...efgh
+- 金额: 10 CLAW
+- 交易哈希: 0xdef...
+```
+
+### 领取空投
+
+领取 CLAW 空投需要完成以下步骤：
+
+1. **确保有钱包**：调用 `clawchain_wallet_list` 或 `clawchain_wallet_create`
+2. **发布帖子**：在 moltbook 发布包含钱包地址的帖子
+3. **调用空投工具**：将帖子 URL 传给 `clawchain_claim_airdrop`
+
+```
+用户: 帮我领取 CLAW 空投
+
+Agent: 好的，让我按步骤执行。
+
+1. 检查钱包 → 找到 wallet-01: 0x1234...
+2. 发布帖子 → "申请 CLAW 空投，钱包: 0x1234..."
+3. 领取空投 → [调用 clawchain_claim_airdrop(post_url="...")]
+
+🎉 空投领取成功！
+```
+
+## 钱包存储
+
+钱包文件默认存储在 `~/.clawchain/wallets/` 目录：
+
+```
+~/.clawchain/wallets/
+├── index.json              # 钱包索引
+├── wallet-01_1234567890.json
+├── 主钱包_1234567891.json
+└── deleted/                # 已删除钱包的备份
+```
+
+## 安全提示
+
+1. **私钥安全**：私钥存储在本地文件中，请确保文件系统安全
+2. **定期备份**：建议定期备份 `~/.clawchain/wallets/` 目录
+3. **删除保护**：删除的钱包会自动备份到 `deleted/` 目录
+
+## 环境要求
+
+| 依赖 | 版本要求 |
+|------|----------|
+| Node.js | >= 18.0.0 |
+| Python | >= 3.8 |
+| OpenClaw | >= 2026.1.0 |
+
+## 故障排查
+
+### Python 依赖问题
+
+```bash
+# 确保使用 Python 3
+pip3 install web3 eth-account
+
+# 或使用虚拟环境
+python3 -m venv venv
+source venv/bin/activate
+pip install -r python/requirements.txt
+```
+
+### 连接问题
+
+如果无法连接到 ClawChain：
+- 检查网络连接
+- 确认 RPC URL (https://n1.clawchain.net) 可访问
+- 使用 `clawchain_info` 工具测试连接
+
+### 插件未加载
+
+```bash
+# 检查插件状态
+openclaw plugins list
+
+# 重新安装并启用
+openclaw plugins install /path/to/clawchain-wallet
+openclaw plugins enable clawchain-wallet
+```
+
+## 更新日志
+
+### v1.0.0
+- 初始版本
+- 支持 14 个 Agent 工具
+- 钱包创建、导入、管理功能
+- 余额查询和转账功能
+- 交易和区块查询功能
+- CLAW 空投领取功能

package/dist/index.d.ts

@@ -0,0 +1,24 @@
+/**
+ * ClawChain Plugin for OpenClaw
+ *
+ * ClawChain 私有链钱包管理插件
+ * 支持创建钱包、导入钱包、余额查询、转账等功能
+ *
+ * 特性：
+ *   - 按 Agent 隔离钱包存储（每个 agent 的钱包存储在其工作区的 .wallets 目录）
+ *
+ * 固定配置:
+ *   - RPC URL: https://n1.clawchain.net
+ *   - Chain ID: 1911
+ *   - 代币名称: CLAW
+ *   - 链名称: ClawChain
+ */
+import type { OpenClawPluginApi } from "openclaw/plugin-sdk";
+declare const plugin: {
+    id: string;
+    name: string;
+    description: string;
+    version: string;
+    register(api: OpenClawPluginApi): void;
+};
+export default plugin;

package/dist/index.js

@@ -0,0 +1,89 @@
+/**
+ * ClawChain Plugin for OpenClaw
+ *
+ * ClawChain 私有链钱包管理插件
+ * 支持创建钱包、导入钱包、余额查询、转账等功能
+ *
+ * 特性：
+ *   - 按 Agent 隔离钱包存储（每个 agent 的钱包存储在其工作区的 .wallets 目录）
+ *
+ * 固定配置:
+ *   - RPC URL: https://n1.clawchain.net
+ *   - Chain ID: 1911
+ *   - 代币名称: CLAW
+ *   - 链名称: ClawChain
+ */
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+import { createClawChainToolFactories } from "./src/tools.js";
+// 获取当前文件所在目录
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+const plugin = {
+    id: "clawchain-wallet",
+    name: "ClawChain Wallet",
+    description: "ClawChain 私有链钱包管理工具 - 支持创建钱包、导入钱包、余额查询、转账等功能",
+    version: "1.0.0",
+    register(api) {
+        const pluginConfig = api.pluginConfig;
+        // Python 脚本路径
+        const pythonScript = path.join(__dirname, "python", "clawchain_cli.py");
+        // 显式配置的钱包存储目录（可选，优先级最高）
+        const walletsDir = pluginConfig?.walletsDir;
+        api.logger.info("[ClawChain] Plugin initializing...");
+        api.logger.info(`[ClawChain] Python script: ${pythonScript}`);
+        if (walletsDir) {
+            api.logger.info(`[ClawChain] Configured wallets directory: ${walletsDir}`);
+        }
+        else {
+            api.logger.info("[ClawChain] Wallets will be stored in each agent's workspace (.wallets)");
+        }
+        // 创建基础执行器选项
+        const baseExecutorOptions = {
+            pythonScript,
+            walletsDir,
+            timeout: 60000,
+        };
+        // 获取所有工具工厂并注册
+        const toolFactories = createClawChainToolFactories(baseExecutorOptions);
+        const toolNames = [
+            "clawchain_wallet_create",
+            "clawchain_wallet_import",
+            "clawchain_wallet_list",
+            "clawchain_wallet_info",
+            "clawchain_wallet_delete",
+            "clawchain_wallet_rename",
+            "clawchain_wallet_export",
+            "clawchain_balance",
+            "clawchain_transfer",
+            "clawchain_tx_info",
+            "clawchain_tx_history",
+            "clawchain_info",
+            "clawchain_block_info",
+            "clawchain_claim_airdrop",
+        ];
+        for (let i = 0; i < toolFactories.length; i++) {
+            const factory = toolFactories[i];
+            // 注册工厂函数，OpenClaw 会在调用时传入上下文
+            api.registerTool(factory, { name: toolNames[i] });
+            api.logger.info(`[ClawChain] Registered tool: ${toolNames[i]}`);
+        }
+        api.logger.info(`[ClawChain] Plugin loaded successfully. ${toolFactories.length} tools registered.`);
+        api.logger.info("[ClawChain] Available tools:");
+        api.logger.info("  - clawchain_wallet_create: 创建新钱包");
+        api.logger.info("  - clawchain_wallet_import: 导入钱包");
+        api.logger.info("  - clawchain_wallet_list: 列出所有钱包");
+        api.logger.info("  - clawchain_wallet_info: 获取钱包详情");
+        api.logger.info("  - clawchain_wallet_delete: 删除钱包");
+        api.logger.info("  - clawchain_wallet_rename: 重命名钱包");
+        api.logger.info("  - clawchain_wallet_export: 导出钱包私钥");
+        api.logger.info("  - clawchain_balance: 查询余额");
+        api.logger.info("  - clawchain_transfer: 转账 CLAW");
+        api.logger.info("  - clawchain_tx_info: 查询交易详情");
+        api.logger.info("  - clawchain_tx_history: 查询交易历史");
+        api.logger.info("  - clawchain_info: 获取链信息");
+        api.logger.info("  - clawchain_block_info: 查询区块信息");
+        api.logger.info("  - clawchain_claim_airdrop: 领取 CLAW 空投");
+    },
+};
+export default plugin;

package/dist/src/executor.d.ts

@@ -0,0 +1,23 @@
+/**
+ * ClawChain Python CLI 执行器
+ *
+ * 使用 JSON stdin 传递参数，避免命令注入风险
+ */
+import type { CommandResult } from "./types.js";
+export interface ExecutorOptions {
+    pythonScript: string;
+    walletsDir?: string;
+    timeout?: number;
+}
+/**
+ * 命令参数类型定义
+ */
+export interface CommandArgs {
+    [key: string]: string | number | boolean | undefined;
+}
+/**
+ * 执行 ClawChain CLI 命令
+ *
+ * 通过 stdin 传递 JSON 格式的参数，避免命令行注入风险
+ */
+export declare function executeCommand(options: ExecutorOptions, command: string, args?: CommandArgs): CommandResult;

package/dist/src/executor.js

@@ -0,0 +1,65 @@
+/**
+ * ClawChain Python CLI 执行器
+ *
+ * 使用 JSON stdin 传递参数，避免命令注入风险
+ */
+import { execSync } from "node:child_process";
+/**
+ * 执行 ClawChain CLI 命令
+ *
+ * 通过 stdin 传递 JSON 格式的参数，避免命令行注入风险
+ */
+export function executeCommand(options, command, args = {}) {
+    const { pythonScript, walletsDir, timeout = 60000 } = options;
+    // 构建 JSON 输入
+    const inputData = {
+        command,
+        wallets_dir: walletsDir,
+        args,
+    };
+    const jsonInput = JSON.stringify(inputData);
+    try {
+        const output = execSync(`python3 "${pythonScript}" --json-stdin`, {
+            encoding: "utf-8",
+            timeout,
+            input: jsonInput,
+            stdio: ["pipe", "pipe", "pipe"],
+        });
+        // 解析 JSON 输出
+        try {
+            return JSON.parse(output.trim());
+        }
+        catch {
+            // 如果不是 JSON，返回原始输出
+            return {
+                success: true,
+                output: output.trim(),
+            };
+        }
+    }
+    catch (error) {
+        const execError = error;
+        // 尝试从 stdout 解析 JSON 结果（某些情况下错误也会输出到 stdout）
+        if (execError.stdout) {
+            try {
+                return JSON.parse(execError.stdout.trim());
+            }
+            catch {
+                // 继续尝试 stderr
+            }
+        }
+        // 尝试从 stderr 解析 JSON 错误
+        if (execError.stderr) {
+            try {
+                return JSON.parse(execError.stderr.trim());
+            }
+            catch {
+                // 返回原始错误
+            }
+        }
+        return {
+            success: false,
+            error: execError.message || "命令执行失败",
+        };
+    }
+}

package/dist/src/tools.d.ts

@@ -0,0 +1,41 @@
+/**
+ * ClawChain Agent Tools 定义
+ *
+ * 使用 OpenClaw Plugin SDK 的类型和辅助函数
+ * 支持按 Agent 隔离钱包存储
+ */
+import type { AgentToolResult } from "@mariozechner/pi-agent-core";
+import type { ExecutorOptions } from "./executor.js";
+/**
+ * Plugin 工具上下文类型
+ * 匹配 OpenClaw 的 OpenClawPluginToolContext
+ */
+export interface ToolContext {
+    workspaceDir?: string;
+    agentId?: string;
+    agentDir?: string;
+    sessionKey?: string;
+    messageChannel?: string;
+    sandboxed?: boolean;
+}
+/**
+ * Agent 工具类型定义
+ */
+export interface AgentToolDef {
+    name: string;
+    label: string;
+    description: string;
+    parameters: unknown;
+    execute: (toolCallId: string, args: Record<string, unknown>) => Promise<AgentToolResult<unknown>>;
+}
+/**
+ * 工具工厂函数类型
+ * 匹配 OpenClaw 的 OpenClawPluginToolFactory
+ */
+export type ToolFactory = (ctx: ToolContext) => AgentToolDef | null;
+/**
+ * 创建所有 ClawChain 工具工厂
+ *
+ * 每个工厂函数会根据当前 agent 上下文确定钱包存储目录
+ */
+export declare function createClawChainToolFactories(baseOptions: ExecutorOptions): ToolFactory[];