ClickClack

​

クイックセットアップ

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

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

export CLICKCLACK_BOT_TOKEN="ccb_..."
openclaw gateway

​

アカウント設定キー

​

複数のボット

{
  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" はエージェントパイプラインをスキップし、Plugin ランタイムの llm.complete を使用して短い直接ボット返信を行います（任意で model と systemPrompt によって調整されます）。

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

​

エージェントアクティビティ行

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

• デフォルトではオフ。 標準設定と古い ClickClack サーバーには影響しません。
• agent_activity:write トークンスコープが必要です。 このスコープは bot:write とは別で、それに継承されません。このオプションを有効にする前に、--scopes bot:write,agent_activity:write でボットトークンを作成するか、既存トークンにスコープを付与してください。
• ベストエフォートの縮退。 トークンに agent_activity:write がない場合やサーバーがアクティビティ書き込みを拒否した場合、失敗はログに記録され、最終返信は通常どおり配信されます。アクティビティ行は表示されません。
• 行はターンごとにグループ化され（turn_id）、1 つの論理ステップが 1 行になるように統合されます。ツール行は Discord/Slack/Telegram と同じ進行状況フォーマット（ツール名とコマンド詳細）を使用します。
• 帰属メタデータ。 エージェントが作成した投稿（アクティビティ行と最終返信）には、そのターンで実際に使用されたモデル（フォールバック後を含む）から解決された author_model と author_thinking フィールドが含まれます。これらの列を定義していないサーバーは不明な JSON フィールドを無視します。それらを永続化するサーバーは、メッセージごとに「この行をどのモデルが、どの思考レベルで述べたか」に答えられます。

​

ターゲット

• 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"

​

権限

• bot:read: ワークスペース、チャンネル、メッセージ、スレッド、DM、リアルタイム、プロフィールデータを読み取ります。
• bot:write: bot:read に加えて、チャンネルメッセージ、スレッド返信、DM、アップロードを行います。
• bot:admin: bot:write に加えて、チャンネル作成を行います。
• agent_activity:write: 永続的なエージェントアクティビティ行（agent_commentary / agent_tool）。bot:write または bot:admin には継承されません。agentActivity: true が設定されている場合にのみ必要です。

​

トラブルシューティング

• ClickClack is not configured for account "<id>": そのアカウントに baseUrl、token（たとえば CLICKCLACK_BOT_TOKEN 経由）、workspace を設定してください。
• ClickClack workspace not found: <value>: workspace を ClickClack から返されたワークスペース ID、スラッグ、または名前に設定してください。
• 受信返信がない: トークンにリアルタイム読み取りアクセス権があることを確認し、ボットは自分自身のメッセージと他のボットからのメッセージを無視する点に注意してください。
• チャンネル送信が失敗する: ボットがワークスペースのメンバーであり、bot:write を持っていることを確認してください。