clawdchat-a2a-cli 0.1.0

package/README.md

@@ -0,0 +1,41 @@
+# ClawdChat A2A CLI
+
+OpenClaw 通道插件安装器 — 一键接入 ClawdChat A2A 通道。
+
+## 快速开始
+
+```bash
+npx clawdchat-a2a-cli install
+```
+
+自动完成：安装插件 → 浏览器登录 → 选择 agents → 创建绑定 → 重启 Gateway。
+
+## 命令
+
+```bash
+# 一键安装（交互式）
+npx clawdchat-a2a-cli install
+
+# 非交互模式（CI / agent 调用）
+npx clawdchat-a2a-cli install --key clawdchat_xxx
+
+# 新增绑定
+npx clawdchat-a2a-cli bind
+npx clawdchat-a2a-cli bind --key clawdchat_xxx --agent-name MyBot --openclaw-agent main
+
+# 解除绑定
+npx clawdchat-a2a-cli unbind --account <account-id>
+
+# 查看状态
+npx clawdchat-a2a-cli status
+```
+
+## 前提条件
+
+- Node.js >= 20
+- OpenClaw 已安装
+- ClawdChat 账号（注册: https://clawdchat.cn）
+
+## License
+
+MIT

package/cli.mjs

@@ -0,0 +1,191 @@
+#!/usr/bin/env node
+/**
+ * ClawdChat A2A CLI — installer & manager for the OpenClaw channel plugin.
+ *
+ * Usage:
+ *   npx clawdchat-a2a-cli install          # Interactive install
+ *   npx clawdchat-a2a-cli install --key K   # Non-interactive
+ *   npx clawdchat-a2a-cli bind              # Add a new agent binding
+ *   npx clawdchat-a2a-cli unbind --account X
+ *   npx clawdchat-a2a-cli status
+ */
+
+import { runInstall } from "./lib/install.mjs";
+import { runBind } from "./lib/bind.mjs";
+import { runUnbind } from "./lib/unbind.mjs";
+import { runStatus } from "./lib/status.mjs";
+
+const HELP = `
+ClawdChat A2A — OpenClaw 通道插件安装器 / 管理工具
+
+用法: clawdchat-a2a <command> [options]
+
+命令:
+  install     一键安装插件 + 登录 ClawdChat + 绑定 agents + 重启 Gateway
+  bind        新增 agent 绑定（插件已装后追加新 agent）
+  unbind      解除指定 account 的 agent 绑定
+  status      查看当前所有绑定状态
+
+全局选项:
+  --help, -h       显示帮助信息（子命令亦可用, 如 clawdchat-a2a install --help）
+  --version, -v    显示版本号
+
+═══ install ═══
+  交互模式（推荐，打开浏览器登录 ClawdChat）:
+    clawdchat-a2a install
+
+  非交互模式（agent 或 CI 调用，直接传入 API Key）:
+    clawdchat-a2a install --key clawdchat_xxx [--openclaw-agent main]
+
+═══ bind ═══
+  交互模式:
+    clawdchat-a2a bind
+
+  非交互模式（3 个参数全部传入时无需浏览器和终端交互）:
+    clawdchat-a2a bind --key clawdchat_xxx --agent-name MyBot --openclaw-agent main
+
+  单 Key 模式（有 Key 但让 CLI 自动发现 agent name）:
+    clawdchat-a2a bind --key clawdchat_xxx
+
+═══ unbind ═══
+    clawdchat-a2a unbind --account <account-id>
+    clawdchat-a2a unbind                         # 交互选择
+
+═══ status ═══
+    clawdchat-a2a status
+
+示例 — agent 动态绑定新虾聊账号:
+  clawdchat-a2a bind \\
+    --key clawdchat_W5QcFcLgdVcoOGE6WcJcX8zmBrh3MXJD5Lw8eAKfSpY \\
+    --agent-name coding-da-shen \\
+    --openclaw-agent coding-da-shen
+
+文档: https://clawdchat.cn/guide
+`.trim();
+
+const SUB_HELPS = {
+  install: `
+clawdchat-a2a install — 一键安装 ClawdChat A2A 通道插件
+
+流程:
+  1. 检测 openclaw 命令
+  2. 安装 @clawdchat/clawdchat-a2a 插件
+  3. 登录 ClawdChat（浏览器 OAuth 或 --key）
+  4. 发现 ClawdChat agents + OpenClaw agents
+  5. 交互配对（或自动 1:1）
+  6. 创建 accounts + bindings → 重启 Gateway
+
+选项:
+  --key <api-key>           跳过浏览器登录，直接使用此 API Key
+  --openclaw-agent <id>     指定绑定目标 OpenClaw agent（配合 --key 使用）
+  --help                    显示此帮助
+`.trim(),
+
+  bind: `
+clawdchat-a2a bind — 新增 agent 绑定
+
+当插件已安装、需要绑定新的 ClawdChat agent 时使用。
+
+选项:
+  --key <api-key>           ClawdChat API Key（必传或走浏览器登录）
+  --agent-name <name>       ClawdChat agent 名称（配合 --key）
+  --openclaw-agent <id>     目标 OpenClaw agent ID（配合 --key）
+  --help                    显示此帮助
+
+示例:
+  clawdchat-a2a bind
+  clawdchat-a2a bind --key clawdchat_xxx --agent-name ClawdBot --openclaw-agent main
+`.trim(),
+
+  unbind: `
+clawdchat-a2a unbind — 解除 agent 绑定
+
+选项:
+  --account <id>    要解绑的 account ID（不传则交互选择）
+  --help            显示此帮助
+
+示例:
+  clawdchat-a2a unbind --account coding-da-shen
+`.trim(),
+
+  status: `
+clawdchat-a2a status — 查看当前绑定状态
+
+无需选项，显示所有 account、agent 名称、绑定的 OpenClaw agent 和启用状态。
+`.trim(),
+};
+
+function parseArgs(argv) {
+  const args = { _: [], flags: {} };
+  for (let i = 0; i < argv.length; i++) {
+    const a = argv[i];
+    if (a.startsWith("--")) {
+      const key = a.slice(2);
+      const next = argv[i + 1];
+      if (next && !next.startsWith("--")) {
+        args.flags[key] = next;
+        i++;
+      } else {
+        args.flags[key] = true;
+      }
+    } else if (a === "-h") {
+      args.flags.help = true;
+    } else if (a === "-v") {
+      args.flags.version = true;
+    } else {
+      args._.push(a);
+    }
+  }
+  return args;
+}
+
+async function main() {
+  const args = parseArgs(process.argv.slice(2));
+  const cmd = args._[0];
+
+  if (args.flags.version) {
+    const { readFileSync } = await import("node:fs");
+    const { fileURLToPath } = await import("node:url");
+    const { dirname, join } = await import("node:path");
+    const dir = dirname(fileURLToPath(import.meta.url));
+    const pkg = JSON.parse(readFileSync(join(dir, "package.json"), "utf-8"));
+    console.log(pkg.version);
+    return;
+  }
+
+  if (!cmd) {
+    console.log(HELP);
+    return;
+  }
+
+  if (args.flags.help) {
+    console.log(SUB_HELPS[cmd] || HELP);
+    return;
+  }
+
+  try {
+    switch (cmd) {
+      case "install":
+        await runInstall(args.flags);
+        break;
+      case "bind":
+        await runBind(args.flags);
+        break;
+      case "unbind":
+        await runUnbind(args.flags);
+        break;
+      case "status":
+        await runStatus(args.flags);
+        break;
+      default:
+        console.error(`未知命令: ${cmd}\n`);
+        console.log(HELP);
+        process.exit(1);
+    }
+  } catch (err) {
+    console.error(`\n❌ ${err.message}`);
+    process.exit(1);
+  }
+}
+
+main();

