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.