OpenClaw 構築ログ(引き継ぎ用まとめ)

■ 全体の目的
・LM Studio(ローカルLLM)とOpenClawを連携させ、CLIベースで動作するエージェント環境を構築する
・最終的には常駐型(Gateway+自律タスク)まで拡張可能な状態を目指す
・ただし初期段階ではCLI安定動作を優先する方針


■ 導入の経緯(2ルート検証)

・最初にZIP解凍版で導入を試行
→ 依存関係・Gateway・設定周りで詰まり発生
→ onboardingやgateway install周辺で構成不整合が発生

・検証のためCドライブインストール方式(PowerShell install)を実施
→ install.ps1 経由で正常動作を確認
→ LM Studio連携・Gateway構造の理解が進む

・この経験を元に再度ZIP版へ戻る判断


■ ZIP版再構築(再挑戦)

・Node.js / pnpm / LM Studio環境を整備済み状態で再スタート
・pnpm install → pnpm dev により基本動作確認
・gateway install / start / status を手動で実行し構造確認
・Windowsタスクスケジューラ連携が発生することを確認
・gatewayは「常駐サービスではなくタスク実行型」であることを理解


■ Gateway構造の理解

・Gatewayは127.0.0.1:18789でローカル通信ハブとして動作
・LM Studioとの接続はこのGateway経由で行われる
・schtasksでWindowsタスクとして起動管理される
・状態としては以下の2段階構造

 ・Gateway起動(通信ハブ)
・Agent起動(実行クライアント)


■ onboardingプロセス

・pnpm exec node scripts/run-node.mjs onboard –mode local を実行
・QuickStart形式で初期設定を実施
・以下を選択
・Local Gateway
・Model設定(LM Studio接続)
・チャネル・検索・スキル等はスキップ

・Bootstrapが実行され、以下ファイル生成
・IDENTITY.md
・USER.md
・SOUL.md(内部生成)
・その他セッション構造

・BOOTSTRAP.md は処理後に削除される(完了扱い)


■ モデル設定

・LM Studio接続
・http://localhost:1234/v1
・モデル
・初期は80B系がデフォルト選択される場合あり
・最終的に軽量モデル(ministral-3-14b-instruct-2512)へ変更
・context length
・32k → 65kまで拡張してテスト
・結果
・context overflowやstream断が発生するケースあり


■ 発生した問題と挙動

・Gateway token未設定エラー
・gateway.mode 未設定による起動ブロック
・config破損判定(size-drop / anomaly detection)
・agent auth missing(OpenAI provider誤参照)
・streaming watchdog停止(30秒無通信)
・context overflow(33k超過)


■ 最終的な状態

・Gatewayは手動起動で安定動作
・LM Studio接続も確認済み
・Bootstrapは正常終了
・CLI agentは動作確認済み
・ただし自律機能(cron / heartbeat)は未有効


■ 現在の運用方針

・常駐化はまだ行わずCLI運用を優先
・動作安定後にGateway常駐化へ移行予定
・その後に自律タスク(heartbeat / cron)を有効化予定


■ 補足(重要な理解)

・OpenClawは3層構造
・CLI(単発実行)
・Gateway(通信ハブ)
・Agent Workspace(記憶・人格)

・今回の作業は「全層が一応つながった状態」まで到達

コメント