メインコンテンツへスキップ

​
初回実行 (推奨)

OpenClaw エージェントはワークスペースディレクトリを使用します。デフォルト: ~/.openclaw/workspace (agents.defaults.workspace で設定可能、~ をサポート)。
  1. ワークスペースを作成します。
mkdir -p ~/.openclaw/workspace
  1. デフォルトのワークスペーステンプレートをそこへコピーします。
cp docs/reference/templates/AGENTS.md ~/.openclaw/workspace/AGENTS.md
cp docs/reference/templates/SOUL.md ~/.openclaw/workspace/SOUL.md
cp docs/reference/templates/TOOLS.md ~/.openclaw/workspace/TOOLS.md
  1. 任意: 汎用テンプレートの代わりに、このファイルのパーソナルアシスタント向け skill roster を使用します。
cp docs/reference/AGENTS.default.md ~/.openclaw/workspace/AGENTS.md
  1. 任意: 別のワークスペースを指定します。
{
  agents: { defaults: { workspace: "~/.openclaw/workspace" } },
}

​
安全なデフォルト

  • ディレクトリやシークレットをチャットにダンプしないでください。
  • 明示的に依頼されない限り、破壊的なコマンドを実行しないでください。
  • 設定やスケジューラ (crontab、systemd units、nginx configs、shell rc files) を変更する前に、まず既存の状態を調べ、デフォルトでは保持またはマージしてください。
  • 外部メッセージングサーフェスへ部分的な返信やストリーミング返信を送らないでください (最終返信のみ)。

​
既存ソリューションの事前確認

カスタムのシステム、機能、ワークフロー、ツール、インテグレーション、自動化を提案または構築する前に、それを十分に解決しているオープンソースプロジェクト、メンテナンスされているライブラリ、既存の OpenClaw plugins、または無料プラットフォームがないか確認してください。十分であればそれらを優先してください。既存の選択肢が不適切、高すぎる、メンテナンスされていない、安全でない、非準拠である、またはユーザーが明示的にカスタムを求めている場合にのみカスタムで構築してください。ユーザーが明示的に支出を承認しない限り、有料サービスの推奨は避けてください。これは軽量に保ち、調査課題ではなく事前確認のゲートにしてください。

​
セッション開始 (必須)

  • 応答する前に SOUL.md、USER.md、および memory/ 内の今日と昨日を読んでください。
  • 存在する場合は MEMORY.md を読んでください。

​
Soul (必須)

  • SOUL.md はアイデンティティ、トーン、境界を定義します。最新の状態に保ってください。
  • SOUL.md を変更した場合は、ユーザーに伝えてください。
  • 各セッションでは新しいインスタンスです。継続性はこれらのファイルにあります。

​
共有スペース (推奨)

  • あなたはユーザーの声ではありません。グループチャットや公開チャンネルでは注意してください。
  • 個人データ、連絡先情報、内部メモを共有しないでください。

​
メモリシステム (推奨)

  • 日次ログ: memory/YYYY-MM-DD.md (必要なら memory/ を作成)。
  • 長期メモリ: 永続的な事実、好み、決定を記録する MEMORY.md。
  • 小文字の memory.md はレガシー修復入力のみです。意図的に両方のルートファイルを保持しないでください。
  • セッション開始時に、存在する場合は今日 + 昨日 + MEMORY.md を読んでください。
  • メモリファイルに書き込む前に、まずそれらを読んでください。具体的な更新のみを書き、空のプレースホルダーは絶対に書かないでください。
  • 記録対象: 決定、好み、制約、未完了の事項。
  • 明示的に要求されない限り、シークレットは避けてください。

​
ツールとスキル

  • ツールは skills 内にあります。必要なときは各 skill の SKILL.md に従ってください。
  • 環境固有のメモは TOOLS.md に保持してください (skills 向けメモ)。

​
バックアップのヒント (推奨)

このワークスペースをアシスタントのメモリとして扱ってください。AGENTS.md とメモリファイルがバックアップされるよう、git リポジトリ (理想的には private) にしてください。 
cd ~/.openclaw/workspace
git init
git add AGENTS.md
git commit -m "Add workspace"
# Optional: add a private remote + push

