Get started

ClickClack

ClickClack은 일급 ClickClack 봇 토큰을 통해 OpenClaw를 셀프 호스팅 ClickClack 워크스페이스에 연결합니다.

OpenClaw 에이전트를 ClickClack 봇 사용자로 표시하려는 경우 사용하세요. ClickClack은 독립 서비스 봇과 사용자 소유 봇을 지원합니다. 사용자 소유 봇은 owner_user_id를 유지하며, 사용자가 부여한 토큰 범위만 받습니다.

빠른 설정

ClickClack에서 봇 토큰을 생성합니다.

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

사용자 소유 봇의 경우 --owner <user_id>를 추가합니다.

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

그런 다음 실행합니다.

export CLICKCLACK_BOT_TOKEN="ccb_..."
openclaw gateway

여러 봇

각 계정은 자체 ClickClack 실시간 연결을 열고 자체 봇 토큰을 사용합니다.

{
  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는 Plugin이 해당 봇 에이전트의 완성을 실행할 수 있도록 명시적인 plugins.entries.clickclack.llm.allowAgentIdOverride 신뢰 비트를 요구합니다. 기본 에이전트 경로만 사용하는 경우에는 꺼 둡니다.

대상

channel:<name-or-id>는 워크스페이스 채널로 보냅니다. 접두사가 없는 대상은 기본값으로 channel:을 사용합니다.
dm:<user_id>는 해당 사용자와의 직접 대화를 만들거나 재사용합니다.
thread:<message_id>는 기존 스레드에 답장합니다.

예:

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 또는 슬러그로 설정합니다.
수신 답장이 없음: 토큰에 실시간 읽기 액세스가 있고 봇이 자기 자신의 메시지에 답장하지 않는지 확인합니다.
채널 전송 실패: 봇이 워크스페이스의 멤버이고 bot:write가 있는지 확인합니다.

# 빠른 설정

# 여러 봇

# 대상

# 권한

# 문제 해결

빠른 설정

여러 봇

대상

권한

문제 해결