OpenClaw Slack スキルガイド

OpenClaw Slack スキル概要

Slackスキル はOpenClawをSlackワークスペースに接続し、AIエージェントが自然言語でメッセージの送信、リアクション管理、ピン留め、会話の閲覧を行えるようにします。ターミナルとSlackを行き来する必要なく、OpenClawに頼むだけで数秒で日常的なメッセージ操作を完了できます。

Slackは最も広く使われているチームコミュニケーションプラットフォームの一つであり、OpenClawとの統合により強力な自動化ワークフローが実現します。デプロイ通知の投稿、メッセージへのリアクション、重要な決定のピン留めなど、OpenClaw Slackスキルは複数ステップのSlack操作をシンプルな会話に変換します。

典型的なワークフロー：

1. OpenClawに #releases チャンネルへのデプロイ更新投稿を依頼する。
2. エージェントが設定済みのBot Tokenを使ってSlack APIを呼び出す。
3. メッセージが即座に投稿される——コンテキスト切り替え不要。

このスキルは2つの接続モードをサポートしています： Socket Mode （開発や小規模チームにおすすめ）と HTTP Events API （ファイアウォール内の本番環境に最適）。両モードとも同じBot Tokenを使用し、同一の機能を提供します。

Slack スキルの前提条件

Slackスキルをインストールする前に、以下を確認してください：

• OpenClaw がインストールされ実行中（v1.0+）
• アプリをインストールする権限がある Slackワークスペース
• api.slack.com/apps で必要なOAuthスコープを設定した Slackアプリ を作成済み
• スキル管理用の clawhub CLI をインストール済み—— clawhubでインストール

必要なOAuthスコープ（Bot Token）

Slackアプリ作成時に、以下のBot Tokenスコープを追加してください：

| スコープ | 用途 | |---------|------| | chat:write | メッセージの送信と編集 | | channels:history | チャンネルメッセージ履歴の読み取り | | channels:read | チャンネル情報の一覧と表示 | | im:history | ダイレクトメッセージ履歴の読み取り | | im:write | ダイレクトメッセージの送信 | | reactions:read | メッセージのリアクション一覧 | | reactions:write | 絵文字リアクションの追加 | | pins:read | ピン留めアイテムの一覧 | | pins:write | メッセージのピン留めと解除 | | emoji:read | カスタム絵文字リストへのアクセス | | app_mentions:read | @メンションへの応答 |

オプション：メッセージごとにボットの表示名をカスタマイズするには chat:write.customize を、ファイル操作には files:read と files:write を追加してください。

セットアップを確認：

# OpenClawバージョンを確認
openclaw --version

# clawhubがインストールされているか確認
clawhub --version

Slack スキルのインストール方法

1つのコマンドでSlackスキルをインストール：

npx clawhub@latest install slack

インストールを確認：

clawhub list

インストール済みスキルのリストに slack が表示されるはずです。このスキルは ClawHubのsteipete により公開され、定期的に更新されています。

Slack スキルの設定

Slackスキルには Bot Token と、Socket Modeの場合は App Token が必要です。OpenClawは環境変数からこれらのトークンを自動的に読み取ります。

環境設定

# 必須：Bot Token（xoxb-で始まる）
export SLACK_BOT_TOKEN=xoxb-your-bot-token-here

# Socket Modeで必須（xapp-で始まる）
export SLACK_APP_TOKEN=xapp-your-app-token-here

重要： トークンを設定ファイルにハードコードしないでください。環境変数または 1Password やBitwardenなどのシークレットマネージャーを使用してください。

接続モード

Socket Mode（デフォルト）：

• SLACK_BOT_TOKEN と SLACK_APP_TOKEN が必要
• パブリックURLが不要——ローカル開発に最適
• openclaw gateway で起動

HTTP Events API：

• SLACK_BOT_TOKEN とSigning Secretが必要
• Webhookエンドポイントを設定（デフォルト： /slack/events ）
• リバースプロキシ配下の本番環境に最適

アクセス制御

OpenClawはSlackインタラクションの詳細なアクセス制御を提供します：

• DMポリシー： pairing （デフォルト）、 allowlist 、 open 、 disabled
• チャンネルポリシー： open 、 allowlist 、 disabled
• メンション必須： チャンネルではデフォルトで @bot メンションが必要

チーム環境では pairing DMポリシーの使用をおすすめします。ユーザーは openclaw pairing approve slack <code> を実行してからボットがDMに応答するようになります。 安全チェックリスト で追加のセキュリティ強化のヒントを確認してください。

Slack スキルの使用例

1. デプロイ通知の投稿

あなた： 「#releasesチャンネルに、バージョン2.4.0がダウンタイムなしで本番環境にデプロイされたことを投稿して。」

エージェントがターゲットチャンネルとメッセージ内容を指定して sendMessage を呼び出します。通知はボットのIDで即座にチャンネルに表示されます。

2. チームの決定にリアクション

あなた： 「#engineering-decisionsの最新メッセージにチェックマークのリアクションを追加して。」

エージェントは readMessages で指定チャンネルの最新メッセージを読み取り、 react で✅リアクションを追加します。決定の承認やタスクのレビュー済みマークに最適です。

3. 重要な更新をピン留め

あなた： 「#productチャンネルのQ1ロードマップについてのメッセージをピン留めして。」

エージェントは最近のメッセージから「Q1ロードマップ」に一致する内容を検索し、 pinMessage でピン留めします。ピン留めされたメッセージはチャンネルの上部に保持され、チーム全体がアクセスしやすくなります。

4. チャンネルアクティビティの閲覧と要約

あなた： 「今日の#supportチャンネルで何があったか要約して。」

エージェントは readMessages でその日のメッセージを取得し、主要なトピック、質問、解決策を分析・要約します。長い会話には Summarize スキルとの併用がおすすめです。

セキュリティとベストプラクティス

Slackスキルはワークスペース内で メッセージの送信とコンテンツの変更 が可能です。安全のために以下のガイドラインに従ってください：

• 最小権限の原則。 実際に必要なOAuthスコープのみを付与してください。チャンネルの読み取りだけなら chat:write と pins:write は不要です。
• ペアリングモードを有効に。 デフォルトの pairing DMポリシーは、未承認ユーザーがDMでボットとやり取りすることを防ぎます。
• 送信前に確認。 OpenClawはデフォルトでメッセージ送信前に確認を求めます。本番ワークスペースではこの機能を無効にしないでください。
• チャンネルアクセスを制限。 allowlist チャンネルポリシーを使用して、ボットを特定のチャンネルに制限し、ワークスペース全体へのアクセスを避けてください。
• トークンを定期的にローテーション。 Bot Tokenを定期的に再生成し、使わなくなったトークンは Slackアプリ管理 ページで取り消してください。
• メッセージアクティビティを監査。 Slackワークスペースの監査ログを確認し、ボットが送信したメッセージをレビューしてください。

Slack スキルのよくあるエラーとトラブルシューティング

「not_authed」または「invalid_auth」

Bot Tokenが見つからないか無効です。

# トークンが設定されているか確認
echo $SLACK_BOT_TOKEN

# 必要に応じて再エクスポート
export SLACK_BOT_TOKEN=xoxb-your-new-token

トークンが最近再生成された場合は、使用しているすべての環境で更新されていることを確認してください。

「channel_not_found」

ボットが指定されたチャンネルにアクセスできません。通常、これは以下を意味します：

1. ボットがチャンネルに招待されていない——チャンネルで /invite @your-bot-name と入力してください。
2. チャンネルIDが正しくない——Slack APIまたはチャンネルのコンテキストメニューで正しいIDを取得してください。
3. チャンネルがプライベートで、ボットに groups:read スコープがない。

「missing_scope」

Bot Tokenに必要なOAuthスコープが不足しています。

1. api.slack.com/apps → アプリ → OAuth & Permissions に移動してください。
2. エラーメッセージに表示されている不足スコープを追加してください。
3. 新しいスコープを適用するため、ワークスペースにアプリを再インストールしてください。