← Back to Skills Marketplace
7624
Downloads
7
Stars
0
Active Installs
18
Versions
Install in OpenClaw
/install slack-api
Description
Slack API integration with managed OAuth. Send messages, manage channels, search conversations, and interact with Slack workspaces. Use this skill when users want to post messages, list channels, get user info, or automate Slack workflows.
Usage Guidance
Before installing, be aware this skill can access and modify Slack data according to the scopes you authorize through Maton. Prefer OAuth, choose the narrowest Slack scopes available, confirm the exact workspace and connection before writes, and review any message, channel, file, or membership changes before allowing the agent to run them.
Capability Assessment
Credentials
Network access, Slack workspace access, and optional raw HTTP calls to api.maton.ai are proportionate for a Slack API skill, and the raw API-key fallback is disclosed as a limited alternative when the CLI cannot be installed.
Install Mechanism
Installation relies on the external Maton CLI via npm or Homebrew, with optional SDK installs; the artifact itself is Markdown only and contains no bundled executable scripts.
Instruction Scope
Runtime instructions repeatedly require read/list calls first, explicit user approval for connection creation and all POST/PUT/PATCH/DELETE operations, target confirmation, least privilege, and treating Slack content as untrusted data.
Persistence & Privilege
OAuth profiles, access/refresh tokens, and Slack connections persist through the OS credential store and Maton account, but this is disclosed with guidance not to inspect or expose credentials and to revoke unused connections.
Purpose & Capability
The skill's Slack capabilities, including reading conversations, sending messages, managing channels, files, reactions, pins, bookmarks, and using a raw Slack API passthrough, match its stated purpose and are clearly described.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install slack-api - After installation, invoke the skill by name or use
/slack-api - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.2.4
- Removed the skill-card.md file.
- No changes to functionality or documentation in SKILL.md.
v1.2.3
Fix the raw HTTP fallback example: restore the gateway base URL in the GATEWAY constant (and the fastmail streaming call), which a previous edit had replaced with a placeholder
v1.2.2
Resolve remaining audit findings: state one consistent endpoint policy instead of conflicting scope claims, qualify the local-execution and high-impact wording, note that locale examples are illustrative, and correct app-specific auth, method and upload-path documentation
v1.2.1
Address security-audit findings: disclose the api passthrough in the access-scope and description text, warn on irreversible connection deletion, add response data-minimization guidance, and correct app-specific auth and request-body notes
v1.2.0
CLI-first rewrite with the Maton SDK examples; clarify that the CLI and SDKs keep separate credential stores, and reword webhook egress warnings
v1.1.0
CLI-first rewrite: the maton CLI with OAuth login is the documented path, every example is a maton command, SDK examples added, and the raw HTTP fallback feeds the key on stdin instead of reading it from the environment
v1.0.11
- Removed the file: skill-card.md
- No user-facing features or interface changes introduced in this version.
v1.0.10
- Added CLI usage examples for all supported features, including message and connection management.
- Included instructions for installing the Maton CLI via NPM and Homebrew.
- Expanded Quick Start and Authentication sections with both CLI and Python examples.
- Provided CLI and Python examples side-by-side for connection management tasks.
- API Reference now includes parallel CLI commands for common operations.
- Improved overall organization for easier navigation and usage.
v1.0.9
- Updated all endpoint URLs from gateway.maton.ai and ctrl.maton.ai to api.maton.ai for a unified API entrypoint.
- Security & Permissions section added, emphasizing user confirmation for all write operations.
- Connection management documentation updated to reflect new endpoints.
- LICENSE.txt was removed from the repository.
v1.0.8
- Expanded and reorganized the API Reference section to include additional Slack endpoints (such as scheduling messages, channel management, setting topics/purposes, etc.).
- Improved documentation structure by grouping related endpoints and providing clearer headings for each category.
- Added new examples and options for conversations, including create, join, leave, archive, unarchive, rename, set topic, and set purpose endpoints.
- Updated metadata: added homepage field and adjusted emoji value formatting.
v1.0.7
- Added new metadata section under `clawdbot`, specifying requirements and an emoji.
- No functional changes to API or usage—documentation metadata update only.
v1.0.6
- No file changes detected in this version.
- No user-facing changes; documentation and functionality remain the same as previous version.
v1.0.5
Version 1.0.5 of the slack-api skill
- No file changes were detected in this version.
- Functionality and documentation remain the same as the previous release.
v1.0.4
- All shell-based usage and management examples have been replaced with embedded Python one-liners using the standard library for HTTP requests.
- Updated Quick Start and Connection Management sections to feature Python automation instead of curl commands.
- No changes to the API endpoints or general documentation content.
- JavaScript and Python code samples remain available for advanced scripting.
v1.0.3
- Added guidance to use the api-gateway skill for third party apps (see skill description).
- Updated curl examples to use $MATON_API_KEY for authentication.
- Added notes about using curl -g for URLs with brackets to prevent shell globbing.
- Included important notice regarding environment variable expansion issues when piping curl output to other commands (e.g., jq).
- No functional changes to endpoints or API features.
v1.0.2
- Updated API gateway base URL to accept methods at /slack/{method} instead of /slack/api/{method}
- Expanded example response for connection details, adding creation_time, last_updated_time, and metadata fields
- Clarified connection selection instructions and HTTP header usage
- Improved API key retrieval instructions
- Minor clarifications and formatting improvements in documentation
v1.0.1
- Added documentation for the "Get Connection" endpoint in the connection management section.
- Included an example response for retrieving a specific Slack connection.
- No other functional or documentation changes detected.
v1.0.0
Initial release of Slack API integration via Maton gateway.
- Managed Slack OAuth: Connect multiple Slack workspaces with API key authentication.
- Post, edit, delete messages, and manage threads.
- List channels, users, and channel members; retrieve channel info.
- Search conversations and post file uploads.
- Support for reactions, DM conversations, and Slack markdown formatting.
- Centralized API endpoint documentation and working code examples (curl, JS, Python).
- Error handling and connection management with detailed guidance.
Metadata
Frequently Asked Questions
What is Slack?
Slack API integration with managed OAuth. Send messages, manage channels, search conversations, and interact with Slack workspaces. Use this skill when users want to post messages, list channels, get user info, or automate Slack workflows. It is an AI Agent Skill for Claude Code / OpenClaw, with 7624 downloads so far.
How do I install Slack?
Run "/install slack-api" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Slack free?
Yes, Slack is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Slack support?
Slack is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Slack?
It is built and maintained by byungkyu (@byungkyu); the current version is v1.2.4.
More Skills