OpenClaw セットアップ

このガイドでは、RoqueOS サーバーに OpenClaw エージェントをインストールして設定する方法を説明します。

---

前提条件

前提条件

• RoqueOS サーバーがインストールされ、実行されていること (インストールを見る)
• ソケットへのアクセス権を持つ Docker (/var/run/docker.sock)
• AI プロバイダー (OpenAI または Anthropic) の API キー
• サーバーに最低 4 GB の RAM (8 GB 推奨)

---

1. OpenClaw イメージのダウンロード

OpenClaw は別の Docker コンテナとして実行されます。公式イメージをダウンロードします：

docker pull roqueribeiro1988/roqueos-openclaw:latest

このイメージには以下が含まれます：

• Ubuntu 22.04
• XFCE デスクトップ
• TigerVNC + noVNC
• Chromium ブラウザ
• Node.js 20
• OpenClaw エージェント

---

2. API キーの設定

RoqueOS サーバーの docker-compose.yml ファイルに、AI キーの環境変数を追加します：

OpenAI

services:
  roqueos-server:
    image: roqueribeiro1988/roqueos-server:latest
    environment:
      - TZ=Asia/Tokyo
      - OPENAI_API_KEY=sk-あなたのキーをここに入力

Anthropic

services:
  roqueos-server:
    image: roqueribeiro1988/roqueos-server:latest
    environment:
      - TZ=Asia/Tokyo
      - ANTHROPIC_API_KEY=sk-ant-あなたのキーをここに入力

セキュリティ

公開リポジトリに API キーをコミットしないでください。シークレットを保存するには .env ファイルを使用し、compose ファイルで env_file: .env で参照してください。

.env ファイルの例：

# .env (git にコミットしないでください！)
OPENAI_API_KEY=sk-あなたのキーをここに入力

# docker-compose.yml
services:
  roqueos-server:
    env_file:
      - .env

---

3. 設定の確認

docker compose down && docker compose up -d でサーバーを再起動した後、エージェントモジュールにアクセスできるか確認します：

curl http://localhost:27021/agent/sessions

期待される応答：

[]

---

4. フロントエンドからエージェントにアクセスする

1. RoqueOS を開き、サーバーに接続されていることを確認します。
2. Launchpad で、AI エージェント アプリ (OpenClaw アイコン) を探します。
3. アプリを開くと、チャットインターフェースとデスクトップのプレビューパネルが表示されます。

---

使用されるポート

ポート	プロトコル	説明
27021	HTTP/WS	RoqueOS サーバー API および WebSocket
5901	VNC	OpenClaw コンテナのデスクトップ VNC
6080	HTTP	noVNC (デスクトップへのウェブアクセス)

ポート 5901 と 6080 はサーバーによって内部で管理されており、外部に公開する必要はありません。

---

利用可能な環境変数

変数	説明	デフォルト
OPENAI_API_KEY	OpenAI API キー	—
ANTHROPIC_API_KEY	Anthropic API キー	—
AGENT_MAX_SESSIONS	最大同時セッション数	3
AGENT_TIMEOUT	セッションのタイムアウト（分）	30

---

次のステップ

• OpenClaw の使い方 — 実用的なガイドと例