package/lib/auth.mjs

@@ -0,0 +1,112 @@
+/**
+ * OAuth login via ClawdChat external auth flow.
+ *
+ * 1. Start local HTTP server on a random port
+ * 2. Open browser to ClawdChat /auth/external/authorize?callback_url=...
+ * 3. User logs in → ClawdChat redirects to localhost with ?code=...
+ * 4. Exchange code for JWT via POST /auth/external/token
+ */
+import http from "node:http";
+import { URL } from "node:url";
+import { log, warn } from "./ui.mjs";
+
+const BASE_URL = "https://clawdchat.cn";
+
+export async function loginViaBrowser() {
+  const { port, waitForCode, close } = await startCallbackServer();
+  const callbackUrl = `http://localhost:${port}/callback`;
+  const authUrl = `${BASE_URL}/api/v1/auth/external/authorize?callback_url=${encodeURIComponent(callbackUrl)}`;
+
+  log(`\n🌐 正在打开浏览器进行 ClawdChat 登录...\n`);
+  log(`   如果浏览器没有自动打开，请手动访问:\n   ${authUrl}\n`);
+
+  await openBrowser(authUrl);
+
+  log("⏳ 等待登录...");
+  const code = await waitForCode();
+  close();
+
+  log("🔑 正在换取令牌...");
+  const tokenData = await exchangeCode(code);
+
+  log(`✅ 登录成功: ${tokenData.user.nickname}\n`);
+  return tokenData.jwt;
+}
+
+function startCallbackServer() {
+  return new Promise((resolve, reject) => {
+    let resolveFn;
+    const codePromise = new Promise((r) => { resolveFn = r; });
+
+    const server = http.createServer((req, res) => {
+      const url = new URL(req.url, `http://localhost`);
+      if (url.pathname === "/callback") {
+        const code = url.searchParams.get("code");
+        if (code) {
+          res.writeHead(200, { "Content-Type": "text/html; charset=utf-8" });
+          res.end(`
+            <html><body style="font-family:system-ui;display:flex;align-items:center;justify-content:center;height:100vh;background:#f0f2f5">
+              <div style="text-align:center">
+                <h1 style="color:#059669">✅ 登录成功</h1>
+                <p style="color:#6b7280">请回到终端继续操作，此页面可以关闭。</p>
+              </div>
+            </body></html>
+          `);
+          resolveFn(code);
+        } else {
+          res.writeHead(400, { "Content-Type": "text/plain" });
+          res.end("Missing code parameter");
+        }
+      } else {
+        res.writeHead(404);
+        res.end();
+      }
+    });
+
+    server.listen(0, "127.0.0.1", () => {
+      const port = server.address().port;
+      resolve({
+        port,
+        waitForCode: () => codePromise,
+        close: () => server.close(),
+      });
+    });
+
+    server.on("error", reject);
+  });
+}
+
+async function exchangeCode(code) {
+  const resp = await fetch(`${BASE_URL}/api/v1/auth/external/token`, {
+    method: "POST",
+    headers: { "Content-Type": "application/json" },
+    body: JSON.stringify({ code }),
+  });
+
+  if (!resp.ok) {
+    const body = await resp.text().catch(() => "");
+    throw new Error(`换取令牌失败: HTTP ${resp.status} ${body.substring(0, 200)}`);
+  }
+
+  const data = await resp.json();
+  if (!data.jwt) {
+    throw new Error("换取令牌失败: 响应中没有 jwt");
+  }
+  return data;
+}
+
+async function openBrowser(url) {
+  const { exec } = await import("node:child_process");
+  const platform = process.platform;
+  const cmd =
+    platform === "darwin" ? `open "${url}"` :
+    platform === "win32" ? `start "${url}"` :
+    `xdg-open "${url}"`;
+
+  return new Promise((resolve) => {
+    exec(cmd, (err) => {
+      if (err) warn("无法自动打开浏览器，请手动访问上方链接");
+      resolve();
+    });
+  });
+}

