PicoClaw 構成

関連リポジトリ

インスタンス構成

picoclaw-lepi

• モデル: claude-sonnet-4.6（localhost:4321 copilot-cli プロキシ経由）
• エージェント: main, config-ops, github-ops
• agentFiles: config-ops → picoclaw-config-ops-skill ConfigMap, github-ops → picoclaw-github-ops-skill ConfigMap
• copilotCli: 有効（GitHub Copilot API プロキシ、ポート 4321）
• opencode サイドカー: 有効（ポート 4567）
• launcher: 有効（ポート 18800）
• バインディング: github-ops → Discord ギルド 719207321854541874

picoclaw-home

• モデル: kimi-k2.5（OpenRouter 経由）
• エージェント: main, config-ops
• agentFiles: config-ops → picoclaw-config-ops-skill ConfigMap
• copilotCli: なし
• opencode サイドカー: 有効（ポート 4567）
• launcher: 有効（ポート 18800）
• バインディング: なし

Helm チャート機能（v0.1.12）

agentFiles

エージェントごとのワークスペースディレクトリに AGENT.md 等のファイルをマウントする。チャートが自動で config.json の workspace パスを設定する。

agentFiles:
  <agent-id>:
    configMapName: <ConfigMap名>
    items:
      - key: AGENT.md
        path: AGENT.md

copilotCli

GitHub Copilot API をローカルプロキシする sidecar コンテナ。model_list で api_base: "localhost:4321" を指定して利用。

opencode サイドカー（postRenderers）

Helm チャートの機能ではなく、Flux postRenderers で Deployment にパッチ適用する:

• initContainer fetch-opencode-config: dotnix リポジトリから opencode 設定をクローン → emptyDir にコピー
• sidecar opencode: ghcr.io/turtton/opencode:latest、0.0.0.0:4567 で HTTP サーバー起動
• 環境変数: COPILOT_GITHUB_TOKEN（Secret から取得）、HOME=/root
• picoclaw 側は PICOCLAW_TOOLS_OPENCODE_TASK_ENABLED=true + PICOCLAW_TOOLS_OPENCODE_TASK_SERVER_URL=http://localhost:4567 で接続

securitySecret

.security.yml をマウントしてモデル API キー・Discord トークン等を管理。config.json にマージされ値を上書き。

persistence

Longhorn StorageClass で 5Gi PVC をマウント。エージェントのメモリ（JSONL）やワークスペースデータを永続化。

ファイル構成

clusters/main/apps/picoclaw/
├── AGENTS.md                      # このファイル
├── config-ops-skill.yaml          # config-ops エージェント用 AGENT.md ConfigMap
├── github-ops-skill.yaml          # github-ops エージェント用 AGENT.md ConfigMap
├── helmrelease-home.yaml          # home インスタンス HelmRelease
├── helmrelease-lepi.yaml          # lepi インスタンス HelmRelease
├── home-secrets.sops.yaml         # home 用 Secret（SOPS 暗号化）
├── home-security.sops.yaml        # home 用 security.yml Secret
├── ingress-home.yaml              # home Tailscale Ingress
├── ingress-lepi.yaml              # lepi Tailscale Ingress
├── kustomization.yaml             # Kustomize エントリポイント
├── lepi-copilot-secrets.sops.yaml # lepi copilot-cli 用 Secret
├── lepi-secrets.sops.yaml         # lepi 用 Secret
├── lepi-security.sops.yaml        # lepi 用 security.yml Secret
└── namespace.yaml                 # picoclaw namespace