OpenClawを30分でセットアップ
このOpenClawセットアップガイドに従えば、OpenClawのインストールから最初のチャットまで30分以内で完了します。OpenClaw初心者の方も安心してOpenClawの導入を進められます。
OpenClawインストール前の準備
OpenClawをインストールする前に、お使いの環境がOpenClawの動作要件を満たしているか確認しましょう。
OpenClawの動作環境
OpenClawは幅広いプラットフォームで動作します:
| プラットフォーム | 対応状況 | 推奨度 |
|---|---|---|
| macOS (12.0以上) | 完全対応 | 最推奨 |
| Linux (Ubuntu 20.04以上) | 完全対応 | 最推奨(サーバー運用) |
| Windows WSL2 | 完全対応 | 推奨(Windowsユーザー) |
| Docker | 完全対応 | 推奨(隔離実行) |
OpenClawに必要なソフトウェア
OpenClawのインストールには以下のソフトウェアが必要です:
- Python 3.10以上:OpenClawのコアランタイム。
python3 --versionで確認 - Node.js 18以上:OpenClawのスキルエンジン用。
node --versionで確認 - Git:OpenClawのアップデートとスキル管理用。
git --versionで確認 - pip または Homebrew:OpenClawのパッケージ管理用
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.
ステップ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に接続する手順です:
- Slack API (api.slack.com) で新しいアプリを作成
- Bot Token Scopes で必要な権限を付与(chat:write, channels:read等)
- ワークスペースにインストールしてBot Tokenを取得
- 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に接続する手順です:
- LINE Developers (developers.line.biz) でプロバイダーを作成
- Messaging APIチャンネルを作成
- Channel Access TokenとChannel Secretを取得
- 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.
Discord連携の設定
OpenClawをDiscordに接続する手順です:
- Discord Developer Portal でアプリケーションを作成
- Botセクションでボットを作成し、Tokenを取得
- OAuth2 URL Generatorでボット招待URLを生成し、サーバーに招待
- 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
OpenClawセットアップ後の次のステップ
OpenClawのセットアップが完了したら、以下の機能を試してみましょう:
- OpenClawのAI人格をカスタマイズ:OpenClawの口調や性格を自分好みに設定
- OpenClawのスキルを拡張:ClawHubマーケットから便利なスキルを追加
- マルチチャネル連携を設定:OpenClawを複数のチャネルで活用
- 自動化を設定:OpenClawに定期タスクや条件トリガーを設定
- Nodesでマルチマシン連携:スマホから自宅PCのOpenClawを操作
OpenClawの概要・全機能についてはOpenClaw概要・できることもご覧ください。