@firstperson/firstperson 2026.1.33

package/.claude/settings.local.json

@@ -0,0 +1,16 @@
+{
+  "permissions": {
+    "allow": [
+      "Bash(ls:*)",
+      "Bash(node -e:*)",
+      "Bash(find /Users/andrewgierke/Developer/firstperson-openclaw/node_modules -name \"package.json\" -path \"*zod*\" ! -path \"*/zod/node_modules/*\" -exec sh -c 'echo \"\"=== $1 ===\"\"; cat \"\"$1\"\" | grep '\"''\"'\"\"version\"\"'\"''\"'' _ {} ;)",
+      "Bash(node:*)",
+      "Bash(npm ls:*)",
+      "Bash(npx tsx:*)",
+      "Bash(npm install:*)",
+      "Bash(npm run build:*)",
+      "Bash(npx tsc:*)",
+      "Bash(npm run:*)"
+    ]
+  }
+}

package/CHANGELOG.md

@@ -0,0 +1,28 @@
+# Changelog
+
+## 2026.1.33
+
+- Fix npm package name to `@firstperson/firstperson` (must match plugin ID)
+
+## 2026.1.32
+
+- Fix npm package name to `@firstperson/openclaw`
+
+## 2026.1.31
+
+Initial release of the First Person iOS channel plugin for OpenClaw.
+
+### Features
+
+- WebSocket relay-based communication with First Person iOS app
+- Pairing-first security model with device approval workflow
+- Support for `pairing`, `allowlist`, `open`, and `disabled` DM policies
+- Automatic reconnection with exponential backoff
+- Environment variable support (`FIRSTPERSON_TOKEN`)
+- Full integration with OpenClaw's channel plugin system
+
+### Channel Capabilities
+
+- Direct messages only (no group support)
+- Media support
+- No reactions, threads, or polls

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 First Person Labs
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,81 @@
+# First Person OpenClaw Plugin
+
+Connect your [First Person iOS app](https://apps.apple.com/app/first-person-ai/id123456789) to [OpenClaw](https://openclaw.ai) - your personal AI assistant.
+
+## Quick Start
+
+### 1. Install OpenClaw (if you haven't already)
+
+```bash
+curl -fsSL https://openclaw.ai/install.sh | bash
+openclaw onboard
+```
+
+### 2. Install the First Person plugin
+
+```bash
+openclaw plugins install firstperson
+```
+
+### 3. Download the First Person iOS app
+
+Download from the [App Store](https://apps.apple.com/app/first-person-ai/id123456789) and open the app.
+
+### 4. Connect your app to OpenClaw
+
+In the First Person iOS app:
+1. Go to **Settings** (gear icon)
+2. Tap **OpenClaw Connection**
+3. Copy your **relay token**
+
+Then in your terminal:
+```bash
+openclaw channels add --channel firstperson
+```
+
+Paste your relay token when prompted. The CLI handles all configuration automatically.
+
+### 5. Start the gateway
+
+```bash
+openclaw gateway restart
+```
+
+### 6. Pair your device
+
+1. **Send any message** from the First Person iOS app
+2. **You'll receive a pairing code** in the app
+3. **Approve on your server:**
+   ```bash
+   openclaw pairing approve firstperson <CODE>
+   ```
+4. **Done!** Send another message and your AI will respond.
+
+## How It Works
+
+```
+┌─────────────────┐         ┌─────────────────────┐         ┌─────────────────┐
+│  First Person   │◄───────►│  Cloudflare Relay   │◄───────►│  OpenClaw       │
+│  iOS App        │   WSS   │  chat.firstperson.ai│   WSS   │  Gateway        │
+└─────────────────┘         └─────────────────────┘         └─────────────────┘
+```
+
+Your messages are relayed securely through our Cloudflare Worker. The pairing system ensures only your approved devices can communicate with your AI.
+
+## Troubleshooting
+
+**Not receiving pairing code?**
+```bash
+openclaw channels status --probe
+openclaw logs --follow
+```
+
+**Need to re-pair?**
+```bash
+openclaw pairing list firstperson
+openclaw pairing approve firstperson <CODE>
+```
+
+## License
+
+MIT

package/index.ts

@@ -0,0 +1,18 @@
+import type { OpenClawPluginApi } from "openclaw/plugin-sdk";
+import { emptyPluginConfigSchema } from "openclaw/plugin-sdk";
+
+import { firstPersonPlugin } from "./src/channel.js";
+import { setFirstPersonRuntime } from "./src/runtime.js";
+
+const plugin = {
+  id: "firstperson",
+  name: "First Person",
+  description: "First Person iOS app channel plugin",
+  configSchema: emptyPluginConfigSchema(),
+  register(api: OpenClawPluginApi) {
+    setFirstPersonRuntime(api.runtime);
+    api.registerChannel({ plugin: firstPersonPlugin });
+  },
+};
+
+export default plugin;

package/openclaw.plugin.json

@@ -0,0 +1,9 @@
+{
+  "id": "firstperson",
+  "channels": ["firstperson"],
+  "configSchema": {
+    "type": "object",
+    "additionalProperties": false,
+    "properties": {}
+  }
+}

package/package.json

@@ -0,0 +1,56 @@
+{
+  "name": "@firstperson/firstperson",
+  "version": "2026.1.33",
+  "type": "module",
+  "description": "OpenClaw channel plugin for the First Person iOS app",
+  "main": "index.ts",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/firstperson-labs/firstperson-openclaw.git"
+  },
+  "author": "First Person Labs",
+  "license": "MIT",
+  "keywords": [
+    "openclaw",
+    "firstperson",
+    "ios",
+    "channel",
+    "plugin",
+    "ai-assistant"
+  ],
+  "openclaw": {
+    "extensions": ["./index.ts"],
+    "channel": {
+      "id": "firstperson",
+      "label": "First Person",
+      "selectionLabel": "First Person (iOS)",
+      "docsPath": "/channels/firstperson",
+      "docsLabel": "firstperson",
+      "blurb": "iOS app channel via WebSocket relay.",
+      "order": 80,
+      "quickstartAllowFrom": false
+    },
+    "install": {
+      "npmSpec": "@firstperson/firstperson",
+      "localPath": ".",
+      "defaultChoice": "npm"
+    }
+  },
+  "dependencies": {
+    "ws": "^8.16.0",
+    "zod": "^4.0.0"
+  },
+  "devDependencies": {
+    "@types/ws": "^8.5.10",
+    "openclaw": "*",
+    "typescript": "^5.0.0",
+    "vitest": "^3.0.0"
+  },
+  "peerDependencies": {
+    "openclaw": "*"
+  },
+  "scripts": {
+    "test": "vitest run",
+    "test:watch": "vitest"
+  }
+}