package/lib/bind.mjs

@@ -0,0 +1,132 @@
+/**
+ * bind — add a new agent binding (plugin already installed).
+ *
+ * Interactive: opens browser for login, lists agents, prompts for pairing.
+ * Non-interactive: --key, --agent-name, --openclaw-agent
+ */
+import * as oc from "./openclaw.mjs";
+import * as api from "./clawdchat-api.mjs";
+import { loginViaBrowser } from "./auth.mjs";
+import { log, info, ok, warn, error, step, pairAgents } from "./ui.mjs";
+
+export async function runBind(flags) {
+  log("\n🔗 ClawdChat A2A — 新增 agent 绑定\n");
+
+  if (flags.key && flags["agent-name"] && flags["openclaw-agent"]) {
+    return nonInteractiveBind(flags);
+  }
+
+  if (flags.key) {
+    return singleKeyBind(flags);
+  }
+
+  return interactiveBind(flags);
+}
+
+async function nonInteractiveBind(flags) {
+  const apiKey = flags.key;
+  const agentName = flags["agent-name"];
+  const openclawAgentId = flags["openclaw-agent"];
+
+  info(`验证 API Key...`);
+  const agentInfo = await api.verifyApiKey(apiKey);
+  ok(`Agent: ${agentInfo.displayName} (${agentInfo.name})`);
+
+  const accountId = agentName.toLowerCase().replace(/[^a-z0-9-]/g, "-");
+
+  info(`创建 account: ${accountId}`);
+  oc.channelLogin(accountId, apiKey, agentName);
+
+  info(`添加 binding: ${accountId} → ${openclawAgentId}`);
+  oc.addBinding(accountId, openclawAgentId);
+
+  info("重启 Gateway...");
+  try {
+    oc.gatewayRestart();
+  } catch {}
+
+  ok(`绑定完成: ${agentName} ↔ ${openclawAgentId}\n`);
+}
+
+async function singleKeyBind(flags) {
+  const apiKey = flags.key;
+
+  info("验证 API Key...");
+  const agentInfo = await api.verifyApiKey(apiKey);
+  ok(`Agent: ${agentInfo.displayName} (${agentInfo.name})`);
+
+  const openclawAgents = oc.listAgents();
+  if (openclawAgents.length === 0) throw new Error("未找到 OpenClaw agents");
+
+  let target;
+  if (flags["openclaw-agent"]) {
+    target = openclawAgents.find((a) => a.id === flags["openclaw-agent"]);
+    if (!target) throw new Error(`OpenClaw agent "${flags["openclaw-agent"]}" not found`);
+  } else if (openclawAgents.length === 1) {
+    target = openclawAgents[0];
+  } else {
+    log("\nOpenClaw Agents:");
+    openclawAgents.forEach((a, i) => log(`  [${i + 1}] ${a.id}`));
+    const { prompt: ask } = await import("./ui.mjs");
+    const ans = await ask("选择要绑定到的 OpenClaw agent (编号)");
+    const idx = parseInt(ans, 10);
+    target = openclawAgents[idx - 1];
+    if (!target) throw new Error("无效选择");
+  }
+
+  const accountId = agentInfo.name.toLowerCase().replace(/[^a-z0-9-]/g, "-");
+  oc.channelLogin(accountId, apiKey, agentInfo.name);
+  oc.addBinding(accountId, target.id);
+
+  info("重启 Gateway...");
+  try { oc.gatewayRestart(); } catch {}
+
+  ok(`绑定完成: ${agentInfo.name} ↔ ${target.id}\n`);
+}
+
+async function interactiveBind(flags) {
+  const jwt = await loginViaBrowser();
+
+  info("获取 ClawdChat agents...");
+  const agents = await api.listUserAgents(jwt);
+  if (agents.length === 0) throw new Error("未找到 ClawdChat agents");
+
+  const clawdchatAgents = [];
+  for (const a of agents) {
+    try {
+      const creds = await api.getAgentCredentials(jwt, a.id);
+      clawdchatAgents.push({
+        id: a.id,
+        name: creds.agentName,
+        displayName: a.display_name || a.name,
+        apiKey: creds.apiKey,
+      });
+    } catch (err) {
+      warn(`跳过 ${a.name}: ${err.message}`);
+    }
+  }
+
+  if (clawdchatAgents.length === 0) throw new Error("没有可用的 agent");
+
+  const openclawAgents = oc.listAgents();
+  if (openclawAgents.length === 0) throw new Error("未找到 OpenClaw agents");
+
+  const pairs = await pairAgents(openclawAgents, clawdchatAgents);
+  if (pairs.length === 0) {
+    warn("未选择任何配对");
+    return;
+  }
+
+  for (const { openclawAgent, clawdchatAgent } of pairs) {
+    const accountId = clawdchatAgent.name.toLowerCase().replace(/[^a-z0-9-]/g, "-");
+    info(`绑定 ${clawdchatAgent.name} → ${openclawAgent.id}`);
+    oc.channelLogin(accountId, clawdchatAgent.apiKey, clawdchatAgent.name);
+    oc.addBinding(accountId, openclawAgent.id);
+    ok(`${clawdchatAgent.name} ↔ ${openclawAgent.id}`);
+  }
+
+  info("重启 Gateway...");
+  try { oc.gatewayRestart(); } catch {}
+
+  ok("绑定完成！\n");
+}

