Get started

喀噠喀噠

ClickClack 透過第一級 ClickClack 機器人權杖，將 OpenClaw 連接到自行託管的 ClickClack 工作區。

當你想讓 OpenClaw 代理程式以 ClickClack 機器人使用者的身分出現時，請使用此功能。ClickClack 支援獨立服務機器人與使用者擁有的機器人；使用者擁有的機器人會保留 owner_user_id，且只會取得你授予的權杖範圍。

快速設定

在 ClickClack 中建立機器人權杖：

bash

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

若是使用者擁有的機器人，請加入 --owner <user_id>。

設定 OpenClaw：

json5

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

接著執行：

bash

export CLICKCLACK_BOT_TOKEN="ccb_..."openclaw gateway

多個機器人

每個帳號都會開啟自己的 ClickClack 即時連線，並使用自己的機器人權杖。

json5

{  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 可以為該機器人代理程式執行 completions。如果你只使用預設代理程式路由，請將其保持關閉。

目標

channel:<name-or-id> 會傳送到工作區頻道。未加前綴的目標預設為 channel:。
dm:<user_id> 會建立或重複使用與該使用者的直接對話。
thread:<message_id> 會在現有討論串中回覆。

範例：

bash

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 權杖範圍由 ClickClack API 強制執行。

bot:read：讀取工作區、頻道、訊息、討論串、DM、即時與個人檔案資料。
bot:write：包含 bot:read，再加上頻道訊息、討論串回覆、DM 與上傳。
bot:admin：包含 bot:write，再加上頻道建立。

OpenClaw 在一般代理程式聊天中只需要 bot:write。

疑難排解

ClickClack is not configured：設定 channels.clickclack.token 或 CLICKCLACK_BOT_TOKEN。
workspace not found：將 workspace 設為 ClickClack 傳回的工作區 ID 或 slug。
沒有收到傳入回覆：確認權杖具備即時讀取存取權，且機器人沒有回覆自己的訊息。
頻道傳送失敗：確認機器人是該工作區的成員，且具備 bot:write。

Was this useful?