@firstperson/firstperson 2026.1.36 → 2026.1.37

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@firstperson/firstperson",
-  "version": "2026.1.36",
+  "version": "2026.1.37",
   "type": "module",
   "description": "OpenClaw channel plugin for the First Person iOS app",
   "main": "index.ts",

package/src/channel.ts

@@ -318,7 +318,7 @@ export const firstPersonPlugin: ChannelPlugin<ResolvedFirstPersonAccount> = {
         lastError: null,
       });
 
-      const { startRelayConnection, sendStatusUpdate } = await import("./relay-client.js");
+      const { startRelayConnection, sendStatusUpdate, pushProfileToRelay } = await import("./relay-client.js");
 
       return startRelayConnection({
         relayUrl: account.relayUrl,
@@ -335,6 +335,22 @@ export const firstPersonPlugin: ChannelPlugin<ResolvedFirstPersonAccount> = {
             lastError: null,
           });
           log?.info(`[firstperson:${account.accountId}] relay connected`);
+
+          // Push agent profile to relay on connection
+          const globalRuntime = getFirstPersonRuntime();
+          const identity = (globalRuntime as any).agent?.identity?.get?.();
+          if (identity) {
+            pushProfileToRelay({
+              relayUrl: account.relayUrl,
+              token: account.token!,
+              identity,
+              log,
+            }).catch((err) => {
+              log?.warn(`[firstperson:${account.accountId}] profile push failed: ${err.message}`);
+            });
+          } else {
+            log?.info(`[firstperson:${account.accountId}] no agent identity available, skipping profile push`);
+          }
         },
         onDisconnected: (error) => {
           setStatus({

package/src/relay-client.ts

@@ -1,5 +1,62 @@
 import WebSocket from "ws";
 
+/**
+ * Agent identity from OpenClaw runtime
+ */
+export interface AgentIdentity {
+  agentId: string;
+  name?: string;
+  avatar?: string;
+}
+
+/**
+ * Push the agent's profile to the relay.
+ * Called on startup after relay connection is established.
+ */
+export async function pushProfileToRelay(params: {
+  relayUrl: string;
+  token: string;
+  identity: AgentIdentity;
+  log?: Logger;
+}): Promise<void> {
+  const { relayUrl, token, identity, log } = params;
+
+  // Convert WebSocket URL to HTTP URL for API call
+  const httpUrl = relayUrl.replace(/^wss:\/\//, "https://").replace(/^ws:\/\//, "http://");
+  const profileUrl = `${httpUrl}/api/v1/profile`;
+
+  // Map OpenClaw identity to relay profile format
+  // Only include avatar_url if it's actually an HTTPS URL (relay validates this)
+  const avatarUrl = identity.avatar?.startsWith("https://") ? identity.avatar : "";
+
+  const profile = {
+    name: identity.name ?? identity.agentId,
+    bio: "",
+    avatar_url: avatarUrl,
+  };
+
+  try {
+    const response = await fetch(profileUrl, {
+      method: "PUT",
+      headers: {
+        "Content-Type": "application/json",
+        Authorization: `Bearer ${token}`,
+      },
+      body: JSON.stringify(profile),
+    });
+
+    if (!response.ok) {
+      const errorText = await response.text().catch(() => "unknown error");
+      log?.warn(`[relay-client] Failed to push profile: ${response.status} ${errorText}`);
+      return;
+    }
+
+    log?.info(`[relay-client] Profile pushed to relay: ${profile.name}`);
+  } catch (err) {
+    log?.warn(`[relay-client] Failed to push profile: ${(err as Error).message}`);
+  }
+}
+
 export interface Logger {
   info: (msg: string) => void;
   warn: (msg: string) => void;