ClickClack

ClickClack kết nối OpenClaw với một không gian làm việc ClickClack tự lưu trữ thông qua các token bot ClickClack được hỗ trợ như thành phần hạng nhất.

Dùng tùy chọn này khi bạn muốn một agent OpenClaw xuất hiện dưới dạng người dùng bot ClickClack. ClickClack hỗ trợ các bot dịch vụ độc lập và bot do người dùng sở hữu; bot do người dùng sở hữu giữ một owner_user_id và chỉ nhận các phạm vi token mà bạn cấp.

# Thiết lập nhanh

Tạo một token bot trong ClickClack:

clickclack admin bot create \
  --workspace <workspace_id_or_slug> \
  --name "OpenClaw" \
  --handle openclaw \
  --scopes bot:write \
  --plain

Đối với bot do người dùng sở hữu, thêm --owner <user_id>.

Cấu hình 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",
    },
  },
}

Sau đó chạy:

export CLICKCLACK_BOT_TOKEN="ccb_..."
openclaw gateway

# Nhiều bot

Mỗi tài khoản mở kết nối thời gian thực ClickClack riêng và dùng token bot riêng.

{
  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" dùng trực tiếp api.runtime.llm.complete cho các phản hồi bot ngắn. Khi một tài khoản đặt agentId, OpenClaw yêu cầu bit tin cậy rõ ràng plugins.entries.clickclack.llm.allowAgentIdOverride để plugin có thể chạy hoàn tất cho agent bot đó. Hãy tắt tùy chọn này nếu bạn chỉ dùng tuyến agent mặc định.

# Đích

• channel:<name-or-id> gửi đến một kênh trong không gian làm việc. Các đích trần mặc định thành channel:.
• dm:<user_id> tạo hoặc tái sử dụng một cuộc trò chuyện trực tiếp với người dùng đó.
• thread:<message_id> trả lời trong một luồng hiện có.

Ví dụ:

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"

# Quyền

Các phạm vi token ClickClack được API ClickClack thực thi.

• bot:read: đọc dữ liệu không gian làm việc/kênh/tin nhắn/luồng/DM/thời gian thực/hồ sơ.
• bot:write: bot:read cộng với tin nhắn kênh, trả lời luồng, DM và tải lên.
• bot:admin: bot:write cộng với tạo kênh.

OpenClaw chỉ cần bot:write cho trò chuyện agent thông thường.

# Khắc phục sự cố

• ClickClack is not configured: đặt channels.clickclack.token hoặc CLICKCLACK_BOT_TOKEN.
• workspace not found: đặt workspace thành id hoặc slug của không gian làm việc do ClickClack trả về.
• Không có phản hồi đến: xác nhận token có quyền đọc thời gian thực và bot không trả lời tin nhắn của chính nó.
• Gửi đến kênh không thành công: xác minh bot là thành viên của không gian làm việc và có bot:write.