Skip to content
Apothem
ハーネスアダプター

Open-Claw

Open-Claw(プレビュー)向けの Apothem ハーネスアダプター。

ベンダー: Open-Claw インストール名: open-claw ステータス: プレビュー ネイティブ設定: ~/.openclaw/openclaw.json

インストール

apothem install --harness open-claw

アダプターは OpenClaw のユーザーグローバル設定ファイルを書き込み、共有プロファイルをプロファイルドキュメントへ投影し、Apothem のサポートコホートをハーネスルート配下にインストールします。 OpenClaw のネイティブ設定は JSON であり、マテリアライザーは 1 つのキー skills.load.extraDirs をレンダリングし、既存のファイルはその他のキーを保持します。

書き込まれるファイル: ~/.openclaw/openclaw.json、プロファイルドキュメント ~/.openclaw/apothem/rules/00-apothem-profile.md、および ~/.openclaw/.apothem/support/ 配下のサポートファイル

プロファイルドキュメントは Apothem サポートファイルのセクションで終わります。 このセクションは、リポジトリ形式の各参照(rules/<name>.md、templates/...、hooks/...)が解決される先の、~/.openclaw/.apothem/support/ 配下の絶対ディレクトリを示します。

プロファイルからネイティブ設定へのマッピング

アダプターは 1 つの設定キーを作成します。 OpenClaw が読む追加のスキルディレクトリのリストである skills.load.extraDirs に ~/.openclaw/.apothem/support/skills を追加します。これにより OpenClaw はインストールされたスキルを見つけます。 このエントリーは、あなたがすでに列挙しているエントリーの後に置かれ、あなたの他のキーはそのまま残ります。 プロファイルのアイデンティティ、プリファレンス、ルールはプロファイルドキュメントに入ります。 共有のコマンド、スキル、ルール、テンプレート、フックプロンプトは、~/.openclaw/.apothem/support/ 配下にサポート素材としてインストールされます。

互換性に関する注意

プレビュー版のアダプターです。OpenClaw は skills.load.extraDirs を通じて Apothem のスキルを読み込みますが、サポートツリーの残りの部分もプロファイルドキュメントも自力では読み込みません。ワークスペースの命令ファイルも設定もそこを指していないため、インストール後の OpenClaw は Apothem のルールと MCP サーバーなしで動作します。

名前の衝突。 OpenClaw は次のソースからスキルを読み込み(優先順位の高い順)、同じスキル名が複数の場所に現れた場合は最も優先順位の高いソースが勝ちます:ワークスペースの skills/ フォルダー、ワークスペースの .agents/skills/ フォルダー、~/.agents/skills(デフォルトの状態ディレクトリの場合のみ)、状態ディレクトリの skills/ フォルダー(デフォルトでは ~/.openclaw/skills)、ワークショップのスキル、同梱スキルとカストディアンスキル、そして最後に skills.load.extraDirs 配下に列挙されたフォルダーとプラグインのスキルです。Apothem のディレクトリは extraDirs のエントリーなので、それより前のいずれかのソースにあなたが置いている同じ名前のスキルが OpenClaw に使われ、そのスキルの Apothem のコピーはディスク上で使われないままになります。Apothem は openclaw.json と ~/.openclaw/.apothem/support/ 配下にのみ書き込み、それより前のフォルダーには決して書き込まないため、インストール、更新、アンインストールが、あなたがそこに置いているスキルを置き換えることはありません。

agents.defaults.skills はスキル名の許可リストです。Apothem はこれを編集しないため、許可リストを使っている場合は、使いたい Apothem のスキルがそこに記載されているか確認してください。apothem update は、openclaw.json に追加したキーを保持します。MCP サーバーは OpenClaw 設定の mcp.servers ブロックに置かれ、openclaw mcp add と関連するサブコマンドで管理します。アダプターはそこにエントリを一切書き込みません。(OpenClaw の振る舞いは、スキル、スキル設定、設定拡張 のドキュメント(2026-10-24 に確認)、および MCP CLI のドキュメント(2026-10-02 に確認)に基づきます。)

