OpenClawのセットアップから初期構築まで、実装で必要な3ステップ

環境変数の設定

APIキーは環境変数として管理します。プロジェクトルートに.envファイルを作成し、認証情報を記載します。

# .env ファイルを作成
touch .env

# エディタで以下を記入
OPENAI_API_KEY=sk-xxxxxxxxxxxxxxxxxxxxxxxx
OPENCLAW_PROJECT_NAME=my_first_project
OPENCLAW_ENV=development
  

その後、python-dotenvをインストールして、プログラムから環境変数を読み込みます。

# python-dotenvのインストール
pip install python-dotenv

# Pythonスクリプトで環境変数を読み込み
from dotenv import load_dotenv
import os

load_dotenv()
api_key = os.getenv('OPENAI_API_KEY')
  

OpenClawの初期化

プロジェクトディレクトリ内で、OpenClawプロジェクトを初期化します。

# OpenClawプロジェクトの初期化
openclaw init my_first_project

# プロジェクトディレクトリに移動
cd my_first_project

# ディレクトリ構造の確認
ls -la
  

初期化後、以下のディレクトリ構造が自動生成されます：

my_first_project/
├── config.yaml          # プロジェクト設定ファイル
├── workflows/           # ワークフロー定義フォルダ
├── assets/              # データアセット格納先
├── requirements.txt     # 依存ライブラリ
└── README.md            # プロジェクトドキュメント
  

ステップ3：初めてのワークフロー作成と実行

シンプルなテキスト処理ワークフローの作成

実装を開始する前に、最初は基本的なワークフローで動作確認することをお勧めします。以下は、ユーザーテキストを受け取り、OpenAIで要約を生成するシンプルなワークフローです。

# workflows/summarize.yaml を作成
name: "TextSummarizer"
version: "1.0.0"
description: "テキスト要約ワークフロー"

steps:
  - id: input_validation
    type: filter
    params:
      condition: "len(input_text) > 10"
      
  - id: call_llm
    type: llm_call
    params:
      provider: "openai"
      model: "gpt-3.5-turbo"
      prompt_template: |
        以下のテキストを100字以内で要約してください:
        {input_text}
      
  - id: output_formatter
    type: processor
    params:
      template: |
        元のテキスト長: {len(input_text)}文字
        要約: {llm_response}
  

ワークフロー実行用のPythonスクリプト

作成したワークフローを実行するには、Pythonスクリプトから呼び出します。以下がシンプルな実行例です。

# run_workflow.py
from openclaw import Workflow
from dotenv import load_dotenv
import os

load_dotenv()

# ワークフロー読み込み
workflow = Workflow.load('workflows/summarize.yaml')

# テスト入力
test_input = """
OpenClawは、大言語モデルを活用した自動化ワークフロー構築フレームワークです。
複雑なAIタスクを直感的に構築・管理でき、データ処理パイプライン、
チャットボット開発、意思決定自動化など、多くのシーンで活用が広がっています。
"""

# ワークフロー実行
result = workflow.execute({
    'input_text': test_input,
    'openai_api_key': os.getenv('OPENAI_API_KEY')
})

# 結果出力
print(result)
  

スクリプト実行は以下のコマンドで行います：

python run_workflow.py
  

よくあるセットアップエラーと解決策

エラー：「ModuleNotFoundError: No module named 'openclaw'」

→ 仮想環境が有効化されていないか、pipインストール時に仮想環境内にインストールされていません。仮想環境を再度有効化し、`pip install openclaw`を実行してください。

エラー：「API key not found」

→ 環境変数が正しく設定されていません。`.env`ファイルが存在すること、`load_dotenv()`が実行されていることを確認してください。