OpenClaw Linux セットアップガイド: Ubuntu、Debian、Fedora、Raspberry Pi へのインストール

はじめに

Linux は、OpenClaw を実行するための優れたプラットフォームであり、特に常時稼働サーバーや Raspberry Pi の展開に適しています。このガイドでは、Ubuntu、Debian、Fedora、Raspberry Pi OS などの一般的な Linux ディストリビューションへのインストールに加え、ARM64 サポートと systemd サービス構成について説明します。

一般的なインストール手順については、完全なインストールガイドを参照してください。

システム要件

サポートされているディストリビューション

Ubuntu 20.04+ (LTS 推奨)
Debian 11+ (ブルズアイ以降)
フェドーラ 34+
Raspberry Pi OS (Debian ベース)
Arch Linux (AUR または手動インストール経由)
その他の Debian/Ubuntu ベースのディストリビューション

ハードウェア要件

RAM — 2GB 以上を推奨 (Raspberry Pi の場合は最小 1GB)
ストレージ — インストール用に500MB以上、メモリ/データ用の追加スペース
CPU — x86_64 または ARM64 アーキテクチャ
ネットワーク — API 呼び出しと更新のためのインターネット接続

ソフトウェアの前提条件

Node.js 18+ — ワンライナーインストーラーで自動インストール可能
curl — 通常はプリインストールされています
git — オプション、ソースからハッキング可能なインストール用
systemd — サービス管理用 (最新のディストリビューション)

インストール方法

方法 1: ワンライナーインストール (推奨)

Linux に OpenClaw をインストールする最も簡単な方法:

curl -fsSL https://openclaw.ai/install.sh | bash

このスクリプトは自動的に次のことを行います。

Linux ディストリビューションを検出します
Node.js が見つからない場合はインストールします (NodeSource または配布パッケージマネージャー経由)
npm 経由で OpenClaw をグローバルにインストールします
必要な権限を設定します
インストールを検証します

注意: Node.js またはシステムパッケージをインストールするために、パスワード (sudo) の入力を求められる場合があります。

方法 2: npm インストール

すでに Node.js がインストールされている場合:

npm i -g openclaw

まず Node.js のバージョンを確認します。

node --version

v18.0.0以降である必要があります。

方法 3: ディストリビューション固有のパッケージ

Ubuntu/Debian (apt 経由)

一部のディストリビューションでは OpenClaw パッケージが利用できる場合があります。

# Add repository (if available)
curl -fsSL https://openclaw.ai/repo/deb/pubkey.gpg | sudo gpg --dearmor -o /usr/share/keyrings/openclaw.gpg
echo "deb [signed-by=/usr/share/keyrings/openclaw.gpg] https://openclaw.ai/repo/deb stable main" | sudo tee /etc/apt/sources.list.d/openclaw.list

# Install
sudo apt update
sudo apt install openclaw

注意: 公式パッケージはまだ入手できない場合があります。最新のインストール方法については、docs.openclaw.ai を確認してください。

Fedora (dnf 経由)

# Add repository (if available)
sudo dnf install openclaw

Arch Linux (AUR 経由)

yay -S openclaw
# or
paru -S openclaw

方法 4: ハッキング可能なインストール (ソースから)

ソースを変更したい開発者向け:

git clone https://github.com/openclaw/openclaw.git
cd openclaw
npm install
npm run build

次に、次を実行します。

npm run openclaw onboard

またはグローバルにリンクします:

sudo npm link --global

Node.js のインストール

Ubuntu/Debian

オプション 1: NodeSource リポジトリ (推奨)

curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash -
sudo apt-get install -y nodejs

オプション 2: 配布パッケージ

sudo apt update
sudo apt install nodejs npm

注意: 配布パッケージは古い可能性があります。 NodeSource は新しいバージョンを提供します。

オプション 3: nvm (ノードバージョンマネージャー)

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
source ~/.bashrc
nvm install 18
nvm use 18

フェドーラ

sudo dnf install nodejs npm

または、NodeSource を使用します。

curl -fsSL https://rpm.nodesource.com/setup_18.x | sudo bash -
sudo dnf install -y nodejs

ラズベリーパイ (ARM64/ARMv7)