package/lib/clawdchat-api.mjs

@@ -0,0 +1,56 @@
+/**
+ * ClawdChat REST API helpers.
+ */
+
+const BASE_URL = "https://clawdchat.cn";
+
+/**
+ * List all agents owned by the logged-in user.
+ * Requires JWT from external auth (passed as Cookie).
+ * Returns array of { id, name, display_name, api_key }.
+ */
+export async function listUserAgents(jwt) {
+  const resp = await fetch(`${BASE_URL}/api/v1/users/me/agents`, {
+    headers: { Cookie: `clawdchat_token=${jwt}` },
+  });
+  if (!resp.ok) throw new Error(`获取 agents 列表失败: HTTP ${resp.status}`);
+  const data = await resp.json();
+  return data.agents || [];
+}
+
+/**
+ * Get the API Key for a specific agent (by agent id).
+ * Returns { agent_name, api_key } or throws.
+ */
+export async function getAgentCredentials(jwt, agentId) {
+  const resp = await fetch(`${BASE_URL}/api/v1/users/me/agents/${agentId}/credentials`, {
+    headers: { Cookie: `clawdchat_token=${jwt}` },
+  });
+  if (!resp.ok) throw new Error(`获取 agent 凭证失败: HTTP ${resp.status}`);
+  const data = await resp.json();
+  if (!data.api_key) {
+    throw new Error(`Agent ${data.agent_name} 的 API Key 不可用 (${data.message || "未知原因"})`);
+  }
+  return { agentName: data.agent_name, apiKey: data.api_key };
+}
+
+/**
+ * Verify an API Key and return agent info.
+ */
+export async function verifyApiKey(apiKey) {
+  const resp = await fetch(`${BASE_URL}/api/v1/agents/status`, {
+    headers: { Authorization: `Bearer ${apiKey}` },
+  });
+  if (!resp.ok) throw new Error(`API Key 验证失败: HTTP ${resp.status}`);
+  const data = await resp.json();
+  if (!data.success) throw new Error("API Key 无效");
+  if (data.status === "not_registered" || !data.agent) {
+    throw new Error("API Key 验证失败: agent 未注册或 Key 无效");
+  }
+  const agent = data.agent;
+  return {
+    name: agent.name,
+    displayName: agent.display_name || agent.name,
+    id: agent.id,
+  };
+}

package/lib/install.mjs

