Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

​

Yuanbao

​

Szybki start

Wymaga OpenClaw 2026.4.10 lub nowszego. Uruchom openclaw --version, aby sprawdzić wersję. Zaktualizuj za pomocą openclaw update.

openclaw channels add --channel yuanbao --token "appKey:appSecret"

openclaw gateway restart

​

Konfiguracja interaktywna (alternatywa)

openclaw channels login --channel yuanbao

​

Kontrola dostępu

​

Wiadomości bezpośrednie

• "pairing" — nieznani użytkownicy otrzymują kod parowania; zatwierdź przez CLI
• "allowlist" — czatować mogą tylko użytkownicy wymienieni w allowFrom
• "open" — zezwól wszystkim użytkownikom (domyślnie)
• "disabled" — wyłącz wszystkie wiadomości bezpośrednie

openclaw pairing list yuanbao
openclaw pairing approve yuanbao <CODE>

​

Czaty grupowe

• true — wymagaj @wzmianki (domyślnie)
• false — odpowiadaj bez @wzmianki

​

Przykłady konfiguracji

​

Podstawowa konfiguracja z otwartą polityką wiadomości bezpośrednich

{
  channels: {
    yuanbao: {
      appKey: "your_app_key",
      appSecret: "your_app_secret",
      dm: {
        policy: "open",
      },
    },
  },
}

​

Ogranicz wiadomości bezpośrednie do określonych użytkowników

{
  channels: {
    yuanbao: {
      appKey: "your_app_key",
      appSecret: "your_app_secret",
      dm: {
        policy: "allowlist",
        allowFrom: ["user_id_1", "user_id_2"],
      },
    },
  },
}

​

Wyłącz wymóg @wzmianki w grupach

{
  channels: {
    yuanbao: {
      requireMention: false,
    },
  },
}

​

Zoptymalizuj dostarczanie wiadomości wychodzących

{
  channels: {
    yuanbao: {
      // Send each chunk immediately without buffering
      outboundQueueStrategy: "immediate",
    },
  },
}

​

Dostrój strategię scalania tekstu

{
  channels: {
    yuanbao: {
      outboundQueueStrategy: "merge-text",
      minChars: 2800, // buffer until this many chars
      maxChars: 3000, // force split above this limit
      idleMs: 5000, // auto-flush after idle timeout (ms)
    },
  },
}

​

Typowe polecenia

Yuanbao obsługuje natywne menu poleceń ukośnikowych. Polecenia są automatycznie synchronizowane z platformą po uruchomieniu Gateway.

​

Rozwiązywanie problemów

​

Bot nie odpowiada w czatach grupowych

1. Upewnij się, że bot został dodany do grupy
2. Upewnij się, że używasz @wzmianki o bocie (wymagane domyślnie)
3. Sprawdź logi: openclaw logs --follow

​

Bot nie odbiera wiadomości

1. Upewnij się, że bot został utworzony i zatwierdzony w aplikacji Yuanbao
2. Upewnij się, że appKey i appSecret są poprawnie skonfigurowane
3. Upewnij się, że Gateway działa: openclaw gateway status
4. Sprawdź logi: openclaw logs --follow

​

Bot wysyła puste lub zastępcze odpowiedzi

1. Sprawdź, czy model AI zwraca prawidłową treść
2. Domyślna odpowiedź zastępcza to: “暂时无法解答，你可以换个问题问问我哦”
3. Dostosuj ją przez channels.yuanbao.fallbackReply

​

App Secret wyciekł

1. Zresetuj App Secret w YuanBao APP
2. Zaktualizuj wartość w swojej konfiguracji
3. Uruchom ponownie Gateway: openclaw gateway restart

​

Konfiguracja zaawansowana

​

Wiele kont

{
  channels: {
    yuanbao: {
      defaultAccount: "main",
      accounts: {
        main: {
          appKey: "key_xxx",
          appSecret: "secret_xxx",
          name: "Primary bot",
        },
        backup: {
          appKey: "key_yyy",
          appSecret: "secret_yyy",
          name: "Backup bot",
          enabled: false,
        },
      },
    },
  },
}

​

Limity wiadomości

• maxChars — maksymalna liczba znaków w pojedynczej wiadomości (domyślnie: 3000 znaków)
• mediaMaxMb — limit przesyłania/pobierania multimediów (domyślnie: 20 MB)
• overflowPolicy — zachowanie, gdy wiadomość przekracza limit: "split" (domyślnie) lub "stop"

​

Streaming

{
  channels: {
    yuanbao: {
      disableBlockStreaming: false, // block streaming enabled (default)
    },
  },
}

​

Kontekst historii czatu grupowego

{
  channels: {
    yuanbao: {
      historyLimit: 100, // default: 100, set 0 to disable
    },
  },
}

​

Tryb odpowiedzi do wiadomości

{
  channels: {
    yuanbao: {
      replyToMode: "first", // "off" | "first" | "all" (default: "first")
    },
  },
}

​

Wstrzykiwanie wskazówki Markdown

{
  channels: {
    yuanbao: {
      markdownHintEnabled: true, // default: true
    },
  },
}

​

Tryb debugowania

{
  channels: {
    yuanbao: {
      debugBotIds: ["bot_user_id_1", "bot_user_id_2"],
    },
  },
}

​

Routing wielu agentów

{
  agents: {
    list: [
      { id: "main" },
      { id: "agent-a", workspace: "/home/user/agent-a" },
      { id: "agent-b", workspace: "/home/user/agent-b" },
    ],
  },
  bindings: [
    {
      agentId: "agent-a",
      match: {
        channel: "yuanbao",
        peer: { kind: "direct", id: "user_xxx" },
      },
    },
    {
      agentId: "agent-b",
      match: {
        channel: "yuanbao",
        peer: { kind: "group", id: "group_zzz" },
      },
    },
  ],
}

• match.channel: "yuanbao"
• match.peer.kind: "direct" (wiadomość bezpośrednia) lub "group" (czat grupowy)
• match.peer.id: identyfikator użytkownika lub kod grupy

​

Dokumentacja konfiguracji

​

Obsługiwane typy wiadomości

​

Odbieranie

• ✅ Tekst
• ✅ Obrazy
• ✅ Pliki
• ✅ Audio / głos
• ✅ Wideo
• ✅ Naklejki / niestandardowe emoji
• ✅ Elementy niestandardowe (karty linków itp.)

​

Wysyłanie

• ✅ Tekst (z obsługą markdown)
• ✅ Obrazy
• ✅ Pliki
• ✅ Audio
• ✅ Wideo
• ✅ Naklejki

​

Wątki i odpowiedzi

• ✅ Odpowiedzi z cytatem (konfigurowalne przez replyToMode)
• ❌ Odpowiedzi w wątkach (nieobsługiwane przez platformę)

​

Powiązane

• Przegląd kanałów — wszystkie obsługiwane kanały
• Parowanie — uwierzytelnianie wiadomości bezpośrednich i przepływ parowania
• Grupy — zachowanie czatu grupowego i bramkowanie wzmiankami
• Routing kanałów — routing sesji dla wiadomości
• Bezpieczeństwo — model dostępu i wzmacnianie zabezpieczeń