Raspberry Pi OS (Debian ベース)

curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash -
sudo apt-get install -y nodejs

ARMv7 (32 ビット) の場合、NodeSource にパッケージがない可能性があります。配布パッケージを使用するか、ソースからビルドします。

代替案: nvm 経由でインストールする

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
source ~/.bashrc
nvm install 18

インストール後のセットアップ

インストール後、OpenClaw を構成します。

openclaw onboard

この対話型セットアップでは次のことがカバーされます。

1. AI モデルの構成

AI プロバイダーを選択してください:

人間的なクロード:

クロード 3.5 ソネット (推奨)
クロード 3 作品
クロード 4

console.anthropic.com から API キーを取得します。

OpenAI GPT:

GPT-4o
GPT-4ターボ
GPT-4.1

platform.openai.com から API キーを取得します。

ローカルモデル:

Ollama (ローカルで実行、API キーは必要ありません)
LMスタジオ
ミニマックス

2. Linux の権限

OpenClaw には権限が必要な場合があります。- ファイルシステム — ~/.openclaw への読み取り/書き込みアクセス

ネットワーク — API 呼び出しとチャットブリッジ用
システムコマンド - システム制御機能を使用する場合

3. ファイアウォールの構成

OpenClaw のファイアウォール通過を許可します。

UFW (Ubuntu/Debian):

sudo ufw allow 3000/tcp

ファイアウォール (Fedora/RHEL):

sudo firewall-cmd --add-port=3000/tcp --permanent
sudo firewall-cmd --reload

OpenClaw を実行する

サーバーを起動します

openclaw

これにより、ローカルサーバーが起動し、構成されたすべての統合が接続されます。

バックグラウンドで実行

nohup を使用します。

nohup openclaw > ~/.openclaw/logs/output.log 2>&1 &

または、screen を使用します。

screen -S openclaw
openclaw
# Press Ctrl+A then D to detach

または、tmux を使用します。

tmux new -s openclaw
openclaw
# Press Ctrl+B then D to detach

systemd サービスとして実行 (常時オン)

自動起動用の systemd サービスを作成します。

サービスファイルを作成します:

sudo nano /etc/systemd/system/openclaw.service

構成を追加:

[Unit]
Description=OpenClaw Personal AI Assistant
After=network.target

[Service]
Type=simple
User=your-username
WorkingDirectory=/home/your-username
ExecStart=/usr/bin/openclaw
Restart=always
RestartSec=10
Environment="NODE_ENV=production"

[Install]
WantedBy=multi-user.target

your-username を実際のユーザー名に置き換えます。

systemd をリロード:
```
sudo systemctl daemon-reload
```
サービスを有効にする:
```
sudo systemctl enable openclaw
```
サービスの開始:
```
sudo systemctl start openclaw
```
ステータスを確認:
```
sudo systemctl status openclaw
```
ログの表示:
```
sudo journalctl -u openclaw -f
```

pm2 (プロセスマネージャー) の使用

pm2 をインストールします。

npm i -g pm2

OpenClaw を起動します。

pm2 start openclaw
pm2 save
pm2 startup

pm2 startup コマンドは、systemd サービスを自動的に生成します。

Raspberry Pi 固有のセットアップ

パフォーマンスの最適化

Raspberry Pi のリソースは限られています。最適化:

軽量の AI モデルを使用:
- ローカルモデル (Ollama) の効率が向上しました
- または、より小規模なクラウドモデルを使用する
同時操作を制限します:
- より少ない同時リクエストを処理するように OpenClaw を構成する
リソースの監視:
```
htop
```

常時接続のセットアップ

Raspberry Pi を 24 時間 365 日稼働させる場合:

systemd サービスを使用します (上記を参照)
自動ログインを有効にする (必要な場合)

電源管理を構成します:

sudo raspi-config
# Navigate to Advanced Options → Wait for Network at Boot

Cloudflare トンネル (外部アクセス)

OpenClaw をインターネットに安全に公開します。

cloudflared をインストール:

curl -L https://github.com/cloudflare/cloudflared/releases/latest/download/cloudflared-linux-arm64 -o cloudflared
chmod +x cloudflared
sudo mv cloudflared /usr/local/bin/

