add-mattermost

Configure a Mattermost bot channel for NanoClaw with server discovery and authenticated callbacks.

30.7k|12.8k|Updated Jan 31, 2026
One-click install
npx skills add https://github.com/nanocoai/nanoclaw --skill add-mattermost
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: add-mattermost
Source: https://github.com/nanocoai/nanoclaw/tree/main/.claude/skills/add-mattermost
Command: npx skills add https://github.com/nanocoai/nanoclaw --skill add-mattermost

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires ws, @types/ws, and includes scripts (resource) and assets (resource) components.

What problem does it solve?

Connecting NanoClaw to a Mattermost workspace requires many manual steps: finding or installing a server, setting SiteURL, creating a bot account, wiring WebSocket and callback credentials, and registering the channel adapter. This Skill automates that entire flow with idempotent, re-runnable steps.

Core Features & Use Cases

  • Server Discovery and Provisioning: Detects existing local or remote Mattermost servers via health probes and Docker inspection, or installs a local evaluation server with Docker Compose after explicit approval.
  • Channel Adapter Installation: Copies the vendored Mattermost adapter from the channels branch, registers it in the channel barrel, and installs pinned WebSocket dependencies.
  • Bot Authentication and Callbacks: Validates bot tokens against the Mattermost API, configures authenticated HTTP callbacks for interactive approval cards, and resolves the owner's DM channel.
  • Use Case: A self-hosting user wants their NanoClaw agent reachable from their team's Mattermost. The Skill discovers their existing server, configures SiteURL, registers the bot, and restarts NanoClaw with the channel live.

Quick Start

Ask the assistant to add a Mattermost channel to NanoClaw and follow the prompts to select or create a server and provide your bot token.

Frequently Asked Questions about add-mattermost

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I connect NanoClaw to a Mattermost server?

Run the add-mattermost skill, which discovers existing servers via the /api/v4/system/ping health endpoint, lets you select or enter a URL, then installs the channel adapter, validates your bot token, and restarts NanoClaw with the channel registered.

How do I create a Mattermost bot account for a chat integration?

Enable Bot Account Creation in System Console under Integrations, then add a bot from the workspace Product menu and copy its access token. The bot must be manually added to each team and channel since Mattermost does not do this automatically.

Can I run a local Mattermost server with Docker for testing?

Yes, the skill bundles a Docker Compose template that runs Mattermost Team Edition with PostgreSQL on 127.0.0.1:8065. It creates named volumes and a network after your explicit approval, and is intended for evaluation rather than production.

Why do Mattermost Desktop messages only appear after a manual refresh?

The server is rejecting the WebSocket Origin. Use the same hostname in the Desktop server URL, MATTERMOST_BASE_URL, and ServiceSettings.SiteURL, keep WebsocketURL blank, and verify values through /api/v4/config/client?format=old.

Why do Mattermost approval card clicks do nothing?

The Mattermost server cannot reach the NanoClaw callback URL. POST to the callback from the server; a 401 proves reachability, while a timeout indicates routing or firewall failure. Add private hosts under Allow untrusted internal connections.