微信 ClawBot：首个官方个人号 Bot API iLink 协议拆解与实战

const ILINK_BASE = "https://ilinkai.weixin.qq.com";

async function login() {
  const qrRes = await fetch(
    `${ILINK_BASE}/ilink/bot/get_bot_qrcode?bot_type=3`,
    { headers: makeHeaders() }
  );
  const qrData = await qrRes.json();
  const qrcodeUrl = qrData.qrcode_img_content;
  const qrcodeKey = qrData.qrcode;
  qrterm.generate(qrcodeUrl, { small: true });

  while (true) {
    await sleep(2000);
    const statusRes = await fetch(
      `${ILINK_BASE}/ilink/bot/get_qrcode_status?qrcode=${qrcodeKey}`,
      { headers: makeHeaders() }
    );
    const statusData = await statusRes.json();
    if (statusData.bot_token) {
      return {
        bot_token: statusData.bot_token,
        baseurl: statusData.baseurl || ILINK_BASE,
      };
    }
  }
}

async function pollLoop(tokenData, onMessage) {
  let cursor = "";
  while (true) {
    try {
      const data = await apiPost(
        tokenData.baseurl,
        "ilink/bot/getupdates",
        { get_updates_buf: cursor, base_info: { channel_version: "1.0.2" } },
        tokenData.bot_token,
        40_000
      );
      if (data.get_updates_buf) cursor = data.get_updates_buf;
      for (const msg of (data.msgs || [])) {
        if (msg.message_type === 2) continue; // 跳过 bot 自己的消息
        const text = msg.item_list
          ?.filter(i => i.type === 1 && i.text_item)
          .map(i => i.text_item.text)
          .join("");
        await onMessage(msg, text);
      }
    } catch (err) {
      if (err.name === "AbortError") continue;
      await sleep(3000);
    }
  }
}

async function sendText(baseUrl, token, to, contextToken, text) {
  return apiPost(baseUrl, "ilink/bot/sendmessage", {
    msg: {
      from_user_id: "",
      to_user_id: to,
      client_id: `demo-${crypto.randomUUID()}`,
      message_type: 2,    // BOT 发送
      message_state: 2,    // FINISH
      context_token: contextToken,
      item_list: [{ type: 1, text_item: { text } }],
    },
    base_info: { channel_version: "1.0.2" },
  }, token);
}