ClickClack

​

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

openclaw channels add clickclack --base-url https://clickclack.example.com --token ccb_... --workspace default

openclaw gateway

openclaw onboard

​

Альтернатива: токен зі змінної середовища

export CLICKCLACK_BOT_TOKEN="ccb_..."
openclaw channels add clickclack --base-url https://clickclack.example.com --workspace default --use-env
openclaw gateway

​

Довідка щодо JSON5

{
  channels: {
    clickclack: {
      enabled: true,
      baseUrl: "https://clickclack.example.com",
      token: { source: "env", provider: "default", id: "CLICKCLACK_BOT_TOKEN" },
      workspace: "default",
      defaultTo: "channel:general",
    },
  },
}

​

Ключі конфігурації облікового запису

​

Кілька ботів

{
  channels: {
    clickclack: {
      enabled: true,
      baseUrl: "https://clickclack.example.com",
      defaultAccount: "service",
      accounts: {
        service: {
          token: { source: "env", provider: "default", id: "CLICKCLACK_SERVICE_BOT_TOKEN" },
          workspace: "default",
          defaultTo: "channel:general",
          agentId: "service-bot",
        },
        support: {
          token: { source: "env", provider: "default", id: "CLICKCLACK_SUPPORT_BOT_TOKEN" },
          workspace: "default",
          defaultTo: "dm:usr_...",
          agentId: "support-bot",
        },
      },
    },
  },
}

​

Режими відповіді

• replyMode: "agent" (за замовчуванням) передає вхідні повідомлення через звичайний конвеєр агента, включно із записуванням сеансу та політикою інструментів.
• replyMode: "model" оминає конвеєр агента та використовує llm.complete середовища виконання плагіна для прямих відповідей бота, форму яких за потреби визначають model і systemPrompt. Вибрані постачальник і модель визначають бюджет завершення.

{
  plugins: {
    entries: {
      clickclack: {
        llm: {
          allowAgentIdOverride: true,
        },
      },
    },
  },
}

​

Меню команд

{
  channels: {
    clickclack: {
      enabled: true,
      token: { source: "env", provider: "default", id: "CLICKCLACK_BOT_TOKEN" },
      workspace: "default",
      commandMenu: false,
    },
  },
}

​

Надійна доставка медіафайлів

• GET /api/uploads/by-nonce з X-ClickClack-Upload-Nonce: supported для результатів, де об’єкт знайдено або не знайдено.
• GET /api/messages/by-nonce з X-ClickClack-Message-Nonce: supported для результатів, де об’єкт знайдено або не знайдено.
• Ідемпотентне створення повідомлення та пов’язування вкладення для того самого одноразового значення й передавання в межах власника.

​

Рядки активності агента

{
  channels: {
    clickclack: {
      enabled: true,
      token: { source: "env", provider: "default", id: "CLICKCLACK_BOT_TOKEN" },
      workspace: "default",
      agentActivity: true,
    },
  },
}

• За замовчуванням вимкнено. Стандартні налаштування та старіші сервери ClickClack залишаються без змін.
• Потребує області доступу токена agent_activity:write. Ця область доступу відокремлена від bot:write і не успадковується від неї; перш ніж вмикати цей параметр, створіть токен бота з --scopes bot:write,agent_activity:write (або надайте цю область доступу наявному токену).
• Деградація за принципом найкращих зусиль. Якщо токен не має agent_activity:write або сервер відхиляє записи активності, помилки записуються в журнал, а остаточна відповідь усе одно доставляється звичайним чином; рядки активності не з’являються.
• Рядки групуються за ходом (turn_id) і об’єднуються так, щоб один логічний крок відповідав одному рядку, а рядки інструментів використовують те саме форматування перебігу виконання, що й Discord/Slack/Telegram (назва інструмента та відомості про команду).
• Метадані атрибуції. Дописи, створені агентом (рядки активності та остаточна відповідь), містять поля author_model і author_thinking, визначені за фактичною моделлю, використаною для ходу (зокрема після переходу на резервну модель). Сервери, у яких ці стовпці не визначено, ігнорують невідомі поля JSON; сервери, що зберігають їх, можуть для кожного повідомлення відповісти на запитання «яка модель промовила цей рядок і на якому рівні мислення».

​

Цілі

• 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"

​

Дозволи

• bot:read: читання даних робочого простору, каналів, повідомлень, гілок, особистих повідомлень, даних реального часу та профілю.
• bot:write: bot:read плюс повідомлення каналів, відповіді в гілках, особисті повідомлення, завантаження та публікація меню команд.
• bot:admin: bot:write плюс створення каналів.
• commands:write: публікація меню команд бота. Входить до поточних наборів bot:write і bot:admin, а також може надаватися окремо.
• agent_activity:write: довготривалі рядки активності агента (agent_commentary / agent_tool). Не успадковується через bot:write або bot:admin; потрібне лише тоді, коли встановлено agentActivity: true.

​

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

• ClickClack is not configured for account "<id>": задайте baseUrl, token (наприклад, через CLICKCLACK_BOT_TOKEN) і workspace для цього облікового запису.
• ClickClack workspace not found: <value>: задайте для workspace ідентифікатор, слаг або назву робочого простору, повернуті ClickClack.
• Немає вхідних відповідей: переконайтеся, що токен має доступ до читання даних реального часу, і врахуйте, що бот ігнорує власні повідомлення та повідомлення від інших ботів.
• Не вдається надсилати повідомлення в канали: переконайтеся, що бот є учасником робочого простору та має bot:write.
• Немає меню команд: переконайтеся, що commandMenu не дорівнює false, сервер ClickClack підтримує PUT /api/bots/self/commands, а токен має commands:write.