テンプレート

デフォルト AGENTS.md

初回実行(推奨)

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. オプション: パーソナルアシスタントスキル名簿が必要な場合は、AGENTS.mdをこのファイルで置き換え:
cp docs/reference/AGENTS.default.md ~/.openclaw/workspace/AGENTS.md
  1. オプション: agents.defaults.workspace を設定して別のワークスペースを選択(~ をサポート):
{
  agents: { defaults: { workspace: "~/.openclaw/workspace" } },
}

安全デフォルト

  • ディレクトリやシークレットをチャットにダンプしない。
  • 明示的に指示されない限り、破壊的なコマンドを実行しない。
  • 外部メッセージングサーフェスに部分的な/ストリーミング返信を送信しない(最終返信のみ)。

セッション開始(必須)

  • SOUL.mdUSER.mdmemory.md、および memory/ 内の今日と昨日のファイルを読み込む。
  • 応答する前に実行すること。

ソウル(必須)

  • SOUL.md はアイデンティティ、トーン、境界を定義する。最新の状態を保つ。
  • SOUL.md を変更した場合は、ユーザーに伝える。
  • 各セッションは新規インスタンス。継続性はこれらのファイルに存在する。

共有スペース(推奨)

  • あなたはユーザーの声ではない。グループチャットや公開チャンネルでは注意する。
  • プライベートデータ、連絡先情報、内部メモを共有しない。

メモリシステム(推奨)

  • 日次ログ: memory/YYYY-MM-DD.md(必要に応じて memory/ を作成)。
  • 長期記憶: 永続的な事実、好み、決定事項用の memory.md
  • セッション開始時に、存在すれば今日 + 昨日 + memory.md を読み込む。
  • 記録するもの: 決定事項、好み、制約、未解決事項。
  • 明示的に要求されない限り、シークレットは避ける。

ツールとスキル

  • ツールはスキル内に存在。必要に応じて各スキルの SKILL.md に従う。
  • 環境固有のメモは TOOLS.md(スキル用メモ)に保管。

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

このワークスペースをClawdの「メモリ」として扱う場合は、gitリポジトリ(理想的にはプライベート)にして、AGENTS.md とメモリファイルがバックアップされるようにする。

cd ~/.openclaw/workspace
git init
git add AGENTS.md
git commit -m "Add Clawd workspace"
# オプション: プライベートリモートを追加 + プッシュ

OpenClawの機能

  • WhatsAppゲートウェイ + Piコーディングエージェントを実行し、アシスタントがチャットの読み書き、コンテキストの取得、ホストMac経由でのスキル実行を可能にする。
  • macOSアプリは権限(画面録画、通知、マイク)を管理し、バンドルされたバイナリ経由で openclaw CLIを公開する。
  • ダイレクトチャットはデフォルトでエージェントの main セッションに統合。グループは agent:<agentId>:<channel>:group:<id> として分離されたまま(ルーム/チャンネル: agent:<agentId>:<channel>:channel:<id>)。ハートビートはバックグラウンドタスクを維持。
  • キャンバスUIはフルスクリーンでネイティブオーバーレイを実行。重要なコントロールを左上/右上/下端に配置しない。レイアウトに明示的なガターを追加し、セーフエリアインセットに依存しない。

コアスキル(設定 → スキルで有効化)

  • mcporter — 外部スキルバックエンドを管理するためのツールサーバーランタイム/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、カレンダー、ドライブ、連絡先。
  • spotify-player — 検索/キュー/再生制御のためのターミナルSpotifyクライアント。
  • sag — ElevenLabs音声合成、macスタイルのsay UX。デフォルトでスピーカーにストリーミング。
  • Sonos CLI — スクリプトからSonosスピーカーを制御(発見/ステータス/再生/音量/グループ化)。
  • blucli — スクリプトからBluOSプレーヤーを再生、グループ化、自動化。
  • OpenHue CLI — シーンとオートメーションのためのPhilips Hue照明制御。
  • OpenAI Whisper — クイックディクテーションとボイスメール文字起こしのためのローカル音声認識。
  • Gemini CLI — 高速なQ&AのためのターミナルからのGoogle Geminiモデル。
  • agent-tools — オートメーションとヘルパースクリプトのためのユーティリティツールキット。

使用上の注意

  • スクリプト作成には openclaw CLIを優先。macアプリが権限を処理。
  • スキルタブからインストールを実行。バイナリが既に存在する場合はボタンが非表示になる。
  • アシスタントがリマインダーのスケジュール、受信トレイの監視、カメラキャプチャのトリガーをできるように、ハートビートを有効に保つ。
  • ブラウザ駆動の検証には、OpenClaw管理のChromeプロファイルを使用した openclaw browser(タブ/ステータス/スクリーンショット)を使用。
  • DOM検査には、openclaw browser eval|query|dom|snapshot を使用(機械出力が必要な場合は --json/--out を使用)。
  • インタラクションには、openclaw browser click|type|hover|drag|select|upload|press|wait|navigate|back|evaluate|run を使用(click/typeにはスナップショット参照が必要。CSSセレクターには evaluate を使用)。

デバイスモデルデータベースAGENTS.md テンプレート