# OpenClaw

プロアクティブリコールのためのコンパニオン Skill ガイダンスと ClawHub 上のネイティブメモリプラグインを通じて OpenClaw を接続します。

- Canonical: https://docs.xmemo.dev/ja/docs/connect/openclaw
- Locale: ja-JP
- Content-Locale: ja-JP
- Canonical-Content-Digest: c1ce97e0231b187bac1701fceb894f880bb49f8d6d6dc391398e5decdaf4ff3f
- Edition-Digest: 9268d97ad115308fa5fcbb477c35359e34c840ded827890fd1fb67c4e557f3cd
- Source-Revision: sha256:8f465eb1d6ca0b120934289273aff9d3c032c43de12f628d3bf82b19ef4657b5

## 対象読者と具体的なインターフェース

このガイドでは、OpenClaw エージェントを XMemo 永続メモリに接続します。OpenClaw は 2 層アーキテクチャを通じて動作します。ClawHub 上のネイティブ OpenClaw メモリプラグインがランタイムツールのバインディングを提供し、コンパニオン Skill がプロアクティブリコールガイダンスとセッションチェックポイントを提供します。

## 前提条件

接続する前に、以下のランタイム依存関係とツールが存在することを確認してください：

- OpenClaw エージェントランタイムがインストールされ、動作可能であること。
- ClawHub パッケージアクセスが有効になっていること。
- https://xmemo.dev の有効な XMemo アカウント。
- コンパニオン Skill をインストールする際の Node.js ランタイムバージョン 22.22.0 以上。

## 推奨されるパス：ネイティブプラグインとコンパニオン Skill

推奨されるパスでは、ClawHub からネイティブ OpenClaw メモリプラグインをインストールし、OpenClaw パッケージ管理を通じてコンパニオン Skill を直接インストールします：

```bash
openclaw plugins install clawhub:@xmemo/openclaw-memory
openclaw skills install @xmemo/xmemo
```

## 認証と認証情報のオプション

環境変数または対話型デバイスログインを通じて認証情報を構成します。最初に認証情報ストレージパスを選択せずに bare login を使用しないでください：

- 環境認証情報（推奨）：OpenClaw を起動するシェルまたはサービス環境で XMEMO_KEY を設定します。
- 対話型ログイン：コンパニオン Skill を使用する場合、secret-store XMEMO_KEY が利用できない場合にのみ --allow-plaintext を指定して login を実行します（--allow-plaintext はこのコンピューター上に暗号化されずに認証情報を保存することに注意してください）。
- 認証情報の確認：openclaw plugins list を実行してプラグインのアクティベーションを確認し、コンパニオン Skill で認証ステータスを確認します。

## 代替パス：ヘッドレスサービスランナー

ヘッドレス OpenClaw ランナーまたは自動化された CI パイプラインの場合、対話型プロンプトなしで環境変数を介して XMEMO_KEY をプラグインに直接渡します。

```bash
export XMEMO_KEY='<your-xmemo-token>'
openclaw run --plugin @xmemo/openclaw-memory
```

## 接続確認（読み取り専用）

データを書き込む前に、必ず読み取り専用リクエストで接続を確認してください。このチェックはメモリ状態を変更しません。

- 確認：テスト用 OpenClaw セッションを開始し、既存のプロジェクトコンテキストに対してアクティブリコールクエリを発行します。
- 成功の合図：OpenClaw が、承認されたワークスペースからの有効な Reference および Location フィールドを含む構造化されたメモリ結果を返します。

## 最初の有用なタスク：合成メモリライフサイクル

メモリの永続化、ステートレスなセッション移行、出所帰属付きリコール、および修正を確認します：

- 1. 合成事実の保存：プロジェクト規則 ("Demo project timestamps use UTC.") を "projects/demo-onboarding/conventions" に保存します。
- 2. ステートレス移行：現在の OpenClaw 会話を終了し、新しいセッションを開始します。
- 3. 出所帰属付きリコール："demo project timestamp format" をクエリします。返された Reference と Location を確認します。
- 4. メモリの修正：ISO 8601 書式設定を使用して、記憶された規則を更新します。
- 5. オプションのクリーンアップ：オンボーディング検証が完了したら、デモ規則を論理削除します。

## 機能とメモリワークフロー

OpenClaw ワークフローは、エージェントセッション全体のアクションを成果ごとにグループ化します：

- プロアクティブアクティブリコール：計画を立てる前に、関連する耐久性のあるメモリをアクティブコンテキストに自動的に注入します。
- セッション継続性：再起動スナップショットを保存および復元し、決定事項を追跡し、引き継ぎ全体で TODO を維持します。
- 復元力レイヤー：短命なリコールキャッシュと一時的な書き込み送信トレイにより、短いネットワーク中断を処理します。

## 制限事項と境界

OpenClaw 統合の運用上の制約：

- ワークスペースの分離：すべての操作は、認証されたユーザーのワークスペースに厳格に制限されます。
- ClawHub の可用性：未テストのサードパーティレジストリまたはプラグインの非公式フォークは untested としてマークされます。
- 元帳スコープ：元帳の月次サマリーおよび財務監査ツールには、専用の商用スコープが必要です。

## 復旧、更新、および削除

OpenClaw のトラブルシューティングとメンテナンス手順：

- 復旧（プラグインがロードされない）：openclaw plugins list を実行し、OpenClaw ログで初期化エラーを確認します。
- 復旧（認証期限切れ）：有効な XMEMO_KEY を再エクスポートするか、コンパニオン Skill を通じて再認証します。
- 更新：インストールされているプラグインとスキルを更新するには、OpenClaw のプラグイン管理ドキュメントを参照してください。
- 削除：インストールされているプラグインとスキルを削除または無効にするには、OpenClaw のプラグイン管理ドキュメントを参照してください。

## OpenClaw

Direct client: configure in ~/.openclaw/openclaw.json with XMEMO_KEY in the environment. Run npx @xmemo/client mcp add openclaw to install automatically.

```
{
  "mcpServers": {
    "XMemo": {
      "url": "https://xmemo.dev/mcp",
      "headers": {
        "Authorization": "Bearer ${env:XMEMO_KEY}",
        "X-Memory-OS-Agent-ID": "openclaw",
        "X-Memory-OS-Agent-Instance-ID": "${XMEMO_AGENT_INSTANCE_ID}"
      }
    }
  }
}
```