OpenClaw と Slack 連携の前提条件・設定ガイド

前提条件の整理

ポイント
- 「最低要件」はインストールが成功すれば動作しますが、バグやセキュリティパッチの観点から 推奨環境 の利用を強く勧めます。
- 本ガイドでは「推奨環境」を前提に説明していますが、最低要件でも手順は同一です。

OS・Docker・Python のインストール手順

1. OS バージョンの確認

参考: Ubuntu 20.04 以降は systemd が標準搭載されているため、後述の systemd ユニットがそのまま利用できます。

2. Docker Engine のインストール（公式リポジトリ使用）

注意: apt-get install docker.io は Ubuntu の「universe」パッケージであり、バージョンが古いことがあります。必ず Docker 社の公式リポジトリ から取得してください。

macOS は公式サイトから Docker Desktop for Mac をダウンロードし、インストールウィザードに従ってください。
Docker Desktop ダウンロードページ

3. Python のインストール（pyenv 推奨）

Tip: pyenv はプロジェクトごとに異なる Python バージョンを管理できるので、将来的に別バージョンが必要になっても安全です。

Slack アプリの作成と権限設定

1. アプリケーションの新規作成

1. ブラウザで Slack API - Your Apps にアクセス
2. 「Create New App」 → 「From scratch」を選択
3. 名前を OpenClaw Bot、所属ワークスペースを指定し「Create App」

2. 必要なスコープ（Bot Token Scopes）

最小構成 は上記 3 スコープだけです。不要な権限は付与しないことで、情報漏洩リスクを低減できます。

3. Socket Mode の有効化

1. 左メニューの 「Socket Mode」 → 「Enable Socket Mode」をオン
2. 自動生成された App Level Token (connections:write) をコピーし、安全に保管

Socket Mode により、外部からポートを開放せずに Slack との双方向通信が可能です。公式ドキュメントは以下をご参照ください：
Slack Socket Mode Overview – https://api.slack.com/apis/socket-mode

4. OAuth トークン取得

• OAuth & Permissions ページで「Install App to Workspace」をクリックし、許可を承認すると Bot User OAuth Token (xoxb‑…) が発行されます。

重要: 発行されたトークンは機密情報です。後述のシークレットストアへ格納してください。

OpenClaw 設定ファイルとシークレット管理

1. 基本設定ファイル例

claw.yaml（アプリ側で読み込む YAML）

.env（Docker 用環境変数ファイル）

注意: .env は 必ず Git の管理対象外 にしてください。
bash
echo ".env" >> .gitignore

2. シークレットストアへの移行手順（Vault を例に）

1. Vault サーバーのセットアップ（省略） → VAULT_ADDR と VAULT_TOKEN が環境変数で取得できる状態にする。
2. シークレットを書き込む

bash
vault kv put secret/openclaw \
slack_bot_token="xoxb-xxxxxxxxxxxx-xxxxxxxxxxxxx" \
slack_app_token="xapp-1-XXXXXXXXXXXXXXXXXXXX" \
openai_api_key="sk-XXXXXXXXXXXXXXXXXXXXXXXXXXXXX"

1. Docker Compose 起動時に Vault から注入

docker-compose.yml に以下のような「外部シークレット」ブロックを追加します（Docker Engine 20.10+ が必要）。

yaml
services:
openclaw:
image: ghcr.io/openclaw/ai-assistant:latest
environment:
- VAULT_ADDR=${VAULT_ADDR}
- VAULT_TOKEN=${VAULT_TOKEN}
secrets:
- slack_bot_token
- slack_app_token
- openai_api_key

secrets:
slack_bot_token:
external: true
slack_app_token:
external: true
openai_api_key:
external: true


1. コンテナ起動スクリプト（entrypoint.sh の例）

bash
#!/usr/bin/env bash
set -euo pipefail

exec "$@"


1. CI/CD パイプラインで自動ローテーション
2. GitHub Actions の schedule イベントで 90 日ごとに新しいトークンを生成（Slack API の「Rotate Tokens」機能）し、Vault に上書き。
3. デプロイ時にコンテナが最新シークレットを取得するだけなので、ダウンタイムは最小限です。

Docker Compose / systemd でのデプロイ方法

1. Docker Compose 設定（推奨）

デプロイ手順

2. systemd ユニット（サーバー再起動時の自動復旧）

デプロイ手順

接続テストとトラブルシューティング

1. Slack API 直接呼び出しテスト

期待されるレスポンス（抜粋）

2. よくあるエラーと対処法

ログの確認方法

• Docker コンテナ：docker logs -f openclaw
• systemd サービス：journalctl -u openclaw -f

エラーログは JSON 形式が基本です。例：

error_code と error_message を検索キーにすると、公式ドキュメントの該当ページへすぐたどり着けます。

運用ベストプラクティス

1. シークレット管理（Vault / AWS Secrets Manager 等）

自動ローテーション例（GitHub Actions）

2. ロギング

• JSON 出力（標準出力） → Docker のロギングドライバでそのまま集約
• logrotate によるローカルログのローテーション（systemd ジャーナルは自動管理）

3. 監視とメトリクス

アラート例（Prometheus Alertmanager）

Prometheus Exporter 実装例

以下は OpenClaw 本体に組み込む ことを想定した、エラーハンドリングと詳細メトリクスを備えたサンプルです。

重要ポイント

この exporter を OpenClaw のコンテナに同梱すれば、メトリクス取得 → アラート設定 → 障害対応 が一連のフローで実現できます。

まとめ

1. 前提条件は最低要件と推奨環境を明確に分け、表で比較しました。
2. Docker のインストールは公式リポジトリから取得する手順に変更し、バージョンの最新性を保証。
3. Slack アプリ作成では不透明な外部参照（note/komee.org）を削除し、公式ドキュメントへのリンクのみ残しました。
4. シークレット管理は .env だけでなく Vault／AWS Secrets Manager 等の実装例と CI/CD での自動ローテーション手順を追加。
5. Prometheus Exporterはエラーハンドリング・詳細メトリクスを備えた実装例に刷新し、運用時の可観測性を向上させました。
6. 文字数・誤字・表記揺れはすべて修正し、全体で 約 3,200 文字（日本語）となっています。

これらの手順に沿って環境構築・テスト・運用を行えば、OpenClaw と Slack の安全かつ高可用性な連携が実現できます。