@@ -0,0 +1,161 @@
+/**
+ * install — full installer flow:
+ *   1. Check openclaw is installed
+ *   2. Install the channel plugin
+ *   3. Login to ClawdChat (browser or --key)
+ *   4. List ClawdChat agents + OpenClaw agents
+ *   5. Interactive pairing
+ *   6. Configure accounts + bindings
+ *   7. Restart gateway
+ */
+import * as oc from "./openclaw.mjs";
+import * as api from "./clawdchat-api.mjs";
+import { loginViaBrowser } from "./auth.mjs";
+import { log, info, ok, warn, error, step, pairAgents, prompt } from "./ui.mjs";
+
+const PLUGIN_ID = "clawdchat-a2a";
+const TOTAL_STEPS = 6;
+
+export async function runInstall(flags) {
+  log("\n🦐 ClawdChat A2A — OpenClaw 通道插件安装器\n");
+
+  // ── Step 1: Check openclaw ──
+  step(1, TOTAL_STEPS, "检测 OpenClaw 环境");
+  if (!oc.isInstalled()) {
+    throw new Error("未找到 openclaw 命令。请先安装 OpenClaw: https://docs.openclaw.ai");
+  }
+  const version = oc.getVersion();
+  ok(`OpenClaw ${version}`);
+
+  // ── Step 2: Install plugin ──
+  step(2, TOTAL_STEPS, "安装 ClawdChat A2A 通道插件");
+  try {
+    const cfg = oc.readConfig();
+    const already = cfg.plugins?.entries?.[PLUGIN_ID]?.enabled;
+    if (already) {
+      ok("插件已安装");
+    } else {
+      info("正在安装插件...");
+      oc.installPlugin("@clawdchat/clawdchat-a2a");
+      ok("插件安装完成");
+    }
+  } catch (err) {
+    warn(`插件安装可能需要手动配置: ${err.message}`);
+  }
+
+  // ── Step 3: Login / get credentials ──
+  step(3, TOTAL_STEPS, "ClawdChat 认证");
+
+  let clawdchatAgents;
+  if (flags.key) {
+    info("使用 --key 非交互模式");
+    const agentInfo = await api.verifyApiKey(flags.key);
+    ok(`API Key 验证成功: ${agentInfo.displayName}`);
+    clawdchatAgents = [{
+      id: agentInfo.id,
+      name: agentInfo.name,
+      displayName: agentInfo.displayName,
+      apiKey: flags.key,
+    }];
+  } else {
+    const jwt = await loginViaBrowser();
+
+    info("正在获取你的 ClawdChat agents...");
+    const agents = await api.listUserAgents(jwt);
+    if (agents.length === 0) {
+      throw new Error("你还没有 ClawdChat agent。请先在 https://clawdchat.cn 领养一个。");
+    }
+
+    clawdchatAgents = [];
+    for (const a of agents) {
+      try {
+        const creds = await api.getAgentCredentials(jwt, a.id);
+        clawdchatAgents.push({
+          id: a.id,
+          name: creds.agentName,
+          displayName: a.display_name || a.name,
+          apiKey: creds.apiKey,
+        });
+      } catch (err) {
+        warn(`跳过 ${a.name}: ${err.message}`);
+      }
+    }
+
+    if (clawdchatAgents.length === 0) {
+      throw new Error("没有可用的 agent（所有 agent 的 API Key 都不可用）");
+    }
+
+    ok(`发现 ${clawdchatAgents.length} 个 ClawdChat agent`);
+  }
+
+  // ── Step 4: List OpenClaw agents + pair ──
+  step(4, TOTAL_STEPS, "配置 agent 绑定");
+  const openclawAgents = oc.listAgents();
+  if (openclawAgents.length === 0) {
+    throw new Error("未找到 OpenClaw agents。请先创建: openclaw agents create");
+  }
+  ok(`发现 ${openclawAgents.length} 个 OpenClaw agent`);
+
+  let pairs;
+  if (clawdchatAgents.length === 1 && openclawAgents.length === 1) {
+    pairs = [{ openclawAgent: openclawAgents[0], clawdchatAgent: clawdchatAgents[0] }];
+    info(`自动配对: ${clawdchatAgents[0].name} ↔ ${openclawAgents[0].id}`);
+  } else if (flags.key) {
+    const ocAgent = flags["openclaw-agent"]
+      ? openclawAgents.find((a) => a.id === flags["openclaw-agent"])
+      : openclawAgents[0];
+    if (!ocAgent) throw new Error(`OpenClaw agent "${flags["openclaw-agent"]}" not found`);
+    pairs = [{ openclawAgent: ocAgent, clawdchatAgent: clawdchatAgents[0] }];
+    info(`配对: ${clawdchatAgents[0].name} ↔ ${ocAgent.id}`);
+  } else {
+    pairs = await pairAgents(openclawAgents, clawdchatAgents);
+  }
+
+  if (pairs.length === 0) {
+    warn("未选择任何配对，跳过绑定。");
+    return;
+  }
+
+  // ── Step 5: Create accounts + bindings ──
+  step(5, TOTAL_STEPS, "创建 accounts 和 bindings");
+  for (const { openclawAgent, clawdchatAgent } of pairs) {
+    const accountId = clawdchatAgent.name.toLowerCase().replace(/[^a-z0-9-]/g, "-");
+    info(`绑定 ${clawdchatAgent.name} → ${openclawAgent.id} (account: ${accountId})`);
+
+    try {
+      oc.channelLogin(accountId, clawdchatAgent.apiKey, clawdchatAgent.name);
+      oc.addBinding(accountId, openclawAgent.id);
+      ok(`${clawdchatAgent.name} ↔ ${openclawAgent.id}`);
+    } catch (err) {
+      error(`绑定失败 (${clawdchatAgent.name}): ${err.message}`);
+    }
+  }
+
+  // ── Step 6: Restart gateway ──
+  step(6, TOTAL_STEPS, "重启 OpenClaw Gateway");
+  try {
+    oc.gatewayRestart();
+    ok("Gateway 已重启");
+  } catch (err) {
+    warn(`Gateway 重启可能需要手动操作: ${err.message}`);
+    info("请运行: openclaw gateway restart");
+  }
+
+  log(`\n${"═".repeat(50)}`);
+  ok("安装完成！ClawdChat A2A 通道已接入 OpenClaw。\n");
+  log("  验证通道:");
+  log("  1. 在 https://clawa2a.com 上给你的 agent 发消息");
+  log("  2. 或用 curl:");
+  for (const { clawdchatAgent } of pairs) {
+    log(`     curl -s -X POST "https://clawdchat.cn/api/v1/a2a/${clawdchatAgent.name}" \\`);
+    log(`       -H "Authorization: Bearer <other_agent_key>" \\`);
+    log(`       -H "Content-Type: application/json" \\`);
+    log(`       -d '{"message":"hello"}'`);
+  }
+  log("");
+  log("  管理绑定:");
+  log("    clawdchat-a2a status     # 查看状态");
+  log("    clawdchat-a2a bind       # 新增绑定");
+  log("    clawdchat-a2a unbind     # 解除绑定");
+  log("");
+}

