AGENTS.md — OpenClaw パーソナルアシスタント（デフォルト）

初回実行（推奨）

OpenClaw は、エージェント専用のワークスペースディレクトリを使用します。デフォルト：~/.openclaw/workspace（agents.defaults.workspace で設定可能）。

  • ワークスペースを作成（まだ存在しない場合）：
mkdir -p ~/.openclaw/workspace
  • デフォルトのワークスペーステンプレートをワークスペースにコピー：
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
  • オプション：パーソナルアシスタントのスキルリストが必要な場合は、AGENTS.md をこのファイルで置き換えてください：
cp docs/reference/AGENTS.default.md ~/.openclaw/workspace/AGENTS.md
  • オプション：agents.defaults.workspace を設定して別のワークスペースを選択（~ をサポート）：
{
  "agents": { "defaults": { "workspace": "~/.openclaw/workspace" } }
}

安全デフォルト

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

セッション開始（必須）

  • SOUL.md、USER.md、memory.md、および memory/ 内の今日+昨日を読んでください。
  • 応答する前に実行してください。

Soul（必須）

  • 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 を公開します。
  • 直接チャットはデフォルトでエージェントのメインセッションに統合されます。グループは agent:::group:<id> として分離されたままです。ルーム/チャネル：agent:::channel:<id>。ハートビートはバックグラウンドタスクを維持します。

コアスキル（設定 → スキルで有効化）

  • mcporter — 外部スキルバックエンドを管理するためのツールサーバーランタイム/CLI。
  • Peekaboo — オプションの AI ビジョン分析付き高速 macOS スクリーンショット。
  • camsnap — RTSP/ONVIF セキュリティカメラからフレーム、クリップ、またはモーション警告をキャプチャ。
  • oracle — セッションリプレイとブラウザ制御を備えた OpenAI 対応エージェント CLI。
  • eightctl — ターミナルから睡眠を制御。
  • imsg — iMessage と SMS の送信、読み取り、ストリーミング。
  • wacli — WhatsApp CLI：同期、検索、送信。
  • discord — Discord アクション：リアクション、ステッカー、投票。user: または channel: ターゲットを使用（素の数値 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 — ターミナルから Google Gemini モデルを使用して迅速な Q&A。
  • bird — ブラウザなしでツイート、返信、スレッドの読み取り、検索を行う X/Twitter CLI。
  • agent-tools — 自動化とヘルパースクリプトのためのユーティリティツールキット。

使用上の注意

  • スクリプトには openclaw CLI を優先してください。mac アプリは権限を処理します。
  • スキルタブからインストールを実行します。バイナリがすでに存在する場合はボタンを非表示にします。
  • アシスタントがリマインダーをスケジュール、受信トレイを監視、カメラキャプチャをトリガーできるように、ハートビートを有効にしておいてください。
  • Canvas UI はネイティブオーバーレイで全画面表示されます。左上/右上/下端に重要なコントロールを配置しないでください。レイアウトに明示的なガターを追加し、セーフエリアインセットに依存しないでください。
  • ブラウザ駆動の検証には、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 にはスナップショット ref が必要。CSS セレクタには evaluate を使用）。
← ドキュメントに戻る