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 token bot ClickClack được hỗ trợ chính thức.

Sử dụng cách 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ợ bot dịch vụ độc lập và bot thuộc sở hữu của người dùng; bot thuộc sở hữu của người dùng 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 token bot trên máy chủ ClickClack:

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

Đối với bot thuộc sở hữu của người dùng, hãy thêm --owner <user_id>.

Cấu hình OpenClaw:

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

Sau đó chạy:

export CLICKCLACK_BOT_TOKEN="ccb_..."openclaw gateway

Một tài khoản chỉ được coi là đã cấu hình khi baseUrl, token và workspace đều được đặt. workspace chấp nhận mã định danh không gian làm việc (wsp_...), slug hoặc tên; Gateway phân giải giá trị đó thành mã định danh khi khởi động.

Các khóa cấu hình tài khoản

Nếu plugins.allow là một danh sách hạn chế không rỗng, việc chọn rõ ràng ClickClack trong phần thiết lập kênh hoặc chạy openclaw plugins enable clickclack sẽ thêm clickclack vào danh sách đó. Quá trình cài đặt khi thiết lập ban đầu sử dụng cùng hành vi chọn rõ ràng này. Các đường này không ghi đè plugins.deny hoặc cài đặt plugins.enabled: false toàn cục. Việc chạy trực tiếp openclaw plugins install @openclaw/clickclack tuân theo chính sách cài đặt Plugin thông thường và cũng ghi ClickClack vào danh sách cho phép hiện có.

Nhiều bot

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

{  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",        },      },    },  },}

Chế độ phản hồi

• replyMode: "agent" (mặc định) điều phối tin nhắn đến qua quy trình agent thông thường, bao gồm ghi phiên và chính sách công cụ.
• replyMode: "model" bỏ qua quy trình agent và sử dụng llm.complete của môi trường chạy Plugin để tạo phản hồi bot trực tiếp, ngắn (có thể được định hình bằng model và systemPrompt).

Chế độ mô hình chạy các kết quả hoàn thành theo mã định danh agent của bot đã phân giải, việc này yêu cầu cờ tin cậy plugins.entries.clickclack.llm.allowAgentIdOverride: true được đặt rõ ràng:

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

Hãy giữ cờ tin cậy ở trạng thái tắt nếu bạn chỉ sử dụng chế độ phản hồi agent mặc định; chế độ đó không cần cờ này.

Sử dụng chế độ agent để thu thập bằng chứng tương quan giữa các dịch vụ. Đối với một mã định danh tin nhắn ClickClack có thẩm quyền ở dạng chuẩn msg_<ulid>, kênh sẽ suy ra mã định danh lượt chạy OpenClaw xác định clickclack:<message-id>. Mỗi lần gọi mô hình sau đó hiển thị trong dữ liệu chẩn đoán dưới dạng clickclack:<message-id>:model:<n>; khi lượt đó sử dụng ClawRouter, cùng mã định danh lần gọi mô hình được gửi dưới dạng X-Request-ID. Chế độ model bỏ qua dữ liệu chẩn đoán lượt chạy/phiên agent thông thường và do đó không phù hợp với đường thu thập bằng chứng này.

Khi một sự kiện thời gian thực chứa payload.correlation_id đã được xác thực, kênh chuyển giá trị đó dưới dạng X-Correlation-ID trong yêu cầu truy xuất tin nhắn có thẩm quyền và các yêu cầu phản hồi ClickClack phát sinh. Các giá trị sử dụng tập ký tự an toàn 128 ký tự của ClickClack (A-Z, a-z, 0-9, ., _, : và -); các giá trị không hợp lệ sẽ bị bỏ qua. Các phép nối này chỉ chứa mã định danh, tuyệt đối không chứa nội dung tin nhắn, lời nhắc, kết quả hoàn thành, thông tin xác thực hoặc đầu ra công cụ.

Các hàng hoạt động của agent

Theo mặc định, một kênh ClickClack không hiển thị gì trong khi lượt agent đang chạy; chỉ phản hồi cuối cùng được gửi đến. Đặt agentActivity: true trên một tài khoản để đăng các hàng tin nhắn agent_commentary và agent_tool bền vững trong khi lượt đang diễn ra:

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

Yêu cầu và hành vi:

• Tắt theo mặc định. Các thiết lập tiêu chuẩn và máy chủ ClickClack cũ không bị ảnh hưởng.
• Yêu cầu phạm vi token agent_activity:write. Phạm vi này tách biệt với bot:write và không được kế thừa từ phạm vi đó; hãy tạo token bot với --scopes bot:write,agent_activity:write (hoặc cấp phạm vi này cho token hiện có) trước khi bật tùy chọn.
• Suy giảm theo nỗ lực tối đa. Nếu token thiếu agent_activity:write hoặc máy chủ từ chối ghi hoạt động, lỗi sẽ được ghi nhật ký và phản hồi cuối cùng vẫn được gửi bình thường; không có hàng hoạt động nào xuất hiện.
• Các hàng được nhóm theo lượt (turn_id), được hợp nhất để mỗi bước logic tương ứng với một hàng, và các hàng công cụ sử dụng cùng định dạng tiến trình như Discord/Slack/Telegram (tên công cụ cùng chi tiết lệnh).
• Siêu dữ liệu quy thuộc. Các bài đăng do agent tạo (các hàng hoạt động và phản hồi cuối cùng) mang các trường author_model và author_thinking được phân giải từ mô hình thực tế dùng cho lượt đó (kể cả sau khi dự phòng). Các máy chủ không định nghĩa những cột này sẽ bỏ qua các trường JSON không xác định; các máy chủ lưu chúng có thể trả lời “mô hình nào đã nói dòng này, ở mức suy nghĩ nào” cho từng tin nhắn.

Đích

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

Đích gửi đi được chỉ định rõ ràng cũng có thể mang tiền tố nhà cung cấp clickclack: hoặc cc:.

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/tin nhắn trực tiếp/thời gian thực/hồ sơ.
• bot:write: bot:read cộng với tin nhắn kênh, phản hồi luồng, tin nhắn trực tiếp và tải lên.
• bot:admin: bot:write cộng với tạo kênh.
• agent_activity:write: các hàng hoạt động bền vững của agent (agent_commentary / agent_tool). Không được kế thừa từ bot:write hoặc bot:admin; chỉ bắt buộc khi đặt agentActivity: true.

OpenClaw chỉ cần bot:write cho trò chuyện agent thông thường. Thêm agent_activity:write khi bật các hàng hoạt động của agent.

Khắc phục sự cố

• ClickClack is not configured for account "<id>": đặt baseUrl, token (ví dụ thông qua CLICKCLACK_BOT_TOKEN) và workspace cho tài khoản đó.
• ClickClack workspace not found: <value>: đặt workspace thành mã định danh, slug hoặc tên 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 theo thời gian thực và lưu ý rằng bot bỏ qua tin nhắn của chính nó cũng như tin nhắn từ các bot khác.
• Gửi đến kênh thất bại: xác minh bot là thành viên của không gian làm việc và có bot:write.