プラットフォーム固有のインストール・権限エラー
あるマシンでは通るインストールが別のマシンで失敗する場合、原因はOpenClaw本体ではなくプラットフォーム側にあるのがほとんどです。以下の各不具合は単一のOSに限定されるため、まず目次から自分の環境を探してください。他の項目は該当しません。
スキルインストール失敗:LinuxにHomebrewがない
一部のOpenClawスキル(github、summarize)はそのマニフェストでHomebrewを依存関係として宣言しています。Homebrewのないサーバーでは'brew not installed'で失敗します。
✅ 修正1 — LinuxにHomebrew(Linuxbrew)をインストール
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)" # PATHに追加(~/.bashrcまたは~/.zshrcに追加) echo 'eval "$(/home/linuxbrew/.linuxbrew/bin/brew shellenv)"' >> ~/.bashrc eval "$(/home/linuxbrew/.linuxbrew/bin/brew shellenv)" # 確認 brew --version
✅ 修正2 — スキル依存関係を手動インストール
# 'github'スキル用 — GitHub CLIをインストール curl -fsSL https://cli.github.com/packages/githubcli-archive-keyring.gpg | sudo gpg --dearmor -o /usr/share/keyrings/githubcli-archive-keyring.gpg echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/githubcli-archive-keyring.gpg] https://cli.github.com/packages stable main" | sudo tee /etc/apt/sources.list.d/github-cli.list > /dev/null sudo apt update && sudo apt install gh # 'summarize'スキル用 — pandocをインストール sudo apt install pandoc
✅ 修正3 — 失敗するスキルをスキップ
# openclaw.yamlで、Homebrewが必要なスキルを無効化
skills:
disabled:
- github
- summarize一部のスキルはHomebrewを使ってシステムレベルのツールバイナリ(GitHub CLI 'gh'やsummarize用のpandocなど)をインストールします。LinuxのHomebrewは/home/linuxbrew/.linuxbrewにインストールされ、rootを必要としません。
Windows 11:QMDメモリバックエンド — tsxモジュールが見つからない
Windows 11でBunを通じてインストールしたQMDはモジュール解決エラーで失敗します。qmdバイナリはBunによって注入されたtsxランタイムを見つけられません。
- →Error: Cannot find module 'tsx'
- →Error [ERR_MODULE_NOT_FOUND]: Cannot find package 'tsx'
- →qmd: failed to resolve runtime — ensure tsx is installed globally
✅ 修正1 — Bunの代わりにNode.js + npxを使用
# BunでQMDをアンインストール bun uninstall -g qmd # 代わりにnpmでインストール npm install -g @openclaw/qmd # 確認 qmd --version
✅ 修正2 — npmでtsxをグローバルインストール
# tsxをグローバルインストール npm install -g tsx # 解決を確認 tsx --version # その後QMDを再インストール bun install -g qmd
✅ 修正3 — QMDバイナリパスを手動で指定
# openclaw.jsonで完全パスを指定:
{
"memory": {
"provider": "qmd",
"qmd": {
"bin": "C:\\Users\\ユーザー名\\AppData\\Roaming\\bun\\bin\\qmd.exe"
}
}
}Raspberry Pi 5:ファイルの読み書きやスキルのインストールができない
Raspberry Pi OS(64ビット)へのOpenClawの新規インストールでは、エージェントがセッション専用権限モードになることが多い。OSユーザーが完全アクセス権を持っていても、エージェントはファイルの読み書きやスキルのインストールができないと報告します。
- →"システム上のファイルを読み取りまたは書き込む権限がありません。"
- →"スキルをインストールできません — 必要な権限がないため、ご自身でインストールしてください。"
✅ 修正1 — tools.profileを'coding'に設定(v2026.3.2と同じ修正)
# ~/.openclaw/openclaw.jsonを編集
{
"tools": {
"profile": "coding"
}
}
# ゲートウェイを再起動
openclaw gateway restart✅ 修正2 — OpenClawが正しいユーザーとして実行されているか確認
# ゲートウェイプロセスを実行しているユーザーを確認 ps aux | grep openclaw # Piユーザー(例:'pi')を表示するはず、'root'ではない # rootで実行している場合は、ユーザーアカウントで再インストール
✅ 修正3 — ファイル操作のためにワークスペースアクセスを許可
# openclaw.yamlでワークスペースディレクトリを設定
workspace:
dir: /home/pi/openclaw-workspace
allow:
- read
- write
- execute🥧 推奨Pi 5設定
# モデル:Raspberry Pi 5(8GB)— 強く推奨 # ストレージ:64GB+ A2グレードのmicroSDまたはPCIe HAT経由のNVMe SSD # 冷却:アクティブクーラー(Raspberry Pi公式)— 持続的な推論に不可欠 # モデル:Ollamaを通じてGemma 2B / Phi-3-mini / Qwen2-0.5B # Pi 5にOllamaをインストール: curl -fsSL https://ollama.com/install.sh | sh ollama run phi3:mini
screen_recordがサンドボックスによりブロック & system.whichが失敗
screen_recordツールは'session'ツールプロファイルによってブロックされ、ツールプロファイルにexec権限が含まれていない場合system.whichも失敗します。どちらもv2026.3.2のデフォルトセキュリティ動作です。
✅ 修正1 — screen_recordを明示的に許可
# openclaw.jsonでscreen_recordをホワイトリスト登録
{
"tools": {
"profile": "session",
"allow": ["screen_record"]
}
}
# または許可プロファイルに切り替え:
# "profile": "coding" (exec + システムツールを含む)✅ 修正2 — exec権限を有効にしてsystem.whichを修正
# system.whichには'exec'機能が必要
{
"tools": {
"profile": "session",
"allow": ["system.which", "run_bash"]
}
}screen_recordはエージェントに画面をキャプチャする能力を与えます。信頼できる環境と制御するエージェントでのみ有効にしてください。ヘッドレスサーバーでは、このツールは役に立ちません。
コントロールUI:Windowsでツールのトグルが持続しない(v2026.3.2)
Windowsのv2026.3.2では、コントロールUIでツールを切り替えると保存されたように見えますが、ページをリフレッシュすると元に戻ります。
- →コントロールUIでツールをオン/オフ → 保存 → 保存されたように見える
- →ページをリフレッシュ → トグルが前の状態に戻る
- →Windowsのみで発生 — MacとLinuxは影響なし
✅ 修正1 — openclaw.jsonでツール権限を直接設定
# ~/.openclaw/openclaw.jsonを直接編集
{
"tools": {
"profile": "coding",
"deny": ["screen_record", "open_browser"]
}
}✅ 修正2 — ブラウザキャッシュとストレージをクリア
# Chrome/Edgeで: # DevToolsを開く → アプリケーション → ストレージ → サイトデータをクリア # その後コントロールUIをリロード
✅ 修正3 — CLIを使ってツールプロファイルを設定
# openclaw CLIでプロファイルを設定 openclaw config set tools.profile coding openclaw config set tools.deny screen_record # 確認 openclaw config get tools
Issue #35297で追跡中。v2026.3.3での修正が予定されています。根本原因はタブがフォーカスを失うとWindowsのコントロールUIがlocalStorage書き込みを失うことです。