快速开始

ClickClack

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 信任位，以便插件可以为该机器人智能体运行补全。如果你只使用默认智能体路由，请保持关闭。

目标

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：读取工作区/渠道/消息/线程/私信/实时/个人资料数据。
bot:write：bot:read 加上渠道消息、线程回复、私信和上传。
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?