​
OpenClaw が行うこと

  • メッセージングチャンネル Gateway (WhatsApp、Telegram、Discord、Signal、iMessage、Slack など) と組み込みエージェントを実行し、アシスタントがチャットの読み書き、コンテキスト取得、ホストマシン経由での skills 実行をできるようにします。
  • macOS アプリは権限 (画面収録、通知、マイク) を管理し、同梱バイナリ経由で openclaw CLI を公開します。
  • ダイレクトチャットはデフォルトでエージェントの main セッションにまとめられます。グループとチャンネル/ルームにはそれぞれ独自のセッションキーが割り当てられます。正確なキー形式については チャンネルルーティング を参照してください。Heartbeats はバックグラウンドタスクを維持します。

​
コア skills (Settings → Skills で有効化)

パーソナルアシスタント用ワークスペースの roster 例です。セットアップに合う skills に入れ替えてください。
  • mcporter - 外部 skill バックエンドを管理するためのツールサーバーランタイム/CLI。
  • Peekaboo - 任意の AI ビジョン分析付きの高速 macOS スクリーンショット。
  • camsnap - RTSP/ONVIF セキュリティカメラからフレーム、クリップ、またはモーションアラートをキャプチャ。
  • oracle - セッションリプレイとブラウザ制御を備えた OpenAI 対応エージェント CLI。
  • eightctl - ターミナルから睡眠を制御。
  • imsg - iMessage と SMS の送信、読み取り、ストリーミング。
  • wacli - WhatsApp CLI: 同期、検索、送信。
  • discord - Discord アクション: リアクション、ステッカー、投票。user:<id> または channel:<id> ターゲットを使用します (数値 id だけでは曖昧です)。
  • gog - Google Suite CLI: Gmail、Calendar、Drive、Contacts。
  • spotify-player - 再生の検索/キュー/制御を行うターミナル Spotify クライアント。
  • sag - mac 風の say UX を備えた ElevenLabs 音声。デフォルトではスピーカーへストリーミングします。
  • Sonos CLI - スクリプトから Sonos スピーカー (検出/ステータス/再生/音量/グルーピング) を制御。
  • blucli - スクリプトから BluOS プレーヤーを再生、グループ化、自動化。
  • OpenHue CLI - シーンと自動化のための Philips Hue 照明制御。
  • OpenAI Whisper - すばやいディクテーションとボイスメール文字起こしのためのローカル音声テキスト化。
  • Gemini CLI - 高速な Q&A のためにターミナルから使う Google Gemini モデル。
  • agent-tools - 自動化とヘルパースクリプト用のユーティリティツールキット。

​
使用上の注意

  • スクリプトには openclaw CLI を優先してください。デスクトップアプリが権限を処理します。
  • インストールは Skills タブから実行してください。必要なバイナリがすでに存在する場合、インストールボタンは非表示になります。
  • アシスタントがリマインダーをスケジュールし、受信箱を監視し、カメラキャプチャをトリガーできるように、heartbeats を有効に保ってください。
  • Canvas UI はネイティブオーバーレイ付きでフルスクリーン実行されます。重要なコントロールを左上/右上/下端に配置するのは避けてください。safe-area insets に頼る代わりに、明示的なレイアウト余白を追加してください。
  • ブラウザ駆動の検証には、OpenClaw 管理の Chrome/Brave/Edge/Chromium プロファイルで openclaw browser CLI (同梱の browser plugin) を使用してください。
  • 管理: status、doctor [--deep]、start [--headless]、stop、tabs、tab [new|select|close]、open <url>、focus <id>、close <id>。
  • 検査: screenshot [--full-page|--ref|--labels]、snapshot [--format ai|aria|--interactive|--efficient]、console、errors、requests、pdf、responsebody。
  • 操作: navigate、click <ref>、type <ref> <text>、press、hover、drag、select、upload、download、fill、dialog、wait、evaluate --fn <js>、highlight。アクションには snapshot からの ref が必要です (CSS セレクターはアクションでは受け付けられません)。document.querySelector 形式のターゲティングが必要な場合は evaluate を使用してください。
  • どの検査コマンドでも、機械可読な出力には --json を追加してください。

​
関連