OpenClawを30分でセットアップ

このOpenClawセットアップガイドに従えば、OpenClawのインストールから最初のチャットまで30分以内で完了します。OpenClaw初心者の方も安心してOpenClawの導入を進められます。

OpenClawインストール前の準備

OpenClawをインストールする前に、お使いの環境がOpenClawの動作要件を満たしているか確認しましょう。

OpenClawの動作環境

OpenClawは幅広いプラットフォームで動作します:

プラットフォーム 対応状況 推奨度
macOS (12.0以上) 完全対応 最推奨
Linux (Ubuntu 20.04以上) 完全対応 最推奨(サーバー運用)
Windows WSL2 完全対応 推奨(Windowsユーザー)
Docker 完全対応 推奨(隔離実行)
ITエンジニアの転職なら【TechGO(テックゴー)】

OpenClawに必要なソフトウェア

OpenClawのインストールには以下のソフトウェアが必要です:

  • Python 3.10以上OpenClawのコアランタイム。python3 --version で確認
  • Node.js 18以上OpenClawのスキルエンジン用。node --version で確認
  • GitOpenClawのアップデートとスキル管理用。git --version で確認
  • pip または HomebrewOpenClawのパッケージ管理用

LLM APIキーの準備

OpenClawはLLM(大規模言語モデル)を利用するため、APIキーが必要です。以下のいずれかを事前に取得しておきましょう:

  • OpenAI API:GPT-4o、GPT-4o-miniなどをOpenClawで利用する場合
  • Anthropic API:ClaudeモデルをOpenClawで利用する場合
  • Google AI API:GeminiモデルをOpenClawで利用する場合
  • ローカルLLM:Ollamaなどを使用すればAPIキー不要でOpenClawを利用可能

OpenClawのインストール手順

OpenClawのインストールは複数の方法があります。お使いの環境に合った方法でOpenClawをインストールしてください。

方法1:pip でOpenClawをインストール(推奨)

最も簡単なOpenClawのインストール方法です:

# OpenClawのインストール
pip install openclaw

# インストール確認
openclaw --version

# 出力例: OpenClaw v2.4.1
                    

方法2:Homebrew でOpenClawをインストール(macOS)

macOSユーザーはHomebrewでOpenClawをインストールできます:

# OpenClawのインストール
brew install openclaw

# インストール確認
openclaw --version
                    

方法3:Docker でOpenClawをインストール

環境を汚さずにOpenClawを試したい場合はDockerがおすすめです:

# OpenClaw Dockerイメージの取得
docker pull openclaw/openclaw:latest

# OpenClawコンテナの起動
docker run -it --name openclaw \
  -v ~/.openclaw:/root/.openclaw \
  openclaw/openclaw:latest

# Docker Composeを使う場合
docker compose up -d
                    

方法4:ソースからOpenClawをインストール

開発者向け。OpenClawの最新開発版をビルドする場合:

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

# 依存関係のインストール
pip install -e ".[dev]"

# OpenClawの起動確認
openclaw --version
                    

OpenClawの初期設定

OpenClawのインストールが完了したら、初期設定を行います。openclaw init コマンドで対話式にセットアップできます。

ステップ1:openclaw init の実行

# OpenClaw初期設定の開始
openclaw init

# 対話式セットアップが開始されます
# Welcome to OpenClaw Setup!
#
# Step 1: Choose your LLM provider
# [1] OpenAI (GPT-4o, GPT-4o-mini)
# [2] Anthropic (Claude)
# [3] Google AI (Gemini)
# [4] Local LLM (Ollama)
# [5] Custom endpoint
#
# Enter your choice: 1
# Enter your OpenAI API key: sk-xxxxxxxx
#
# Step 2: Choose your default model
# [1] gpt-4o (recommended)
# [2] gpt-4o-mini (cost-effective)
#
# Setup complete! Run 'openclaw chat' to start.
                    
ITエンジニアの転職なら【TechGO(テックゴー)】

ステップ2:設定ファイルの確認と編集

OpenClawの設定ファイルは ~/.openclaw/config.yaml に保存されます。手動で編集することも可能です:

