Skip to main content

Documentation Index

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

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

ClickClack підключає OpenClaw до самостійно розгорнутого робочого простору ClickClack через повноцінні токени ботів ClickClack. Використовуйте це, коли потрібно, щоб агент OpenClaw відображався як користувач-бот ClickClack. ClickClack підтримує незалежних сервісних ботів і ботів, що належать користувачам; боти, що належать користувачам, зберігають owner_user_id і отримують лише ті області дії токена, які ви надаєте.

Швидке налаштування

Створіть токен бота в ClickClack:
clickclack admin bot create \
  --workspace <workspace_id_or_slug> \
  --name "OpenClaw" \
  --handle openclaw \
  --scopes bot:write \
  --plain
Для бота, що належить користувачу, додайте --owner <user_id>. Налаштуйте OpenClaw:
{
  plugins: {
    entries: {
      clickclack: {
        llm: {
          allowAgentIdOverride: true,
        },
      },
    },
  },
  channels: {
    clickclack: {
      enabled: true,
      baseUrl: "https://app.clickclack.chat",
      token: { source: "env", provider: "default", id: "CLICKCLACK_BOT_TOKEN" },
      workspace: "default",
      defaultTo: "channel:general",
      agentId: "clickclack-bot",
      replyMode: "model",
    },
  },
}
Потім запустіть:
export CLICKCLACK_BOT_TOKEN="ccb_..."
openclaw gateway

Кілька ботів

Кожен обліковий запис відкриває власне з’єднання ClickClack у реальному часі та використовує власний токен бота.
{
  plugins: {
    entries: {
      clickclack: {
        llm: {
          allowAgentIdOverride: true,
        },
      },
    },
  },
  channels: {
    clickclack: {
      enabled: true,
      baseUrl: "https://app.clickclack.chat",
      defaultAccount: "service",
      accounts: {
        service: {
          token: { source: "env", provider: "default", id: "CLICKCLACK_SERVICE_BOT_TOKEN" },
          workspace: "default",
          defaultTo: "channel:general",
          agentId: "service-bot",
          replyMode: "model",
        },
        peter: {
          token: { source: "env", provider: "default", id: "CLICKCLACK_PETER_BOT_TOKEN" },
          workspace: "default",
          defaultTo: "dm:usr_...",
          agentId: "peter-bot",
          replyMode: "model",
        },
      },
    },
  },
}
replyMode: "model" використовує api.runtime.llm.complete безпосередньо для коротких відповідей бота. Коли обліковий запис задає agentId, OpenClaw вимагає явний біт довіри plugins.entries.clickclack.llm.allowAgentIdOverride, щоб Plugin міг виконувати доповнення для цього агента бота. Залишайте його вимкненим, якщо ви використовуєте лише стандартний маршрут агента.

Цілі

  • channel:<name-or-id> надсилає до каналу робочого простору. Цілі без префікса за замовчуванням використовують channel:.
  • dm:<user_id> створює або повторно використовує пряму розмову з цим користувачем.
  • thread:<message_id> відповідає в наявному треді.
Приклади:
openclaw message send --channel clickclack --target channel:general --message "hello"
openclaw message send --channel clickclack --target dm:usr_123 --message "hello"
openclaw message send --channel clickclack --target thread:msg_123 --message "following up"

Дозволи

Області дії токенів ClickClack застосовуються API ClickClack.
  • bot:read: читання даних робочого простору, каналу, повідомлення, треду, приватних повідомлень, реального часу та профілю.
  • bot:write: bot:read плюс повідомлення в каналах, відповіді в тредах, приватні повідомлення та завантаження файлів.
  • bot:admin: bot:write плюс створення каналів.
OpenClaw потребує лише bot:write для звичайного чату агента.

Усунення несправностей

  • ClickClack is not configured: задайте channels.clickclack.token або CLICKCLACK_BOT_TOKEN.
  • workspace not found: задайте для workspace ідентифікатор або slug робочого простору, повернений ClickClack.
  • Немає вхідних відповідей: переконайтеся, що токен має доступ до читання в реальному часі, а бот не відповідає на власні повідомлення.
  • Не вдається надіслати в канал: перевірте, що бот є учасником робочого простору та має bot:write.