痛み：忘れたのはモデルではなく、システム側の参照設計です
口頭ランブック化。 手順がチャットに散らばると毎回再発明され、版管理真実と衝突します。
長スレッドのドリフト。 CONTEXT が無いと要約が境界を落とし、無記憶に見えます。多くはコンテキスト設計の問題です。
JSON 変更が見えない。 探索やトランスポートはキャッシュされます。古い子プロセスが新設定を隠します。
静かなチャネル。 先に ペアリング を疑い、Skills 調整は後段です。
Skills と権限の混同。 Skills は意図、workspaceAccess が現実の読み書きです。
検索とスポーン。 web_search の外向きと、allowAgents 乱用はコストとドリフトを増やします。
運用品質。 前提 PATH、多言語混在、リンク腐敗、遅い共有マウント、レビュー無しの形だけ導入が続発します。
最小権限ガイドの先に Skills と CONTEXT が足すもの
最小権限はディレクトリを決め、Skills は壁の内側の語彙と順序を決め、CONTEXT は短い安定事実と承認 URL を運びます。
探索は監査可能にし、公開面と同じレビュー文化へ載せます。CONTEXT ハッシュはイメージと同時にロールバックします。
教育は当たり外れのデモ、セキュリティは Skills と workspace を同一チケットで見ます。モデル更新時はツール名依存を回帰し、演習で壊して戻す筋肉記憶を作ります。
測れる基準
CONTEXT 再質問率、Skill 失敗分類、再起動とチケットの対応、初回応答遅延、HITL 率、四半期サンプル監査、スキャン CPU、skill-not-found とデプロイ相関、復旧時間、良事例ログを束ねます。
トーン整合で要約ズレを減らし、探索コストが線形なら glob 深さを疑います。
判断表
| モード | 向く場面 | 利点 | リスク |
|---|---|---|---|
| 巨大システムプロンプト | 単独実験 | 手早い | レビュー不能なドリフト |
| Skills のみ | ツール偏重ボット | 探索しやすい | 境界テキストが弱い |
| Skills 足す CONTEXT | チーム本番 | 版管理された明瞭さ | 規約整備が要る |
| doctor 階段まで三重化 | 常時リモート Mac | 再現性の高い運用 | Runbook が厚い |
デフォルト行を一つ決め、接頭辞で環境を分け、インシデント不足は Skill と票で閉じます。予算圧で止めると陳腐指示が増幅します。
手順と JSON 骨格の例
{
"workspaceAccess": { "root": "/var/openclaw/work/acme" },
"skills": {
"searchPaths": ["/var/openclaw/skills/team", "/var/openclaw/skills/shared"],
"manifest": "/var/openclaw/skills/manifest.json"
},
"contextFiles": [
"/var/openclaw/context/PROJECT.md",
"/var/openclaw/context/BOUNDARIES.md"
]
}
キー名は変わり得るため構造例です。(1) ディレクトリをテンプレ化 (2) ステージングで openclaw doctor (3) コールド再起動後にツール一覧 (4) 許可／禁止の合成会話 (5) rsync／SFTP でリモート Mac へ複製 (6) CI でマニフェスト検証 (7) 読み取り専用ミラー (8) カナリア CONTEXT (9) 実験 Skills はフラグ (10) 退役は日付付きアーカイブ。ロールバック演習とテナント別 CONTEXT を徹底し、秘密は本文に書かずボールト参照にします。
読む順番
doctor→MCP→本稿→workspaceAccess→web_search→HITL→逆プロキシ→ホーム。リリース一行にマニフェスト・CONTEXT ハッシュ・イメージタグ。複数ゲートウェイは昇格自動化、名簿で承認者を固定、CI で秘密パターン禁止、署名 tarball、ロケール分割で肥大を防ぎます。
FAQ とホスト型リモート Mac の価値
Skills はコードレビューを置き換えますか
いいえ。実行時の案内であり、権威あるロジックはリポジトリとパイプラインに残します。
複数ゲートウェイを揃えるには
タグ付きスナップショットと不変ディレクトリを使い、ホスト差分を作らないことです。
CONTEXT はアプリ repo に置くべきか
製品事実は同一 repo が多いですが、運用ガードはアクセスの厳しい ops repo に分ける選択もあります。
埋め込みは CONTEXT を不要にしますか
検索を補いますが、レビュー済みの正典テキストは依然として必要です。両方の版を揃えます。
要約： Skills と CONTEXT はチャットの一時性を、doctor と整合する版管理資産へ運びます。
限界： 自前 Mac ではディスク・権限・複製を自前で持ちます。SFTPMAC ホスト型は稼働と衛生を束ね、Skills 執筆に集中させます。macOS／Xcode 前提を CONTEXT に明記し、睡眠ノート PC を避け、Skill 名メタデータの保持はセキュリティと合意します。
小さな差分で信頼性と短いレビューを両立し、監査の学びは Skill 差分と CONTEXT 注記へ残します。Skills・CONTEXT・成果物の同期木ほどホスト型が効きます。
ゲートウェイリリースと同じ拍で CONTEXT と Skills を版管理するほど、ホスト型ノードでの強制が楽になります。