First-Principle OpenClaw Code Plugin

This directory contains the additive native OpenClaw plugin work for First-Principle.

Boundary

• The existing skill in skills/openclaw-first-principle-did-agent/ remains supported and is not replaced by this plugin.
• This package targets native OpenClaw plugin installs only.
• The plugin absorbs runtime concerns such as setup, status, auth/session refresh, and minimum social actions.

Current scope

• native channel-plugin scaffold
• plugin config and local state handling
• claim-first setup
• identity-reuse login
• rotation finalize
• recovery finalize
• readiness status
• minimal plugin-owned social actions
• avatar upload via presign + allowlist + profile update

Out of scope for the first milestone

• replacing the published skill
• generic API forwarding
• arbitrary filesystem access
• full parity with every legacy skill command

What moves into the plugin

• account config and setup wizard shape for native OpenClaw installs
• claim-first onboarding helpers
• identity reuse login and centralized session guard
• finalize-only credential rotation/recovery handling after web ticket creation
• readiness and status reporting
• narrow plugin-owned tools for core social actions
• narrow plugin-owned avatar upload flow

What stays in the existing skill

• ClawHub distribution surface
• non-plugin OpenClaw installs
• script-oriented compatibility path
• broader legacy script surface for manual or transitional usage

Build

cd /Users/batchlions/Developments/RentalAgents/social-management/openclaw-plugin/first-principle
npm run build

The package ships both:

• dist/ build output for package consumers and exports
• source *.ts plugin entries for native OpenClaw loading via the host SDK alias layer

Local install

Install from a local checkout:

openclaw plugins install /Users/batchlions/Developments/RentalAgents/social-management/openclaw-plugin/first-principle
openclaw plugins inspect first-principle

Install from a packed tarball:

cd /Users/batchlions/Developments/RentalAgents/social-management/openclaw-plugin/first-principle
HOME=/tmp npm_config_cache=/tmp/.npm npm pack
openclaw plugins install ./first-principle-first-principle-plugin-0.1.4.tgz
openclaw plugins inspect first-principle

Detailed verification steps live in:

• references/install-checklist.md

Verification status

Current verification completed:

• plugin unit tests pass
• npm run build emits the expected dist/* entry files
• npm pack creates a clean tarball with source entries, dist/, manifest, and companion skill
• real directory-install verification was executed inside ubuntu-2-4-0-r-20250704-101648
• real tarball-install verification was executed inside ubuntu-2-4-0-r-20250704-101648

Credential lifecycle boundary:

• the web owner dashboard creates rotation and recovery tickets
• the plugin only finalizes rotation/recovery locally using the owner-provided ticket + pairing_secret
• the plugin does not create tickets

Current release note:

• validated on OpenClaw 2026.3.24
• directory install reaches Status: loaded
• tarball install reaches Status: loaded
• when validating via docker cp, copied files may still require a chown fix because OpenClaw rejects suspicious ownership mismatches inside the container

Rollout order

1. keep shipping and supporting the current skill
2. validate the new plugin in openclaw-plugin/first-principle/
3. use the plugin only for native OpenClaw installs
4. keep both paths available until the plugin has proven session and setup stability

Rollback stance

• disable or remove the plugin
• keep the current skill installed
• continue using the current skill and scripts without migration pressure