コンテンツへスキップ
最終更新

OpenClaw はじめ方（Mac / Linux ローカル）

このガイドでは、OpenClaw をローカルで動かし、最初の応答確認までをできるだけ短い流れで進めます。公式の推奨ルートは CLI のオンボーディングです。

事前に準備するもの

  • macOS または Linux マシン
  • Node.js 20 以上
  • 利用するモデル提供元の API key
  • インストールスクリプトへ到達できるネットワーク

Step 0: 環境をざっと確認する

Command
node -vnpm -vpwd

Step 1: OpenClaw CLI を導入する

Command
npm i -g openclaw@latestopenclaw --version

Step 2: command not found を直す

Command
which openclaw || truenpm bin -gecho $PATH

必要ならターミナルを開き直し、PATH に npm のグローバル実行パスが含まれているか確認してください。

Step 3: 古い環境を整理する

過去の clawdbot、moltbot、旧 openclaw パッケージがある場合は先に削除します。

Command
npm uninstall -g clawdbotnpm uninstall -g moltbotnpm uninstall -g openclaw

その後、Step 1 をもう一度実行します。

Step 4: オンボーディングを完了する

Command
openclaw onboard --flow quickstart

最初の検証チャネルは Telegram が扱いやすいです。

Step 5: OpenClaw を起動する

Command
openclaw start

設定変更後に再読み込みしたい場合:

Command
openclaw gateway restart

Step 6: 更新方法

Command
npm i -g openclaw@latestopenclaw --version

Docker / VPS で運用している場合はローカル手順ではなく、対応する展開手順に従って更新してください。

Step 7: アンインストール方法

Command
npm uninstall -g openclaw

状態ディレクトリを完全に消す前に、設定や履歴が不要か確認してください。

Step 8: 代理や制限ネットワークの問題

Command
export https_proxy=http://127.0.0.1:7890export http_proxy=http://127.0.0.1:7890openclaw gateway restart

Step 9: 権限エラー

Command
ls -la ~/.openclaw || true

状態ディレクトリの所有者や書き込み権限を確認してください。

変更後の確認コマンド

Command
openclaw healthopenclaw status --all

関連ガイド