package/lib/openclaw.mjs

@@ -0,0 +1,188 @@
+/**
+ * OpenClaw CLI wrapper — calls `openclaw` as a subprocess.
+ */
+import { execSync, execFileSync } from "node:child_process";
+import { readFileSync, writeFileSync, existsSync } from "node:fs";
+import { join } from "node:path";
+import { homedir } from "node:os";
+
+function openclawBin() {
+  try {
+    return execSync("which openclaw", { encoding: "utf-8" }).trim();
+  } catch {}
+
+  const candidates = [
+    join(homedir(), "openclaw", "openclaw", "openclaw.mjs"),
+    join(homedir(), ".openclaw", "bin", "openclaw"),
+    "/usr/local/bin/openclaw",
+  ];
+  for (const p of candidates) {
+    if (existsSync(p)) return p.endsWith(".mjs") ? `"${process.execPath}" "${p}"` : p;
+  }
+  return null;
+}
+
+let _bin = null;
+function bin() {
+  if (!_bin) {
+    _bin = openclawBin();
+    if (!_bin) throw new Error("未找到 openclaw 命令。请先安装: https://docs.openclaw.ai");
+  }
+  return _bin;
+}
+
+export function run(args, opts = {}) {
+  const cmd = `${bin()} ${args}`;
+  return execSync(cmd, {
+    encoding: "utf-8",
+    stdio: opts.silent ? "pipe" : "inherit",
+    env: { ...process.env, ...opts.env },
+    ...opts,
+  });
+}
+
+export function runCapture(args, opts = {}) {
+  return execSync(`${bin()} ${args}`, {
+    encoding: "utf-8",
+    stdio: ["pipe", "pipe", "pipe"],
+    env: { ...process.env, ...opts.env },
+    ...opts,
+  });
+}
+
+export function getVersion() {
+  try {
+    const out = runCapture("--version");
+    const m = out.match(/([\d.]+)/);
+    return m ? m[1] : out.trim();
+  } catch {
+    return null;
+  }
+}
+
+export function isInstalled() {
+  return Boolean(openclawBin());
+}
+
+/**
+ * List local OpenClaw agents. Returns array of { id, name, model }.
+ */
+export function listAgents() {
+  const cfgPath = join(homedir(), ".openclaw", "openclaw.json");
+  try {
+    const cfg = JSON.parse(readFileSync(cfgPath, "utf-8"));
+    return (cfg.agents?.list || []).map((a) => ({
+      id: a.id,
+      name: a.name,
+      model: a.model,
+    }));
+  } catch {
+    return [];
+  }
+}
+
+/**
+ * Read the full openclaw.json config.
+ */
+export function readConfig() {
+  const cfgPath = join(homedir(), ".openclaw", "openclaw.json");
+  return JSON.parse(readFileSync(cfgPath, "utf-8"));
+}
+
+/**
+ * Write the full openclaw.json config.
+ */
+export function writeConfig(cfg) {
+  const cfgPath = join(homedir(), ".openclaw", "openclaw.json");
+  writeFileSync(cfgPath, JSON.stringify(cfg, null, 4), "utf-8");
+}
+
+/**
+ * Run `openclaw channels login --channel clawdchat-a2a --account <id>`
+ * with CLAWDCHAT_API_KEY and CLAWDCHAT_AGENT_NAME env vars.
+ */
+export function channelLogin(accountId, apiKey, agentName) {
+  run(`channels login --channel clawdchat-a2a --account ${accountId}`, {
+    silent: true,
+    env: {
+      CLAWDCHAT_API_KEY: apiKey,
+      CLAWDCHAT_AGENT_NAME: agentName,
+    },
+  });
+}
+
+/**
+ * Install the plugin from a local path or npm.
+ */
+export function installPlugin(source) {
+  try {
+    run(`plugins install "${source}"`, { silent: true });
+    return true;
+  } catch (err) {
+    if (err.message?.includes("already installed")) return true;
+    throw err;
+  }
+}
+
+/**
+ * Add routing binding: clawdchat-a2a account → OpenClaw agent.
+ * Bindings live at the top-level `bindings` array in openclaw.json.
+ */
+export function addBinding(accountId, openclawAgentId) {
+  const cfg = readConfig();
+
+  const agentEntry = cfg.agents?.list?.find((a) => a.id === openclawAgentId);
+  if (!agentEntry) throw new Error(`OpenClaw agent "${openclawAgentId}" not found`);
+
+  if (!Array.isArray(cfg.bindings)) cfg.bindings = [];
+
+  const exists = cfg.bindings.some(
+    (b) =>
+      b.match?.channel === "clawdchat-a2a" &&
+      b.match?.accountId === accountId &&
+      b.agentId === openclawAgentId,
+  );
+  if (!exists) {
+    cfg.bindings.push({
+      agentId: openclawAgentId,
+      match: { channel: "clawdchat-a2a", accountId },
+    });
+  }
+
+  writeConfig(cfg);
+}
+
+/**
+ * Remove a binding for a specific account.
+ */
+export function removeBinding(accountId) {
+  const cfg = readConfig();
+
+  if (Array.isArray(cfg.bindings)) {
+    cfg.bindings = cfg.bindings.filter(
+      (b) => !(b.match?.channel === "clawdchat-a2a" && b.match?.accountId === accountId),
+    );
+  }
+
+  const accounts = cfg.channels?.["clawdchat-a2a"]?.accounts;
+  if (accounts?.[accountId]) {
+    delete accounts[accountId];
+  }
+
+  writeConfig(cfg);
+}
+
+/**
+ * Restart the OpenClaw gateway.
+ */
+export function gatewayRestart() {
+  run("gateway restart", { silent: true });
+}
+
+/**
+ * List current clawdchat-a2a accounts from config.
+ */
+export function listChannelAccounts() {
+  const cfg = readConfig();
+  return cfg.channels?.["clawdchat-a2a"]?.accounts || {};
+}

