OpenClaw × Mattermost 完全構築記録

INTRO OpenClawとは何か

OpenClaw（旧称：Clawdbot / Moltbot）は、Peter Steinbergerが開発したオープンソースのローカルファースト自律型AIエージェントランタイムだ。WhatsApp・Telegram・Slack・Discord・Mattermostといった既存のチャットアプリをUIとして使いながら、裏側でLLMがシェルコマンドの実行、ブラウザ操作、ファイル読み書き、メール送信などを自律的にこなす。

ChatGPTやClaudeのようなWebチャットとの決定的な違いは「実際に手を動かせること」だ。構成は3層で理解すると整理しやすい。

• Gateway：各チャットプラットフォームとの通信を束ねるコントロールプレーン
• Brain：LLMによる意思決定エンジン（モデル非依存）
• Skills：エージェントが実行できる機能（ブラウザ制御・シェル実行など）

今回はこれをDockerで動かす。コンテナ構成は以下の通りだ。

STEP 0 🦞 OpenClaw本体の導入（Docker）

Mattermostとの接続設定に入る前に、OpenClaw本体を立ち上げる。公式が用意する docker-setup.sh を使うのが最短ルートだ。

前提条件の確認：

# Docker と Compose v2 が入っていることを確認
docker --version
docker compose version

# git が入っていることを確認
git --version

リポジトリのクローンとセットアップ：

# リポジトリをクローン
git clone https://github.com/openclaw/openclaw.git
cd openclaw

# 公式セットアップスクリプトを実行（初回ビルド＋対話式ウィザード）
./docker-setup.sh

スクリプト実行後、対話式のオンボーディングウィザードが起動する。主な設定項目は以下の通りだ。

ウィザード完了後、以下のコマンドで起動する。

# イメージをビルド（初回のみ数分かかる）
docker build -t openclaw:local -f Dockerfile .

# オンボーディング（ウィザード未実施の場合のみ）
docker compose run --rm openclaw-cli onboard

# Gatewayをバックグラウンドで起動
docker compose up -d openclaw-gateway

Webダッシュボードへのアクセスが必要な場合は以下で確認する。

# ダッシュボードURL（tokenパラメータ付き）を取得
docker compose run --rm openclaw-cli dashboard --no-open
# → 出力されたURLをブラウザで開く（http://127.0.0.1:18789/?token=...）

STEP 1 🤖 Mattermost側のBot準備

OpenClawが憑依するための空のアカウントをMattermost上に用意する。システム管理者権限が必要だ。

1. システム管理者でMattermostにログイン。
2. 左上メニュー → 「統合機能（Integrations）」 → 「Botアカウント」 へ進む。
3. 「Botアカウントを追加する」から任意のユーザー名（例: openclaw-bot）を設定して保存。
4. 生成されたアクセストークン（Bot Token） を必ずメモする（この画面を閉じると再表示されない）。
5. 対象チームを開き、「メンバーを招待する」からBotアカウントをチームに所属させる。

STEP 2 ⚙️ docker-compose.yml への環境変数追記

OpenClawのGatewayコンテナに、MattermostのURLと認証トークンを環境変数として渡す。Dockerの環境変数経由で渡すのが正解で、JSONに直書きしてはいけない（理由はSTEP 3で詳述）。

nano ~/openclaw/docker-compose.yml

openclaw-gateway の environment: セクションに以下を追記する。

    environment:
      # （既存の設定はそのまま残す）
      MATTERMOST_URL: https://mattermost.your-domain.example.com
      MATTERMOST_BOT_TOKEN: <STEP 1で取得したアクセストークン>

STEP 3 📄 openclaw.json でプラグイン有効化

続いて、OpenClaw本体の設定ファイルでMattermostプラグインのスイッチをONにする。

nano ~/.openclaw/openclaw.json

"plugins" セクションを以下の通り編集する。config ブロックは絶対に書かないのがポイントだ。

{
  "plugins": {
    "entries": {
      "mattermost": {
        "enabled": true
      }
    }
  }
}

既存の "agent": { "model": "..." } 等の項目は削除せず残しておくこと。

STEP 4 🚀 起動とペアリング承認

設定を反映させてGatewayコンテナを再起動し、ユーザーとBotを紐付ける。

コンテナを再構築して起動：

cd ~/openclaw
docker compose up -d

接続ログの確認：

docker compose logs -f openclaw-gateway

チャンネルへのBot招待とペアリング：

1. Mattermostで対象チャンネルを開き、/invite @openclaw-bot を実行してBotを招待する。
2. Botに話しかける（例: @openclaw-bot hello）。
3. Botから 「Pairing code: XXXXXXXX」 というメッセージが返ってくる。
4. ターミナルに戻り、表示されたコードで以下を実行する。

docker compose run --rm openclaw-cli pairing approve mattermost <8桁のペアリングコード>

BONUS 🔄 モデル切り替え手順

用途に応じてLLMを差し替えたい場合は以下の3ステップで完結する。

1. ~/.openclaw/openclaw.json を開く。
2. "model" の値を使用したいモデル識別子に書き換えて保存する。
3. docker compose restart openclaw-gateway でコンテナに反映させる。

// OpenRouter経由でモデルを指定する場合の形式
"model": "openrouter/openai/gpt-5-mini"
"model": "openrouter/anthropic/claude-sonnet-4-5"
"model": "openrouter/google/gemini-2.0-flash"