---

name: slack-multi-files description: "Fetch all file attachments from a Slack message when Clawdbot only delivers the first one. Use automatically when a received Slack message has image/file attachments — Clawdbot currently only delivers the first file, so run this to check for and retrieve any additional files. Also use when the user mentions missing attachments or says 'I attached multiple files/images'."

Slack Multi-File Fetcher

Clawdbot's Slack integration only delivers the first file attachment per message (see issue #4282). This skill retrieves all attachments.

When to Run

Automatically when you receive a Slack message that includes an image or file attachment. The check is lightweight — if there's only 1 file, it returns quickly.

How to Use

Option 1: Script (preferred for automation)

~/.openclaw/skills/slack-multi-files/scripts/fetch-slack-files.sh <channel_id> <message_ts>

Returns JSON array of all downloaded files with paths. Use image tool to analyze each.

Option 2: Manual curl

curl -s -H "Authorization: Bearer $SLACK_BOT_TOKEN" \
  "https://slack.com/api/conversations.replies?channel=CHANNEL&ts=TS&limit=1&inclusive=true" \
  | jq '.messages[0].files[] | {name, url_private, mimetype}'

Then download each url_private with the same auth header.

Parameters

• channel_id: Slack channel ID (e.g. C08KHA4BQHW)
• message_ts: Message timestamp (e.g. 1769734297.476489)
• Bot token is auto-extracted from ~/.openclaw/openclaw.json

After Fetching

• Use the image tool to analyze image files
• Report all attachments to the user, not just the first one

⚠️ よくある落とし穴

• Bot Tokenの読み込み失敗: ~/.openclaw/openclaw.json のパスやキー名が変わるとトークン取得に失敗する。スクリプトがエラーを返したら、まずJSONファイルの channels.slack.botToken の存在を確認する
• message_ts の形式間違い: Slack のタイムスタンプは 1769734297.476489 のようにドット区切り。URLエンコードや文字列切り詰めで壊れやすいので、元の値をそのまま渡すこと
• ファイルが1つしかないのに毎回実行: チェック自体は軽量だが、添付ファイルのないメッセージに対して実行するとAPIエラーになる場合がある。受信メッセージにファイル添付がある場合のみ実行すること