Add OpenClaw bridge runtime and provisioning support

.github/workflows/ci.yml

@@ -12,21 +12,21 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: Checkout
-        uses: actions/checkout@v4
+        uses: actions/checkout@v6
 
       - name: Setup pnpm
-        uses: pnpm/action-setup@v4
+        uses: pnpm/action-setup@v6
         with:
           version: 10.25.0
 
       - name: Setup Node
-        uses: actions/setup-node@v4
+        uses: actions/setup-node@v6
         with:
           node-version: 22
           cache: pnpm
 
       - name: Setup Go
-        uses: actions/setup-go@v5
+        uses: actions/setup-go@v6
         with:
           go-version-file: packages/pickle/native/go.mod
           cache-dependency-path: packages/pickle/native/go.sum
@@ -37,15 +37,15 @@ jobs:
       - name: Typecheck
         run: pnpm typecheck
 
+      - name: Build
+        run: pnpm build
+
       - name: Test
         run: pnpm test
 
       - name: Go test
         run: pnpm test:go
 
-      - name: Build
-        run: pnpm build
-
       - name: Pack packages
         run: pnpm pack:packages
 

.github/workflows/release.yml

@@ -20,24 +20,24 @@ jobs:
       pull-requests: write
     steps:
       - name: Checkout
-        uses: actions/checkout@v4
+        uses: actions/checkout@v6
         with:
           fetch-depth: 0
 
       - name: Setup pnpm
-        uses: pnpm/action-setup@v4
+        uses: pnpm/action-setup@v6
         with:
           version: 10.25.0
 
       - name: Setup Node
-        uses: actions/setup-node@v4
+        uses: actions/setup-node@v6
         with:
           node-version: 24
           registry-url: https://registry.npmjs.org
           cache: pnpm
 
       - name: Setup Go
-        uses: actions/setup-go@v5
+        uses: actions/setup-go@v6
         with:
           go-version-file: packages/pickle/native/go.mod
           cache-dependency-path: packages/pickle/native/go.sum

AGENTS.md

@@ -0,0 +1,40 @@
+# OpenClaw plugin
+
+Use Crabpot for OpenClaw plugin and integration compatibility testing. Crabpot is the OpenClaw compatibility testbed for community plugins, plugin API seams, channel registration, lifecycle hooks, provider capabilities, cold imports, workspace planning, and static execution policy.
+
+Expected sibling checkouts:
+
+```sh
+/Users/batuhan/Projects/pickle
+/Users/batuhan/Projects/crabpot
+/Users/batuhan/Projects/openclaw
+```
+
+If Crabpot is missing, set it up from the Pickle repo with:
+
+```sh
+git clone https://github.com/openclaw/crabpot.git ../crabpot
+npm --prefix ../crabpot install
+npm --prefix ../crabpot test
+```
+
+Crabpot defaults to `../openclaw` for source-mode OpenClaw checks. Clone `https://github.com/openclaw/openclaw.git` there when the checkout is missing, or set `CRABPOT_DIR=/path/to/crabpot` when Crabpot lives elsewhere.
+
+Run the full Pickle and OpenClaw plugin compatibility suite with:
+
+```sh
+npm run full-test
+```
+
+That runs Pickle's existing `pnpm check` first, then `npm run check` in Crabpot through `scripts/openclaw-crabpot-full-test.mjs`.
+
+Useful narrower commands:
+
+```sh
+npm run test:openclaw:plugins
+npm --prefix ../crabpot run check
+npm --prefix ../crabpot run report -- --check
+npm --prefix ../crabpot run workspace:plan
+```
+
+Crabpot default checks are credential-free. Do not run opt-in isolated execution commands unless the task explicitly needs side effects, for example `CRABPOT_EXECUTE_ISOLATED=1 npm --prefix ../crabpot run workspace:execute -- --fixture <fixture>`.

CHANGELOG.md

@@ -7,3 +7,7 @@
 - Node file storage, Cloudflare KV storage, and Durable Object storage helpers.
 - Matrix messages, room threads, reactions, media, DMs, typing, read receipts,
   long polling, and Chat SDK adapter mapping.
+- OpenClaw Beeper channel plugin for exposing OpenClaw agents and sessions over
+  Beeper/Matrix, including setup metadata, appservice registration, agent ghost
+  contacts, command discovery, approval handling, and native Beeper turn
+  streaming.

CONTRIBUTING.md

@@ -17,7 +17,7 @@ Requires Node 22+, pnpm 9+, and a Go toolchain.
 pnpm typecheck
 pnpm test
 pnpm build
-go test ./...   # run from packages/pickle/native
+pnpm test:go    # runs Pickle's Go tests with the goolm build tag
 ```
 
 ## Release
@@ -32,6 +32,11 @@ When changes land on `main`, GitHub Actions opens or updates a release PR.
 Merging that release PR runs the full `pnpm check` gate, publishes changed
 packages with `pnpm changeset publish`, and creates GitHub Releases.
 
+For the initial public release, package manifests already start at `0.1.0`.
+Publish those unpublished `0.1.0` packages directly through the release
+workflow; after that first publish, every user-facing package change should
+carry a normal changeset.
+
 Publishing uses npm Trusted Publishing through GitHub Actions OIDC. Each npm
 package must configure this trusted publisher on npmjs.com: