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. 新しいスコープを適用するため、ワークスペースにアプリを再インストールしてください。