openclaw.json 内のコメント。 OpenClaw は設定を JSON5 として読み、Apothem はファイルをプレーンな JSON として書き直します。ファイルにコメントやその他の JSON5 構文が含まれていてエントリーがない場合、Apothem はファイルに手を付けず、インストールはそのキーを挙げるメッセージを出して停止します。このエントリーを自分でファイルにマージするか、ファイルをプレーンな JSON に変換してから、再度インストールを実行してください。

{
  "skills": {
    "load": {
      "extraDirs": ["~/.openclaw/.apothem/support/skills"]
    }
  }
}

あなたが自分で追加したエントリーはあなたのものとみなされます。アンインストールはそれをそのまま残します。

検証

apothem verify --harness open-claw

verify コマンドは次のことを確認します。

  1. ネイティブ設定が想定されたパスに存在すること。
  2. 管理対象の各ターゲットが存在すること。管理対象のファイルは空ではなく、JSON または YAML の設定は解析できること。--profile PATH を追加すると、インストールされたファイルがそのプロファイルと一致することも確認します。
  3. ネイティブ設定の skills.load.extraDirs に ~/.openclaw/.apothem/support/skills が記載されていること。そのエントリーがないと OpenClaw はインストールされたスキルを読み込みません。apothem update がそれを再び追加します。
  4. アダプター固有の検証ルーチンが成功を報告すること。

更新

apothem update --harness open-claw

現在の共有プロファイルの状態からプロファイルドキュメントを再導出し、サポートファイルを更新します。openclaw.json は、すでに持っているキーを保持し、skills.load.extraDirs 内の Apothem のエントリーは、何度更新しても 1 回だけ記載されたままです。 ~/.config/apothem/profile.yaml を編集した後、またはインストール済みの Apothem パッケージをアップグレードした後に実行してください。

アンインストール

apothem uninstall --harness open-claw

アダプターが追加したもの、つまり skills.load.extraDirs 内のそのエントリー、プロファイルドキュメント、サポートツリーを削除します。 openclaw.json 内のあなた自身のキーは、あなた自身の extraDirs のエントリーを含めて残り、このファイルは、Apothem が作成したものであり、かつあなたのものが何も残っていない場合にのみ削除されます。 共有プロファイルの YAML と Apothem エンジンには影響しません。

コンフォーミティゲート

python -m apothem.conformity.gate --all .

トラブルシューティング

症状対処
設定ファイルが見つからないapothem install --harness open-claw を再実行する
検証が失敗したapothem update --harness open-claw を実行してから、再度検証する
想定外の設定内容Apothem は openclaw.json に skills.load.extraDirs のエントリーだけを作成し、既存のキーを保持する。そのため、プロファイルの内容はそこには入らない。プロファイルの内容は ~/.openclaw/apothem/rules/00-apothem-profile.md に入る。~/.config/apothem/profile.yaml または --profile PATH を確認し、そのうえで 更新 の手順にあるコマンドを再実行する
インストールが、openclaw.json 内のコメントや JSON5 構文に関するメッセージを出して停止するApothem は、コメントを取り除かなければならないファイルを書き直さない。互換性に関する注意 に示した skills.load.extraDirs のエントリーを自分で追加するか、ファイルをプレーンな JSON に変換してから、再度インストールを実行する
Apothem のスキルが OpenClaw に表示されないワークスペース、~/.agents/skills、または ~/.openclaw/skills にある同じ名前のスキルが、Apothem のコピーより優先される(互換性に関する注意 を参照)。また、apothem verify --harness open-claw を実行し、使っている agents.defaults.skills 許可リストがあればそのスキルが記載されているか確認する

設定ノブ

フラグデフォルト説明
--dry-runfalseファイルを書き込まずにインストールをプレビューする。

関連項目

On this page