slack-personal

What This Skill Does

The slack-personal skill provides a powerful, session-based interface for managing your Slack workspace directly through the slk CLI. By leveraging your existing Slack desktop app authentication, it eliminates the need for complex OAuth flows or manual API token management. The skill enables you to read channel histories, send messages, interact with threads, manage drafts, and search your workspace. It treats Slack as a first-class citizen of your terminal-based workflow, allowing the OpenClaw agent to act on your behalf to stay updated or respond to colleagues efficiently.

Installation

To integrate this skill into your OpenClaw agent, use the following command in your terminal: clawhub install openclaw/skills/skills/therohitdas/slk

Ensure that the Slack desktop application is installed and logged in on your macOS system, as the agent requires access to the Slack LevelDB and macOS Keychain to facilitate secure, token-less authentication. During the first execution, you will be prompted to grant the agent access to the "Slack Safe Storage" in your Keychain; select "Always Allow" for seamless background operations.

Use Cases

This skill is ideal for users who want to minimize context switching between a browser-based Slack client and their development environment. You can use it to perform "heartbeat" checks to see if you have urgent messages, search for historical documentation buried in old threads, draft complex responses without getting distracted by the full Slack UI, or perform quick status updates in project-specific channels. It is particularly effective for automated reporting, where the agent periodically reads from specific channels to summarize team activity or monitor for task completion.

Example Prompts

1. "Check slack and tell me if there are any urgent mentions in the project-alpha channel."
2. "Search slack for the latest deployment instructions shared by the devops team last week."
3. "Send a message to the general channel saying that I am currently heads-down on coding and will be slow to respond."

Tips & Limitations

The slk tool relies on local cache files stored at ~/.local/slk/token-cache.json. If you experience authentication errors, simply delete this file and run slk auth. Note that reading threads requires a valid timestamp; always use the --ts flag when fetching message lists to obtain the necessary identifiers for deep-diving into specific discussions. Because this skill mimics your user session, all actions performed are logged in Slack as if they came from your official desktop client.