第7回: OpenClawをインストールする

補足: 第7回以降はDocker版・直接版のどちらで進めても内容は同じ。操作画面が若干異なるだけ。

この回で学ぶこと

OpenClawのインストール方法（Docker版 / 直接版の2ルート）
起動確認の方法

前回のおさらい

Dockerの基本操作（コンテナの起動・停止・削除）を体験した。コンテナは使い捨てで、壊しても大丈夫という感覚を掴んだ。今回はいよいよOpenClaw本体をインストールする。

2つのインストールルート

ここでDocker版と直接インストール版の2つのルートに分岐する。

ルート

対象者

メリット

Docker版（推奨）	第5〜6回でDockerを学んだ方	セキュリティが高い。OpenClawが箱の中で動く
直接版	Docker回をスキップした方	セットアップが簡単。Docker不要

どちらのルートでも講座の内容は同じ。この後の回で学ぶSOUL.md・メモリ・Heartbeatなどの操作は全く変わらない。

Docker版のインストール手順

作業フォルダを作成する

mkdir ~/my-secretary && cd ~/my-secretary

公式GitHubからdocker-compose.ymlをダウンロードする（またはコピペで作成する）
docker-compose.ymlを作業フォルダに配置する

curl -O <https://raw.githubusercontent.com/openclaw/openclaw/main/docker-compose.yml>

.envファイルを作成する

docker-compose.ymlは環境変数を参照しているため、.envファイルを作業フォルダ内に作成する必要があります。

cat <<'ENVEOF' > .env
OPENCLAW_IMAGE=ghcr.io/openclaw/openclaw:latest
OPENCLAW_CONFIG_DIR=./config
OPENCLAW_WORKSPACE_DIR=./workspace
ENVEOF

設定・ワークスペースディレクトリを作成する

mkdir -p config workspace

注意: この手順を省略すると invalid spec: empty section between colons エラーが発生します。

初期設定ファイル（openclaw.json）を作成する

config/ディレクトリ内にopenclaw.jsonを作成します。これがないと Missing config エラーでゲートウェイが起動しません。

cat <<'JSONEOF' > config/openclaw.json
{
  "gateway": {
    "mode": "local",
    "bind": "loopback",
    "auth": {
      "mode": "token",
      "token": "ここにランダムな文字列を設定してください"
    }
  }
}
JSONEOF

注意:
tokenの値は必ず推測されにくいランダムな文字列に変更してください。これはゲートウェイへの接続認証に使われます。
この手順を省略すると Missing config. Run openclaw setup or set gateway.mode=local エラーが繰り返し表示されます。

コンテナを起動する

docker compose up -d

起動に失敗してコンテナがクラッシュしている場合は、docker compose restart ではなく以下を実行してください：

docker compose down && docker compose up -d

起動確認

docker compose logs openclaw-gateway --tail 10

以下のようなログが表示されれば起動成功です：

[gateway] listening on ws://0.0.0.0:18789
[heartbeat] started
[health-monitor] started

注意: 一部のガイドでは「Gateway started」と記載されていますが、実際のログにはこの文字列は表示されません。上記3つのメッセージが出ていれば正常に起動しています。

⚠️ Gateway is binding to a non-loopback address という警告はDocker内ではlan bindが必要なため正常です。外部ネットワークに公開しなければ問題ありません。

起動に失敗した場合

`invalid spec: empty section between colons`

→ .envファイルが作成されていません。上記の「.envファイルを作成する」の手順を確認してください。

`Missing config. Run openclaw setup or set gateway.mode=local`

→ config/openclaw.jsonが作成されていません。上記の「初期設定ファイルを作成する」の手順を確認してください。

`non-loopback Control UI requires gateway.controlUi.allowedOrigins`

→ openclaw.jsonにcontrolUi.allowedOriginsの設定が不足しています。以下をgateway内に追加してください：

"controlUi": {
  "allowedOrigins": ["<http://localhost:18789>", "<http://127.0.0.1:18789>"]
}

コンテナがクラッシュして `docker compose restart` が効かない場合

→ docker compose restart ではなく、以下を実行してください：

docker compose down && docker compose up -d

このメッセージは、OpenClawの「受付」（Gateway）が起動したことを意味する。AI秘書がPCの中で待機している状態。

ゴール状態

OpenClawがPCで動いている状態
ログを見て「動いている」と確認できる