# ~/.openclaw/config.yaml
# OpenClaw 基本設定

# LLMプロバイダー設定
llm:
  provider: "openai"
  api_key: "${OPENAI_API_KEY}"   # 環境変数から読み込み
  default_model: "gpt-4o"
  fallback_model: "gpt-4o-mini"  # フォールバック用
  max_tokens: 4096
  temperature: 0.7

# OpenClaw基本設定
core:
  language: "ja"           # デフォルト言語
  timezone: "Asia/Tokyo"   # タイムゾーン
  log_level: "info"        # ログレベル
  memory_enabled: true     # メモリ機能
  cache_enabled: true      # キャッシュ機能

# ペルソナ設定
persona:
  name: "Claw"
  style: "professional"    # professional / friendly / technical
  honorific: true          # 敬語を使用
                    

ステップ3:環境変数の設定

セキュリティのため、OpenClawのAPIキーは環境変数で管理することを推奨します:

# ~/.bashrc または ~/.zshrc に追加

# OpenClaw LLM API設定
export OPENAI_API_KEY="sk-your-openai-api-key"
# または
export ANTHROPIC_API_KEY="sk-ant-your-anthropic-key"

# 設定を反映
source ~/.bashrc
                    

OpenClawの初回起動とテスト

OpenClawのセットアップが完了したら、まずローカルチャットで動作確認しましょう。

ローカルチャットの開始

# OpenClawのローカルチャットを開始
openclaw chat

# OpenClaw v2.4.1 - AI Personal Assistant
# Type 'exit' to quit, '/help' for commands
#
# You: こんにちは、OpenClaw!
# Claw: こんにちは!OpenClawです。何かお手伝いできることはありますか?
#
# You: 今日の天気を教えて
# Claw: 申し訳ありません、現在天気スキルが未インストールです。
#       'openclaw skill install weather' でインストールできます。
#
# You: exit
                    

インストールの検証

OpenClawが正しくインストールされているか、診断コマンドで確認できます:

# OpenClaw診断コマンド
openclaw doctor

# ✅ OpenClaw Core: v2.4.1
# ✅ Python: 3.12.1
# ✅ Node.js: v20.11.0
# ✅ LLM Provider: OpenAI (connected)
# ✅ Config: Valid
# ✅ Memory Store: Initialized
# ⚠️ Channels: No channels connected
#
# Overall: OpenClaw is ready! Connect a channel to get started.
                    

OpenClawのチャネル接続設定

OpenClawの真価は、チャットプラットフォームとの連携で発揮されます。ここでは主要チャネルの接続方法を解説します。

Slack連携の設定

OpenClawをSlackに接続する手順です:

  1. Slack API (api.slack.com) で新しいアプリを作成
  2. Bot Token Scopes で必要な権限を付与(chat:write, channels:read等)
  3. ワークスペースにインストールしてBot Tokenを取得
  4. OpenClawにSlack接続を設定:
# OpenClawにSlackを接続
openclaw connect slack

# Enter your Slack Bot Token: xoxb-xxxxxxxx
# Enter your Slack App Token: xapp-xxxxxxxx
#
# Testing connection...
# ✅ Connected to workspace: your-workspace
# ✅ Bot user: @OpenClaw
#
# Slack connection configured successfully!
                    

LINE連携の設定

OpenClawをLINEに接続する手順です:

  1. LINE Developers (developers.line.biz) でプロバイダーを作成
  2. Messaging APIチャンネルを作成
  3. Channel Access TokenとChannel Secretを取得
  4. OpenClawにLINE接続を設定:
# OpenClawにLINEを接続
openclaw connect line

# Enter your LINE Channel Access Token: xxxxxxxx
# Enter your LINE Channel Secret: xxxxxxxx
#
# ✅ LINE channel configured!
# Webhook URL: https://your-domain/webhooks/line
#
# Set this URL in LINE Developers console.
                    
ITエンジニアの転職なら【TechGO(テックゴー)】

Discord連携の設定

