HKUDS/nanobot · error · ChannelConnectError

Unable to start Feishu/Lark connection: {exc}

Error message

Unable to start Feishu/Lark connection: {exc}

What it means

Error "Unable to start Feishu/Lark connection: {exc}" thrown in HKUDS/nanobot.

Source

Thrown at nanobot/channels/feishu/connect.py:82

        if action == "cancel":
            return await asyncio.to_thread(self.cancel, session_id)
        raise ChannelConnectError(f"unsupported Feishu connect action: {action}", status=404)

    def start(
        self,
        *,
        domain: str = "feishu",
        instance_id: str = DEFAULT_INSTANCE_ID,
        mode: str = "replace",
    ) -> dict[str, Any]:
        domain = _normalize_domain(domain)
        instance_id = _resolve_instance_id(instance_id, mode)
        self._cleanup()
        try:
            feishu._init_registration(domain)
            begin = feishu._begin_registration(domain)
        except (RuntimeError, OSError, json.JSONDecodeError, httpx.HTTPError) as exc:
            raise ChannelConnectError(
                f"Unable to start Feishu/Lark connection: {exc}",
                status=502,
            ) from exc

        session_id = secrets.token_urlsafe(18)
        now_wall = time.time()
        now = time.monotonic()
        expire_in = int(begin["expire_in"])
        interval = max(2, int(begin["interval"]))
        session = FeishuConnectSession(
            id=session_id,
            instance_id=instance_id,
            instance_name=_default_instance_name(instance_id),
            device_code=str(begin["device_code"]),
            qr_url=str(begin["qr_url"]),
            domain=domain,
            interval=interval,
            expire_in=expire_in,

View on GitHub (pinned to 42f37dc4c0)

When it happens

Trigger: Thrown at nanobot/channels/feishu/connect.py:82 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of HKUDS/nanobot@42f37dc4c0 (2026-08-26). Data as JSON: /api/errors/c4de19f7ae9d31c1. Report an issue: GitHub.