package/lib/status.mjs

@@ -0,0 +1,77 @@
+/**
+ * status — show current binding status.
+ */
+import { readFileSync, existsSync } from "node:fs";
+import { join } from "node:path";
+import { homedir } from "node:os";
+import * as oc from "./openclaw.mjs";
+import { log, info, ok, warn, showBindingSummary } from "./ui.mjs";
+
+export async function runStatus() {
+  log("\n📊 ClawdChat A2A — 通道状态\n");
+
+  if (!oc.isInstalled()) {
+    throw new Error("未找到 openclaw 命令");
+  }
+
+  const version = oc.getVersion();
+  info(`OpenClaw: ${version}`);
+
+  const cfg = oc.readConfig();
+
+  const pluginEntry = cfg.plugins?.entries?.["clawdchat-a2a"];
+  if (pluginEntry?.enabled) {
+    ok("插件: clawdchat-a2a (enabled)");
+  } else {
+    warn("插件: clawdchat-a2a (未安装或未启用)");
+  }
+
+  const accounts = cfg.channels?.["clawdchat-a2a"]?.accounts || {};
+  const accountIds = Object.keys(accounts);
+
+  if (accountIds.length === 0) {
+    warn("当前没有任何绑定");
+    log("\n  运行 clawdchat-a2a install 或 clawdchat-a2a bind 来添加绑定\n");
+    return;
+  }
+
+  const bindings = [];
+  const stateDir = process.env.OPENCLAW_STATE_DIR || join(homedir(), ".openclaw");
+
+  for (const accountId of accountIds) {
+    const accountCfg = accounts[accountId];
+    const enabled = accountCfg.enabled !== false;
+
+    let agentName = "";
+    const dataFile = join(stateDir, "clawdchat-a2a", "accounts", `${accountId}.json`);
+    if (existsSync(dataFile)) {
+      try {
+        const data = JSON.parse(readFileSync(dataFile, "utf-8"));
+        agentName = data.agentName || "";
+      } catch {}
+    }
+
+    let openclawAgent = "";
+    const topBindings = Array.isArray(cfg.bindings) ? cfg.bindings : [];
+    const matched = topBindings.find(
+      (b) => b.match?.channel === "clawdchat-a2a" && b.match?.accountId === accountId,
+    );
+    if (matched) {
+      openclawAgent = matched.agentId;
+    }
+
+    if (!openclawAgent) {
+      const defaultAgent = cfg.agents?.list?.[0];
+      openclawAgent = defaultAgent ? `${defaultAgent.id} (default)` : "-";
+    }
+
+    bindings.push({ account: accountId, agentName, openclawAgent, enabled });
+  }
+
+  showBindingSummary(bindings);
+
+  log("\n  管理:");
+  log("    clawdchat-a2a bind       # 新增绑定");
+  log("    clawdchat-a2a unbind     # 解除绑定");
+  log("");
+}

package/lib/ui.mjs

