---

name: slack-notify description: Slack APIでチャネルにメッセージを送信する。「Slackに通知」「Slack通知を追加」「Slackに送って」「チャネルに投稿」などの作業に使う。プロジェクト横断で利用可能。

Slack Notify スキル

Slack Web API (chat.postMessage) を使ってチャネルにメッセージを送信するスキル。プロジェクト横断で利用可能。

できること

• テキストメッセージ送信
• リッチメッセージ送信（Block Kit）
• 複数チャネルへの通知
• イベント通知の組み込み（API Route / サーバーサイド処理への統合）

セットアップ

環境変数

# プロジェクトの .env.local に追加
SLACK_BOT_TOKEN=xoxb-xxxx-xxxx-xxxx
SLACK_NOTIFICATION_CHANNEL=C0XXXXXXXXX

Vercel 等のホスティングサービスにも同じ値を設定すること。

Bot Token の取得元

• openclaw 設定ファイル: /Users/satokeita/.openclaw/openclaw.json → channels.slack.botToken
• Slack App 管理画面: https://api.slack.com/apps → 対象 App → OAuth & Permissions → Bot User OAuth Token

Bot に必要な権限（OAuth Scopes）

Scope	用途
chat:write	メッセージ送信
chat:write.public	Bot が参加していないパブリックチャネルへの送信（任意）

チャネル ID の確認方法

Slack デスクトップ/Web でチャネルを右クリック → 「チャネル詳細を表示」→ 最下部の「チャネル ID」をコピー。

実装パターン

用途に応じてパターンを選択し、lib/ 等に配置する。

パターン	ファイル	用途
1. シンプル通知	scripts/notify-simple.ts	fire-and-forget 型、最小構成
2. チャネル指定付き	scripts/notify-channel.ts	複数チャネルへの送り分け
3. Block Kit リッチ	scripts/notify-rich.ts	構造化された通知（Block Kit）
4. curl（CI用）	scripts/notify.sh	シェルスクリプト / CI パイプライン
5. Python	scripts/notify.py	Python プロジェクト用

設計ポイント（全パターン共通）:

• fetch のみ使用（追加ライブラリ不要、Python版は requests）
• 環境変数が未設定の場合は何もしない（開発環境で安全）
• catch(() => {}) で呼び出し元のエラーハンドリングを不要に

導入チェックリスト

プロジェクトに Slack 通知を追加する際の手順:

1. 環境変数を追加: .env.local に SLACK_BOT_TOKEN と SLACK_NOTIFICATION_CHANNEL
2. 通知関数を実装: 上記パターンから選択し、lib/ 等に配置
3. 呼び出しを追加: イベント発生箇所で fire-and-forget で呼び出し
4. ホスティング環境変数を設定: Vercel / AWS 等に同じ値を追加
5. 動作確認: テストイベントで通知が届くことを確認

リファレンス

• 既知のチャネル ID: references/known-channels.md
• API リファレンス（chat.postMessage）: references/api-chat-postmessage.md
• Block Kit Builder（ビジュアルエディタ）

よくある落とし穴

• not_in_channel エラー: Botがチャネルに参加していない状態で送信すると発生する。chat:write.public スコープを追加するか、Botをチャネルに /invite @BotName で招待する
• 環境変数の未設定でサイレント失敗: 通知関数は token や channel が未設定の場合 return するだけなので、通知が届かなくても気づきにくい。本番環境で通知が来ない場合はまずVercel等のホスティング側の環境変数設定を確認する
• Block Kit使用時の text フィールド省略: blocks を指定しても text フィールドは必須（通知のフォールバック表示に使われる）。省略するとプッシュ通知に内容が表示されない
• チャネルID とチャネル名の混同: chat.postMessage の channel パラメータにはチャネル名（#general）ではなくチャネルID（C0XXXXXXXXX）を使うこと。チャネル名でも動作する場合があるが、リネーム時に壊れる