OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Get started

ClickClack

ClickClack 會透過第一級 ClickClack bot token，將 OpenClaw 連接到自託管的 ClickClack 工作區。

當你希望 OpenClaw 代理顯示為 ClickClack bot 使用者時，請使用此功能。ClickClack 支援獨立服務 bot 和使用者擁有的 bot；使用者擁有的 bot 會保留 owner_user_id，且只會取得你授予的 token 範圍。

快速設定

在 ClickClack 伺服器上建立 bot token：

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

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

設定 OpenClaw：

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

然後執行：

bash
export CLICKCLACK_BOT_TOKEN="ccb_..."openclaw gateway

只有在 baseUrl、token 和 workspace 都已設定時，帳戶才會視為已設定。workspace 接受工作區 id（wsp_...）、slug 或名稱；閘道會在啟動時將其解析為 id。

帳戶設定鍵

鍵 預設值 備註
baseUrl 無（必要） ClickClack 伺服器 URL。
token 無（必要） 純字串或祕密參照（source: "env" | "file" | "exec"）。
workspace 無（必要） 工作區 id、slug 或名稱。
replyMode "agent" "agent" 會執行完整代理管線；"model" 會傳送簡短的直接模型補全。
defaultTo "channel:general" 當外送路徑未提供目標時使用的目標。
allowFrom ["*"] 傳入 DM 和頻道訊息的使用者 id 允許清單。
botUserId 自動偵測 啟動時從 bot token 身分解析。
agentId 路由預設值 將此帳戶的傳入訊息固定到一個代理。
toolsAllow 無 此帳戶代理回覆的工具允許清單。
model, systemPrompt 無 由 replyMode: "model" 補全使用。
reconnectMs 1500 即時重新連線延遲（100 到 60000）。

如果 plugins.allow 是非空的限制性清單，在頻道設定中明確選取 ClickClack，或執行 openclaw plugins enable clickclack， 會將 clickclack 附加到該清單。入門安裝會使用相同的 明確選取行為。這些路徑不會覆寫 plugins.deny 或 全域 plugins.enabled: false 設定。直接執行 openclaw plugins install @openclaw/clickclack 會遵循一般的 外掛安裝政策，並且也會將 ClickClack 記錄到現有的允許清單中。

多個 bot

每個帳戶會開啟自己的 ClickClack 即時連線，並使用自己的 bot token。

json5
{  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" 會略過代理管線，並使用外掛 runtime 的 llm.complete 進行簡短的直接 bot 回覆（可選擇由 model 和 systemPrompt 調整）。

模型模式會針對已解析的 bot 代理 id 執行補全，這需要 明確的 plugins.entries.clickclack.llm.allowAgentIdOverride: true 信任 位元：

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

如果你只使用預設的 agent 回覆模式，請保持信任位元關閉；那裡 不需要它。

代理活動列

預設情況下，ClickClack 頻道在代理回合執行期間不會顯示任何內容；只會送出最終回覆。在帳戶上設定 agentActivity: true，可在回合進行中發布持久的 agent_commentary 和 agent_tool 訊息列：

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

需求和行為：

  • 預設關閉。 標準設定和舊版 ClickClack 伺服器不受影響。
  • 需要 agent_activity:write token 範圍。 此範圍與 bot:write 分開，且不會由它繼承；啟用此選項前，請用 --scopes bot:write,agent_activity:write 建立 bot token（或將該範圍授予現有 token）。
  • 盡力降級。 如果 token 缺少 agent_activity:write，或伺服器拒絕活動寫入，失敗會被記錄，且最終回覆仍會正常傳送；不會顯示活動列。
  • 列會依回合分組（turn_id）、合併為一個邏輯步驟一列，且工具列使用與 Discord/Slack/Telegram 相同的進度格式（工具名稱加上命令詳細資料）。
  • 歸屬中繼資料。 代理撰寫的貼文（活動列和最終回覆）會帶有 author_model 和 author_thinking 欄位，這些欄位會從該回合實際使用的模型解析（包括 fallback 之後）。未定義這些欄位的伺服器會忽略未知的 JSON 欄位；持久化它們的伺服器可以針對每則訊息回答「這一行是哪個模型在什麼思考層級說的」。

目標

  • channel:<name-or-id> 會傳送到工作區頻道。裸目標預設為 channel:。
  • dm:<user_id> 會建立或重用與該使用者的直接對話。
  • thread:<message_id> 會在以該訊息為根的討論串中回覆。

明確的外送目標也可以帶有 clickclack: 或 cc: provider 前綴。

範例：

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

  • bot:read：讀取工作區/頻道/訊息/討論串/DM/即時/profile 資料。
  • bot:write：bot:read 加上頻道訊息、討論串回覆、DM 和上傳。
  • bot:admin：bot:write 加上頻道建立。
  • agent_activity:write：持久代理活動列（agent_commentary / agent_tool）。不會由 bot:write 或 bot:admin 繼承；只有在設定 agentActivity: true 時才需要。

OpenClaw 一般代理聊天只需要 bot:write。啟用代理活動列時，請加入 agent_activity:write。

疑難排解

  • ClickClack is not configured for account "<id>"：為該帳戶設定 baseUrl、token（例如透過 CLICKCLACK_BOT_TOKEN）和 workspace。
  • ClickClack workspace not found: <value>：將 workspace 設為 ClickClack 傳回的工作區 id、slug 或名稱。
  • 沒有傳入回覆：確認 token 具有即時讀取存取權，並注意 bot 會忽略自己的訊息和其他 bot 的訊息。
  • 頻道傳送失敗：確認 bot 是工作區成員，且具有 bot:write。
Was this useful?
On this page

On this page