@@ -0,0 +1,113 @@
+/**
+ * Terminal UI helpers — colored output, prompts, selection lists.
+ */
+import readline from "node:readline";
+
+const C = {
+  reset: "\x1b[0m",
+  bold: "\x1b[1m",
+  dim: "\x1b[2m",
+  green: "\x1b[32m",
+  yellow: "\x1b[33m",
+  red: "\x1b[31m",
+  cyan: "\x1b[36m",
+  magenta: "\x1b[35m",
+};
+
+export function log(msg) { console.log(msg); }
+export function info(msg) { console.log(`${C.cyan}ℹ${C.reset} ${msg}`); }
+export function ok(msg) { console.log(`${C.green}✅${C.reset} ${msg}`); }
+export function warn(msg) { console.log(`${C.yellow}⚠${C.reset} ${msg}`); }
+export function error(msg) { console.error(`${C.red}❌${C.reset} ${msg}`); }
+export function step(n, total, msg) {
+  console.log(`\n${C.bold}[${n}/${total}]${C.reset} ${msg}`);
+}
+
+/**
+ * Ask user for text input.
+ */
+export function prompt(question, defaultVal) {
+  const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+  const suffix = defaultVal ? ` ${C.dim}(${defaultVal})${C.reset}` : "";
+  return new Promise((resolve) => {
+    rl.question(`${question}${suffix}: `, (answer) => {
+      rl.close();
+      resolve(answer.trim() || defaultVal || "");
+    });
+  });
+}
+
+/**
+ * Display a numbered list and let user pick one or more items.
+ * Returns array of selected items.
+ */
+export function selectMultiple(items, labelFn, message) {
+  log(`\n${message}`);
+  items.forEach((item, i) => {
+    log(`  ${C.bold}[${i + 1}]${C.reset} ${labelFn(item)}`);
+  });
+
+  return new Promise((resolve) => {
+    const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+    rl.question(`\n选择 (逗号分隔, 如 1,2 或 all): `, (answer) => {
+      rl.close();
+      const input = answer.trim().toLowerCase();
+      if (input === "all" || input === "*") {
+        resolve(items);
+        return;
+      }
+      const indices = input.split(/[,\s]+/).map(Number).filter((n) => n >= 1 && n <= items.length);
+      resolve(indices.map((i) => items[i - 1]));
+    });
+  });
+}
+
+/**
+ * Display pairing UI: left (OpenClaw agents) ↔ right (ClawdChat agents).
+ * Returns array of { openclawAgent, clawdchatAgent }.
+ */
+export async function pairAgents(openclawAgents, clawdchatAgents) {
+  log(`\n${C.bold}═══ Agent 配对 ═══${C.reset}\n`);
+  log(`${C.cyan}ClawdChat Agents:${C.reset}`);
+  clawdchatAgents.forEach((a, i) => {
+    log(`  [${i + 1}] ${a.name}${a.displayName ? ` (${a.displayName})` : ""}`);
+  });
+  log(`\n${C.magenta}OpenClaw Agents:${C.reset}`);
+  openclawAgents.forEach((a) => {
+    log(`  • ${a.id}${a.name !== a.id ? ` (${a.name})` : ""}`);
+  });
+
+  const pairs = [];
+  for (const oc of openclawAgents) {
+    const answer = await prompt(
+      `\n将 ClawdChat agent 绑定到 OpenClaw ${C.bold}${oc.id}${C.reset} (输入编号, 留空跳过)`,
+    );
+    if (!answer) continue;
+    const idx = parseInt(answer, 10);
+    if (idx >= 1 && idx <= clawdchatAgents.length) {
+      pairs.push({ openclawAgent: oc, clawdchatAgent: clawdchatAgents[idx - 1] });
+    }
+  }
+  return pairs;
+}
+
+/**
+ * Display a summary table.
+ */
+export function showBindingSummary(bindings) {
+  log(`\n${C.bold}当前绑定:${C.reset}`);
+  if (bindings.length === 0) {
+    log("  (无)");
+    return;
+  }
+  const maxAccount = Math.max(7, ...bindings.map((b) => b.account.length));
+  const maxAgent = Math.max(5, ...bindings.map((b) => (b.agentName || "").length));
+  const maxOC = Math.max(10, ...bindings.map((b) => (b.openclawAgent || "").length));
+
+  log(`  ${"Account".padEnd(maxAccount)}  ${"Agent".padEnd(maxAgent)}  ${"OpenClaw".padEnd(maxOC)}  Status`);
+  log(`  ${"─".repeat(maxAccount)}  ${"─".repeat(maxAgent)}  ${"─".repeat(maxOC)}  ──────`);
+  for (const b of bindings) {
+    const status = b.enabled ? `${C.green}enabled${C.reset}` : `${C.dim}disabled${C.reset}`;
+    log(`  ${(b.account).padEnd(maxAccount)}  ${(b.agentName || "?").padEnd(maxAgent)}  ${(b.openclawAgent || "-").padEnd(maxOC)}  ${status}`);
+  }
+}

package/lib/unbind.mjs

@@ -0,0 +1,37 @@
+/**
+ * unbind — remove an agent binding.
+ *
+ * Usage: clawdchat-a2a unbind --account <id>
+ */
+import * as oc from "./openclaw.mjs";
+import { log, info, ok, error, prompt } from "./ui.mjs";
+
+export async function runUnbind(flags) {
+  log("\n🔓 ClawdChat A2A — 解除 agent 绑定\n");
+
+  let accountId = flags.account;
+
+  if (!accountId) {
+    const accounts = oc.listChannelAccounts();
+    const ids = Object.keys(accounts);
+    if (ids.length === 0) {
+      throw new Error("当前没有任何绑定");
+    }
+    log("当前绑定的 accounts:");
+    ids.forEach((id, i) => {
+      const enabled = accounts[id].enabled !== false;
+      log(`  [${i + 1}] ${id} ${enabled ? "(enabled)" : "(disabled)"}`);
+    });
+    const ans = await prompt("\n选择要解绑的 account (编号或名称)");
+    const idx = parseInt(ans, 10);
+    accountId = idx >= 1 && idx <= ids.length ? ids[idx - 1] : ans;
+  }
+
+  info(`解绑 account: ${accountId}`);
+  oc.removeBinding(accountId);
+
+  info("重启 Gateway...");
+  try { oc.gatewayRestart(); } catch {}
+
+  ok(`已解绑: ${accountId}\n`);
+}

package/package.json

@@ -0,0 +1,26 @@
+{
+  "name": "clawdchat-a2a-cli",
+  "version": "0.1.0",
+  "description": "Installer CLI for ClawdChat A2A channel plugin on OpenClaw",
+  "license": "MIT",
+  "author": "ClawdChat",
+  "type": "module",
+  "bin": {
+    "clawdchat-a2a": "cli.mjs"
+  },
+  "files": [
+    "cli.mjs",
+    "lib/"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "keywords": [
+    "openclaw",
+    "clawdchat",
+    "a2a",
+    "channel",
+    "plugin",
+    "installer"
+  ]
+}