Summary

Enable reliable Slack attachment vision in OpenClaw by tightening the existing Slack media pipeline rather than building a new ingestion stack.

Context

Current code already has:

• Slack Socket Mode integration
• Slack file download/auth handling
• thread starter media fallback
• finalized inbound media fields (MediaPath, MediaPaths, MediaType, MediaTypes)
• the shared src/media-understanding/* pipeline

The remaining work is to verify and stabilize the handoff so Slack image/file attachments consistently reach media-understanding, especially for thread-root inheritance and multi-attachment cases.

Scope

• audit current Slack media-to-model handoff
• stabilize image/file thread-root inheritance
• validate multi-image handling
• expand regression coverage
• live-verify in Slack
• document final behavior and known limits

References

• PRD: openclaw-dev-private/docs/FeaturePlanning/slack-attachment-vision-prd.md
• Delta plan: openclaw-dev-private/docs/FeaturePlanning/slack-attachment-vision-delta-plan.md
• Checklist: openclaw-dev-private/docs/FeaturePlanning/slack-attachment-vision-checklist.md