feat(memos-local-openclaw): add multi-OpenClaw sharing, dual-instance isolation, and viewer improvements (#1321)

## Description

This PR brings the `native_memos` branch into `main` with a major
upgrade to the `memos-local-openclaw` plugin, focused on team sharing,
dual-instance isolation, viewer usability, recall quality, and
documentation completeness.

It solves several practical issues that appeared during real-world local
OpenClaw usage, especially when running multiple instances on the same
machine:
- team sharing state transitions were fragile across
join/leave/role-switch flows
- Hub/Viewer ports and session state could conflict in dual-instance
setups
- admin and member notifications were incomplete or unclear
- Viewer polling and sharing UX had refresh/state consistency issues
- documentation and landing pages did not fully explain the Hub/Client
architecture, multi-instance deployment, and collaboration workflow

Implementation approach:
- added and hardened the Hub/Client sharing architecture, including Hub
auth, client connector flow, server-side status management, admin
operations, and notification handling
- improved dual-instance isolation by refining runtime/config behavior
around gateway-derived ports, sharing state cleanup, and local-vs-hub
behavior boundaries
- enhanced recall quality with origin tracking, Hub result filtering,
and local/hybrid search improvements
- improved Viewer UX and stability across sharing setup, admin
workflows, polling, notifications, and collaboration-related UI
- added and updated automated test coverage for hub server, viewer
sharing, connector logic, storage, integration, and skill runtime flows
- expanded README, Team Sharing guide, docs site, troubleshooting docs,
and landing pages to better document collaboration workflows and
multi-OpenClaw capabilities

Relevant dependencies / requirements:
- no new mandatory external product dependency for end users beyond
existing model/provider configuration
- local runtime still depends on `better-sqlite3` native bindings being
built for the active Node.js version
- optional telemetry and model-provider related configuration continue
to follow the existing plugin setup

Related Issue (Required): Fixes #1320

## Type of change

- [x] Bug fix (non-breaking change which fixes an issue)
- [x] New feature (non-breaking change which adds functionality)
- [x] Breaking change (fix or feature that would cause existing
functionality to not work as expected)
- [x] Refactor (does not change functionality, e.g. code style
improvements, linting)
- [x] Documentation update

## How Has This Been Tested?

The change was validated through a combination of targeted automated
coverage added in this branch and manual end-to-end verification of
multi-instance local OpenClaw scenarios.

Test areas covered in this branch include:
- Hub server and authentication behavior
- viewer sharing flows and config handling
- client connector and sharing state transitions
- storage and integration flows
- skill runtime and sharing-related scenarios

Manual reproduction / verification steps:
1. Start two local OpenClaw instances with isolated
`OPENCLAW_CONFIG_PATH`, `OPENCLAW_STATE_DIR`, and workspace directories.
2. Install and enable `memos-local-openclaw` in both instances.
3. Configure one instance as Hub and another as Client.
4. Verify gateway, viewer, and Hub startup behavior, including port
isolation and no cross-instance conflict.
5. Submit a join request from the Client, approve it from the Hub, and
verify status updates and notifications.
6. Test admin operations including promote, demote, remove member, and
self-removal prevention.
7. Test client leave / disable / role-switch behavior and verify state
cleanup and reconnect behavior.
8. Verify Viewer live updates do not cause unnecessary full refreshes or
scroll-position loss.
9. Open the updated docs / landing pages and confirm installation
instructions, Team Sharing content, and collaboration visuals are
displayed correctly.

Suggested test environment:
- OS: macOS
- Runtime: local OpenClaw dual-instance setup
- Plugin: `memos-local-openclaw`
- Database: SQLite / `better-sqlite3`

- [ ] Unit Test
- [x] Test Script Or Test Steps (please provide)
- [ ] Pipeline Automated API Test (please provide)

## Checklist

- [x] I have performed a self-review of my own code | 我已自行检查了自己的代码
- [x] I have commented my code in hard-to-understand areas |
我已在难以理解的地方对代码进行了注释
- [x] I have added tests that prove my fix is effective or that my
feature works | 我已添加测试以证明我的修复有效或功能正常
- [x] I have created related documentation issue/PR in
[MemOS-Docs](https://github.com/MemTensor/MemOS-Docs) (if applicable) |
我已在 [MemOS-Docs](https://github.com/MemTensor/MemOS-Docs) 中创建了相关的文档
issue/PR（如果适用）
- [x] I have linked the issue to this PR (if applicable) | 我已将 issue
链接到此 PR（如果适用）
- [x] I have mentioned the person who will review this PR | 我已提及将审查此 PR
的人

## Reviewer Checklist
- [x] closes #1320 
- [x] Made sure Checks passed
- [x] Tests have been provided

Author: CaralHsi

.github/workflows/openclaw-plugin-publish.yml

@@ -25,7 +25,7 @@ jobs:
         include:
           - os: macos-14
             platform: darwin-arm64
-          - os: macos-13
+          - os: macos-15
             platform: darwin-x64
           - os: ubuntu-latest
             platform: linux-x64
@@ -42,6 +42,11 @@ jobs:
       - name: Install dependencies
         run: npm install
 
+      - name: Rebuild for x64 under Rosetta (darwin-x64 only)
+        if: matrix.platform == 'darwin-x64'
+        run: |
+          arch -x86_64 npm rebuild better-sqlite3
+
       - name: Collect prebuild
         shell: bash
         run: |
@@ -87,6 +92,13 @@ jobs:
       - name: Install dependencies (skip native build)
         run: npm install --ignore-scripts
 
+      - name: Generate telemetry credentials
+        run: node scripts/generate-telemetry-credentials.cjs
+        env:
+          MEMOS_ARMS_ENDPOINT: ${{ secrets.MEMOS_ARMS_ENDPOINT }}
+          MEMOS_ARMS_PID: ${{ secrets.MEMOS_ARMS_PID }}
+          MEMOS_ARMS_ENV: ${{ secrets.MEMOS_ARMS_ENV }}
+
       - name: Bump version
         run: npm version ${{ inputs.version }} --no-git-tag-version
 

apps/memos-local-openclaw/.env.example

@@ -23,3 +23,10 @@ SUMMARIZER_TEMPERATURE=0
 # No memory content, queries, or personal data is ever sent — only tool names, latencies, and version info.
 # Enabled by default. Set to false to opt-out.
 # TELEMETRY_ENABLED=false
+#
+# Telemetry backend credentials (for maintainers / CI only).
+# End users do NOT need to set these — they are bundled into the npm package at publish time.
+# If not set and telemetry.credentials.json is absent, telemetry is silently disabled.
+# MEMOS_ARMS_ENDPOINT=https://your-arms-endpoint.log.aliyuncs.com/rum/web/v2?workspace=...&service_id=...
+# MEMOS_ARMS_PID=your-arms-pid
+# MEMOS_ARMS_ENV=prod

apps/memos-local-openclaw/.gitignore

@@ -3,6 +3,12 @@ dist/
 *.tsbuildinfo
 .env
 
+# Compiled output (root level only)
+/*.js
+/*.js.map
+/*.d.ts
+/*.d.ts.map
+
 # OS files
 .DS_Store
 Thumbs.db
@@ -19,7 +25,11 @@ ppt/
 # Prebuilt native binaries (included in npm package via `files`, not in git)
 prebuilds/
 
+# Telemetry credentials (generated by CI, not committed to git)
+telemetry.credentials.json
+
 # Database files
 *.sqlite
 *.sqlite-journal
 *.db
+/~/.openclaw/