OpenClawをDiscordに接続する手順です:

  1. Discord Developer Portal でアプリケーションを作成
  2. Botセクションでボットを作成し、Tokenを取得
  3. OAuth2 URL Generatorでボット招待URLを生成し、サーバーに招待
  4. OpenClawにDiscord接続を設定:
# OpenClawにDiscordを接続
openclaw connect discord

# Enter your Discord Bot Token: xxxxxxxx
#
# ✅ Connected to Discord!
# Servers: your-server (123456789)
#
# Discord connection configured successfully!
                    

OpenClawスキルのインストール

OpenClawの機能はスキル(プラグイン)で拡張できます。基本スキルをインストールしましょう:

# OpenClaw推奨スキルのインストール
openclaw skill install weather        # 天気情報
openclaw skill install calendar        # カレンダー連携
openclaw skill install web-search      # Web検索
openclaw skill install file-manager    # ファイル操作
openclaw skill install code-runner     # コード実行

# インストール済みスキルの確認
openclaw skill list

# Installed Skills:
# - weather v1.2.0
# - calendar v2.0.1
# - web-search v1.5.3
# - file-manager v1.1.0
# - code-runner v3.0.0
                    

OpenClawの常駐起動

OpenClawをバックグラウンドで常時稼働させ、チャネルからのメッセージに自動応答するようにしましょう。

OpenClawデーモンの起動

# OpenClawをデーモンモードで起動
openclaw start

# OpenClaw daemon started!
# PID: 12345
# Channels: slack, line, discord
# Status: Running
#
# Use 'openclaw status' to check status
# Use 'openclaw stop' to stop

# ステータス確認
openclaw status

# OpenClaw Status:
# ✅ Core: Running (PID 12345)
# ✅ Slack: Connected (2 channels)
# ✅ LINE: Connected
# ✅ Discord: Connected (1 server)
# Memory: 256MB
# Uptime: 5 minutes
                    

OS起動時の自動起動設定

OpenClawをPC起動時に自動的に立ち上げるには:

# macOS / Linux: systemdサービスとして登録
openclaw service install

# ✅ OpenClaw service installed!
# Service will start automatically on boot.
#
# Manual control:
# systemctl start openclaw
# systemctl stop openclaw
# systemctl status openclaw
                    

OpenClawセットアップのトラブルシューティング

OpenClawのインストールやセットアップで問題が発生した場合の対処法です。

インストール時のよくある問題

  • 「pip: command not found」エラー:Python3がインストールされているか確認。python3 -m pip install openclaw を試す
  • 権限エラーpip install --user openclaw またはvenv環境内で実行
  • バージョン不一致python3 --version でPython 3.10以上であることを確認

API接続の問題

  • 「API key invalid」エラー:APIキーが正しくコピーされているか確認。先頭・末尾のスペースに注意
  • 「Rate limit exceeded」:APIプロバイダーの利用制限。しばらく待つか、プランをアップグレード
  • 「Connection refused」:ネットワーク接続を確認。プロキシ設定が必要な場合は ~/.openclaw/config.yaml にプロキシを追加

チャネル接続の問題

  • Slackでボットが応答しない:Event Subscriptionsが有効か確認。Botのスコープ権限を再チェック
  • LINEのWebhookエラー:Webhook URLが正しいか確認。SSL証明書が有効期限内か確認
  • Discordでメッセージが受信されない:Intentsの設定(Message Content Intent)を有効化
# OpenClaw診断コマンドで問題を特定
openclaw doctor --verbose

# 特定チャネルの診断
openclaw diagnose slack
openclaw diagnose line
openclaw diagnose discord

# ログの確認
openclaw logs --tail 50
                    
ITエンジニアの転職なら【TechGO(テックゴー)】

OpenClawセットアップ後の次のステップ

OpenClawのセットアップが完了したら、以下の機能を試してみましょう:

OpenClawの概要・全機能についてはOpenClaw概要・できることもご覧ください。

OpenClawを使いこなそう

OpenClawのセットアップは完了しましたか?次はOpenClawをカスタマイズして、あなただけのAI秘書を作り上げましょう。