openclaw-add-channel

Configures Telegram, Slack, or WhatsApp channels for OpenClaw through a seven-step secret and deployment pipeline.

Updated Mar 22, 2026
One-click install
npx skills add https://github.com/diazMelgarejo/orama-system --skill openclaw-add-channel-diazmelgarejo
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: openclaw-add-channel
Source: https://github.com/diazMelgarejo/orama-system/tree/main/bin/orama-system/skills/openclaw-skills/skills/openclaw-add-channel
Command: npx skills add https://github.com/diazMelgarejo/orama-system --skill openclaw-add-channel-diazmelgarejo

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Adding a messaging channel to OpenClaw requires credentials to be propagated consistently across macOS Keychain, launchd startup scripts, shell environment files, and disaster recovery provisioning, and missing any one of these causes partial setups that fail silently or break on fresh machines. ## Core Features & Use Cases - Seven-Step Secret Pipeline: Stores tokens in macOS Keychain, then mirrors them into openclaw-secrets.sh, openclaw-env.sh, and provisioning secrets.sh so runtime, terminal, and recovery contexts all stay in sync. - Config and Agent Binding: Updates openclaw.json with jq to enable the channel and bind it to a target agent, then deploys with stow and restarts the gateway via launchctl. - Verification and Naming Enforcement: Checks gateway logs for channel connectivity and enforces strict naming conventions for Keychain services, environment variables, and channel IDs. - Use Case: When onboarding a new Slack workspace to an OpenClaw agent, run this pipeline to store both the bot token and socket-mode app token, bind the channel, restart the gateway, and confirm connectivity in one repeatable flow. ## Quick Start Ask the agent to add a Slack channel to OpenClaw for a given agent ID using your bot token and app token, then verify connectivity in the gateway logs.

Frequently Asked Questions about openclaw-add-channel

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

FAQPage Schema
How do I add a Telegram, Slack, or WhatsApp channel to OpenClaw?

Provide the channel type and target agent ID, then follow the seven-step pipeline: store tokens in macOS Keychain, update the secrets and environment scripts, edit openclaw.json with jq, deploy with stow, restart the gateway, and verify logs.

How to configure Slack socket mode tokens for OpenClaw?

Slack requires both a bot token and an app token for socket mode. Store each as a separate Keychain service (openclaw.slack-bot-token and openclaw.slack-app-token) and mirror both into the launchd and shell environment scripts.

Why does OpenClaw show MissingEnvVarError in the terminal but the gateway works?

This happens when openclaw-env.sh was not updated after adding the channel. The gateway reads from openclaw-secrets.sh, but terminal sessions need mirrored exports in openclaw-env.sh to resolve the same variables.

Does this channel setup survive a fresh machine restore?

Only if the provisioning secrets.sh script is updated with the new Keychain service entries. Without that step, disaster recovery on a fresh machine will not recreate the channel credentials.

What naming conventions do OpenClaw channel secrets require?

Keychain services must use lowercase-hyphen form like openclaw.telegram-bot-token, environment variables must be uppercase underscore like OPENCLAW_TELEGRAM_BOT_TOKEN, and channel IDs in JSON must be exactly telegram, slack, or whatsapp.