認証:
```
cloudflared tunnel login
```
トンネルを作成:
```
cloudflared tunnel create openclaw
```

設定: ~/.cloudflared/config.yml を作成します。

tunnel: <tunnel-id>
credentials-file: /home/pi/.cloudflared/<tunnel-id>.json

ingress:
  - hostname: openclaw.yourdomain.com
    service: http://localhost:3000
  - service: http_status:404

トンネルを実行:
```
cloudflared tunnel run openclaw
```
systemd に追加 (自動起動用):
```
sudo cloudflared service install
```

ARM64 のサポート

OpenClaw は ARM64 アーキテクチャで動作します。

Apple Silicon Mac (Linux VM 経由)
Raspberry Pi 4+ (64 ビット)
AWS Graviton インスタンス
その他の ARM64 サーバー

インストールはx86_64と同じです。ワンライナーインストーラーはアーキテクチャを自動的に検出します。

ARMv7 (32 ビット Raspberry Pi) の場合、一部のパッケージが利用できない場合があります。配布パッケージを使用するか、ソースからビルドします。

トラブルシューティング

権限拒否エラー

権限エラーが表示された場合:

sudo npm i -g openclaw

または、npm 権限を修正します。

mkdir ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrc

コマンドが見つかりません

openclaw が見つからない場合:

npm グローバルパスを確認します:
```
npm config get prefix
```

PATH に追加:

echo 'export PATH="$(npm config get prefix)/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

ターミナルを再起動します

ポートはすでに使用されています

ポートを変更します。

openclaw --port 3001

または、プロセスを見つけて強制終了します。

lsof -ti:3000 | xargs kill
# or
sudo netstat -tlnp | grep :3000
sudo kill <PID>

systemd サービスの問題

サービスの開始に失敗した場合:

ログを確認します:
```
sudo journalctl -u openclaw -n 50
```
ユーザーの確認: サービスが正しいユーザーとして実行されていることを確認してください
権限を確認します:
```
ls -la ~/.openclaw
```
手動でテストします:
```
openclaw
```

Raspberry Pi 固有の問題

メモリ不足:

# Increase swap
sudo dphys-swapfile swapoff
sudo nano /etc/dphys-swapfile
# Set CONF_SWAPSIZE=2048
sudo dphys-swapfile setup
sudo dphys-swapfile swapon

パフォーマンスが遅い:

より軽量な AI モデルを使用する
ブラウザセッションを制限する
メモリ使用量を削減する

パフォーマンスのヒント

リソースの監視

CPU とメモリを監視します。

htop
# or
top

ディスク使用量を監視します。

df -h
du -sh ~/.openclaw
```### 最適化

- **ローカル モデルを使用**すると、ローエンド ハードウェアのパフォーマンスが向上します
- **ブラウザ セッションを制限**してメモリ使用量を削減します
- **ログ ローテーションを構成**して、ディスクがいっぱいになるのを防ぎます
- **SD カードの代わりに SSD を使用** (Raspberry Pi)

## OpenClaw の更新

最新バージョンに更新します。

```bash
npm update -g openclaw

または、インストーラーを再実行します。

curl -fsSL https://openclaw.ai/install.sh | bash

アンインストール中

OpenClaw を削除します。

npm uninstall -g openclaw

構成を削除します。

rm -rf ~/.openclaw

systemd サービスを停止して削除します。

sudo systemctl stop openclaw
sudo systemctl disable openclaw
sudo rm /etc/systemd/system/openclaw.service
sudo systemctl daemon-reload

次のステップ

これで、OpenClaw が Linux にインストールされました。

Always-On のセットアップ — systemd サービスの構成
チャットアプリに接続 — WhatsApp、Telegram、Discord
スキルを探索する — スキルライブラリ
よくある質問を読む — よくある質問

結論

Linux は、OpenClaw、特に常時稼働環境や Raspberry Pi プロジェクトにとって優れたプラットフォームです。ワンライナーインストーラーはほとんどの複雑さを処理し、systemd 統合によりサービスとして簡単に実行できます。

さらに詳しいヘルプが必要な場合は、一般インストールガイドまたは FAQ ページを参照してください。 Linux で自動化を楽しんでください。

Cookieプロトコルを開始しました

Quick Answer