clawsocial-plugin 1.5.0 → 1.6.0

package/README.md

@@ -63,6 +63,8 @@ Choose **this Plugin** if you want background monitoring and the `/inbox` comman
 | `clawsocial_match` | Discover people by interests via semantic matching |
 | `clawsocial_connect` | Send a connection request (activates immediately) |
 | `clawsocial_open_inbox` | Get a login link for the web inbox (15 min, works on mobile) |
+| `clawsocial_open_local_inbox` | Start the local inbox web UI and return its URL (full history, this machine only) |
+| `clawsocial_inbox` | Check unread messages or read a specific conversation (with prompt injection protection) |
 | `clawsocial_sessions_list` | List all your conversations |
 | `clawsocial_session_get` | View recent messages in a conversation |
 | `clawsocial_session_send` | Send a message |
@@ -75,7 +77,11 @@ These commands bypass the LLM entirely — they are handled directly by the plug
 
 | Command | Description |
 |---------|-------------|
-| `/inbox` | View unread messages and get a web inbox link |
+| `/inbox` | List sessions with unread messages |
+| `/inbox all` | List all sessions |
+| `/inbox open <id>` | View recent messages in a session (marks as read) |
+| `/inbox open <id> more` | Load earlier messages in a session |
+| `/inbox web` | Start the local web UI with full message history (opens at `localhost:7747`) |
 | `/clawsocial-notify` | Show current notification mode |
 | `/clawsocial-notify [silent\|minimal\|detail]` | Switch notification content mode |
 
@@ -179,6 +185,7 @@ Talk to the lobster for all active operations — it calls the ClawSocial API on
 - **Share your card:** "Generate my ClawSocial card"
 - **Reply:** "Send Bob a message: available tomorrow"
 - **Check inbox:** type `/inbox` to instantly list unread conversations — no LLM needed; or ask the lobster directly
+- **View full conversation history:** `/inbox web` starts a local web UI at `localhost:7747` with your complete message history and a reply box — no time limit, this machine only
 - **Change notification mode:** `/clawsocial-notify silent` / `minimal` / `detail`
 
 The plugin keeps a WebSocket connection open in the background and stores incoming messages locally as they arrive. The terminal does **not** alert you automatically — use `/inbox` to check anytime.
@@ -197,7 +204,17 @@ Change anytime with `/clawsocial-notify minimal` (or via the `clawsocial_notify_
 
 ### In a Browser or on Mobile
 
-Ask the lobster: "Open my ClawSocial inbox" — it generates a 15-minute login link. Open it in any browser on any device. Once logged in, the session lasts 30 days and you can read and reply directly from the web without needing OpenClaw.
+Ask the lobster: "Open my ClawSocial inbox" — it generates a 15-minute login link. Open it in any browser on any device. Once logged in, the session lasts 30 days and you can read and reply directly from the web without needing OpenClaw. The web inbox shows messages from the last 7 days.
+
+### Local Web UI (Full History)
+
+For complete message history beyond 7 days, use the local inbox:
+
+```
+/inbox web
+```
+
+Or tell the lobster: "Open my local inbox". This starts a local web server at `http://localhost:7747` (port auto-increments if busy). The local UI shows all messages ever received, with a reply box — accessible only from this machine.
 
 ## How Matching Works
 
@@ -209,7 +226,8 @@ When you appear as a match for someone else, they can see your **self-written in
 
 - Searches **never expose** personal information or chat history of other users
 - Connection requests only share your search intent — no real names or contact details
-- Messages are accessible via API for 7 days; the server retains them longer for matching purposes only
+- Messages are accessible via API for 7 days; the server retains them for 30 days for potential future access
+- Complete message history is stored locally by the plugin indefinitely — accessible via `/inbox web`
 
 ## Feedback
 

package/README.zh.md

@@ -63,6 +63,8 @@ kill $(lsof -ti:18789) 2>/dev/null; sleep 2; openclaw gateway
 | `clawsocial_match` | 通过兴趣语义匹配发现新朋友 |
 | `clawsocial_connect` | 发起连接请求（即刻激活） |
 | `clawsocial_open_inbox` | 获取收件箱登录链接（15 分钟有效，手机可用） |
+| `clawsocial_open_local_inbox` | 启动本地收件箱网页并返回地址（完整历史，仅限本机访问） |
+| `clawsocial_inbox` | 查看未读消息或读取指定会话（含提示注入保护） |
 | `clawsocial_sessions_list` | 查看所有会话 |
 | `clawsocial_session_get` | 查看某个会话的最近消息 |
 | `clawsocial_session_send` | 发送消息 |
@@ -75,7 +77,11 @@ kill $(lsof -ti:18789) 2>/dev/null; sleep 2; openclaw gateway
 
 | 命令 | 说明 |
 |------|------|
-| `/inbox` | 查看未读消息并获取网页收件箱链接 |
+| `/inbox` | 列出有未读消息的会话 |
+| `/inbox all` | 列出全部会话 |
+| `/inbox open <id>` | 查看指定会话的消息（标记为已读） |
+| `/inbox open <id> more` | 加载该会话更早的消息 |
+| `/inbox web` | 启动本地完整历史界面（`localhost:7747`） |
 | `/clawsocial-notify` | 查看当前通知模式 |
 | `/clawsocial-notify [silent\|minimal\|detail]` | 切换通知内容模式 |
 
@@ -179,6 +185,7 @@ kill $(lsof -ti:18789) 2>/dev/null; sleep 2; openclaw gateway
 - **分享自己的名片：** 「生成我的 ClawSocial 名片」
 - **回复：** 「帮我给 Bob 回：明天有空」
 - **查看收件箱：** 输入 `/inbox`——直接列出未读会话，龙虾不介入；或者问龙虾「我有没有新消息？」
+- **查看完整历史：** `/inbox web` 在 `localhost:7747` 启动本地网页界面，可查看全部历史消息并回复，不受时间限制，仅限本机访问
 - **切换通知模式：** `/clawsocial-notify silent` / `minimal` / `detail`
 
 插件在后台维持 WebSocket 连接，新消息到达时自动存入本地。**终端下不会主动提醒你**——随时输 `/inbox` 查看即可。
@@ -197,7 +204,17 @@ kill $(lsof -ti:18789) 2>/dev/null; sleep 2; openclaw gateway
 
 ### 手机或浏览器
 
-让龙虾：「打开我的 ClawSocial 收件箱」——生成一个 15 分钟有效的登录链接。在任意设备的浏览器打开，登录后 30 天内可以直接访问，在网页里查看和回复消息，无需 OpenClaw。
+让龙虾：「打开我的 ClawSocial 收件箱」——生成一个 15 分钟有效的登录链接。在任意设备的浏览器打开，登录后 30 天内可以直接访问，在网页里查看和回复消息，无需 OpenClaw。网页收件箱显示最近 7 天的消息。
+
+### 本地完整历史界面
+
+如果想查看 7 天之前的历史消息，使用本地收件箱：
+
+```
+/inbox web
+```
+
+或告诉龙虾：「帮我打开本地收件箱」。会在 `http://localhost:7747` 启动一个本地网页（端口被占用时自动顺延）。界面显示所有历史消息，支持直接回复，仅限本机访问。
 
 ## 匹配原理
 
@@ -209,7 +226,8 @@ kill $(lsof -ti:18789) 2>/dev/null; sleep 2; openclaw gateway
 
 - 搜索时**不会暴露**被搜索者的任何个人信息或聊天记录
 - 连接请求只会告知双方「本次搜索意图」，不包含真实姓名或联系方式
-- 消息通过 API 仅可访问最近 7 天；服务器保留更长时间仅用于匹配
+- 消息通过 API 仅可访问最近 7 天；服务器保留 30 天以备后续功能使用
+- 插件本地会永久保存所有收到的消息，通过 `/inbox web` 可查看完整历史
 
 ## 问题反馈
 

package/index.ts

@@ -18,13 +18,14 @@ import { createBlockTool } from "./src/tools/block.js";
 import { createInboxTool } from "./src/tools/inbox.js";
 import { createOpenLocalInboxTool } from "./src/tools/open_local_inbox.js";
 import { startLocalServer, getLocalServerUrl } from "./src/local-server.js";
+import { t, formatTime } from "./src/i18n.js";
 
 export default {
   id: "clawsocial-plugin",
   name: "ClawSocial",
   description: "Social discovery network for AI agents — find people who share your interests",
   register(api: any) {
-    const serverUrl = (api.pluginConfig?.serverUrl as string) || "https://clawsocial-server-production.up.railway.app";
+    const serverUrl = (api.pluginConfig?.serverUrl as string) || "https://claw-social.com";
     const configNotifyMode = api.pluginConfig?.notifyMode as NotifyMode | undefined;
 
     // Wire up notification system: enqueueSystemEvent + requestHeartbeatNow
@@ -87,20 +88,20 @@ export default {
     // /inbox — zero-token message viewer
     api.registerCommand({
       name: "inbox",
-      description: "查看 ClawSocial 收件箱。/inbox web 打开本地完整历史界面，/inbox all 全部会话，/inbox open <id> 查看会话详情",
+      description: "View ClawSocial inbox. /inbox web opens local full-history UI, /inbox all shows all sessions, /inbox open <id> views a session",
       acceptsArgs: true,
       async handler(ctx: any) {
         const args = ((ctx.args ?? "") as string).trim().split(/\s+/).filter(Boolean);
         const sessions = getSessions();
 
-        // /inbox web — 启动本地 Web UI
+        // /inbox web
         if (args[0] === "web") {
           const existing = getLocalServerUrl();
           if (existing) {
-            return { text: `🦞 本地收件箱已在运行：${existing}` };
+            return { text: t("inbox_local_running", { url: existing }) };
           }
           const url = await startLocalServer();
-          return { text: `🦞 本地收件箱已启动（完整历史，仅限本机访问）：\n${url}` };
+          return { text: t("inbox_local_started", { url }) };
         }
 
         // /inbox open <id> [more]
@@ -109,37 +110,35 @@ export default {
           const showMore = args[2] === "more";
           const session = sessions[sessionId];
           if (!session) {
-            return { text: `❌ 未找到会话 ${sessionId}\n\n输入 /inbox 查看有未读消息的会话，/inbox all 查看全部会话。` };
+            return { text: t("inbox_session_404", { id: sessionId }) };
           }
 
           const msgs = session.messages ?? [];
           const limit = showMore ? 30 : 10;
           const slice = msgs.slice(-limit);
-          const partnerName = session.partner_name ?? session.partner_agent_id ?? "未知";
+          const partnerName = session.partner_name ?? session.partner_agent_id ?? t("unknown");
 
-          let text = `📨 与 ${partnerName} 的对话\n`;
-          text += `会话 ID: ${sessionId}\n`;
+          let text = `${t("inbox_chat_title", { name: partnerName })}\n`;
+          text += `${t("inbox_session_id", { id: sessionId })}\n`;
           text += `─────────────────────────\n`;
 
           if (slice.length === 0) {
-            text += "（暂无消息）\n";
+            text += `${t("inbox_no_messages")}\n`;
           } else {
             for (const m of slice) {
-              const time = m.created_at
-                ? new Date(m.created_at * 1000).toLocaleTimeString("zh-CN")
-                : "";
-              const sender = m.from_self ? "我的龙虾" : partnerName;
+              const time = m.created_at ? formatTime(m.created_at) : "";
+              const sender = m.from_self ? t("inbox_my_lobster") : partnerName;
               const preview =
                 m.content.length > 100
-                  ? m.content.slice(0, 100) + `…（共 ${m.content.length} 字）`
+                  ? m.content.slice(0, 100) + `… (${m.content.length})`
                   : m.content;
               text += `[${time}] ${sender}: ${preview}\n`;
             }
           }
 
           if (msgs.length > limit) {
-            text += `\n（共 ${msgs.length} 条消息，显示最近 ${limit} 条）\n`;
-            if (!showMore) text += `输入 /inbox open ${sessionId} more 查看更早的消息\n`;
+            text += `\n${t("inbox_msg_count", { total: msgs.length, limit })}\n`;
+            if (!showMore) text += `${t("inbox_more_hint", { id: sessionId })}\n`;
           }
 
           markRead(sessionId);
@@ -155,30 +154,30 @@ export default {
         const totalUnread = Object.values(sessions).reduce((sum, s) => sum + (s.unread ?? 0), 0);
 
         let text = showAll
-          ? `📬 ClawSocial 全部会话（共 ${list.length} 个，${totalUnread} 条未读）\n\n`
-          : `📬 ClawSocial 未读消息（${totalUnread} 条）\n\n`;
+          ? t("inbox_all_title", { count: list.length, unread: totalUnread })
+          : t("inbox_unread_title", { count: totalUnread });
 
         if (list.length === 0) {
-          text += showAll ? "暂无会话。\n" : "没有未读消息。\n";
+          text += showAll ? t("inbox_no_sessions") : t("inbox_no_unread");
         } else {
           for (const s of list.slice(0, 15)) {
-            const name = s.partner_name ?? s.partner_agent_id ?? "未知";
-            const unreadBadge = (s.unread ?? 0) > 0 ? ` [${s.unread}条未读]` : "";
-            const preview = s.last_message ? s.last_message.slice(0, 50) : "（无消息）";
+            const name = s.partner_name ?? s.partner_agent_id ?? t("unknown");
+            const unreadBadge = (s.unread ?? 0) > 0 ? t("inbox_unread_badge", { n: s.unread! }) : "";
+            const preview = s.last_message ? s.last_message.slice(0, 50) : t("inbox_no_preview");
             text += `• ${name}${unreadBadge}\n`;
             text += `  ${preview}\n`;
             text += `  → /inbox open ${s.id}\n\n`;
           }
-          if (list.length > 15) text += `... 还有 ${list.length - 15} 个会话\n\n`;
+          if (list.length > 15) text += t("inbox_more_sessions", { n: list.length - 15 });
         }
 
-        if (!showAll) text += `输入 /inbox all 查看全部会话\n`;
+        if (!showAll) text += t("inbox_show_all");
 
         try {
           const { url } = await apiClient.openInboxToken();
-          text += `\n🔗 浏览器查看: ${url}\n`;
+          text += `\n🔗 ${url}\n`;
         } catch {
-          text += "\n（无法生成登录链接，请确认已注册）\n";
+          text += t("inbox_link_fail");
         }
 
         return { text };
@@ -187,28 +186,28 @@ export default {
 
     // /clawsocial-notify — zero-token notification mode switch
     const VALID_MODES: NotifyMode[] = ["silent", "minimal", "detail"];
-    const MODE_DESC: Record<NotifyMode, string> = {
-      silent: "静默 — 不推送通知",
-      minimal: "极简 — 仅提示有新消息",
-      detail: "详情 — 显示发送人和消息内容",
+    const MODE_KEY: Record<NotifyMode, "notify_silent" | "notify_minimal" | "notify_detail"> = {
+      silent: "notify_silent",
+      minimal: "notify_minimal",
+      detail: "notify_detail",
     };
 
     api.registerCommand({
       name: "clawsocial-notify",
-      description: "查看或切换 ClawSocial 通知模式 (silent|minimal|detail)",
+      description: "View or change ClawSocial notification mode (silent|minimal|detail)",
       acceptsArgs: true,
       handler(ctx: any) {
         const arg = (ctx.args ?? "").trim().toLowerCase();
         if (arg && VALID_MODES.includes(arg as NotifyMode)) {
           setSettings({ notifyMode: arg as NotifyMode });
-          return { text: `✅ 通知模式已设为「${MODE_DESC[arg as NotifyMode]}」` };
+          return { text: t("notify_set", { mode: t(MODE_KEY[arg as NotifyMode]) }) };
         }
         const current = getSettings().notifyMode;
-        let text = `当前通知模式: ${MODE_DESC[current]}\n\n可选模式:\n`;
+        let text = `${t(MODE_KEY[current])}\n\n`;
         for (const m of VALID_MODES) {
-          text += `  ${m === current ? "→" : " "} ${m} — ${MODE_DESC[m]}\n`;
+          text += `  ${m === current ? "→" : " "} ${m} — ${t(MODE_KEY[m])}\n`;
         }
-        text += `\n用法: /clawsocial-notify <mode>`;
+        text += `\nUsage: /clawsocial-notify <mode>`;
         return { text };
       },
     });

package/openclaw.plugin.json

@@ -4,7 +4,19 @@
   "description": "Connect with people who share your interests via the ClawSocial network",
   "configSchema": {
     "type": "object",
-    "properties": {}
+    "properties": {
+      "serverUrl": {
+        "type": "string",
+        "description": "ClawSocial server URL. Only change this if you self-host.",
+        "default": "https://claw-social.com"
+      },
+      "notifyMode": {
+        "type": "string",
+        "enum": ["silent", "minimal", "detail"],
+        "description": "Default notification mode on first install. silent = no notifications, minimal = new message hint only, detail = show sender and content.",
+        "default": "silent"
+      }
+    }
   },
   "skills": ["./SKILL.md"]
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "clawsocial-plugin",
-  "version": "1.5.0",
+  "version": "1.6.0",
   "description": "ClawSocial OpenClaw Plugin — social discovery for AI agents",
   "type": "module",
   "dependencies": {

package/src/api.ts

@@ -81,7 +81,7 @@ async function request<T = unknown>(
   return data;
 }
 
-export type RegisterBody = { public_name: string; availability?: string };
+export type RegisterBody = { public_name: string; availability?: string; language_pref?: string };
 export type RegisterResult = { agent_id: string; api_key: string; token: string; public_name: string };
 export type SearchBody = { intent: string; topic_tags?: string[]; top_k?: number };
 export type SearchResult = { candidates: Array<{ agent_id: string; public_name: string; topic_tags?: string[]; match_score: number; availability?: string; manual_intro?: string; auto_bio?: string; match_reason?: string }> };

package/src/i18n.ts

@@ -0,0 +1,142 @@
+import { getState } from "./store.js";
+
+export type Lang = "zh" | "en";
+
+export function getLang(): Lang {
+  const state = getState();
+  return (state as Record<string, unknown>).lang === "en" ? "en" : "zh";
+}
+
+export function formatTime(ts: number): string {
+  const locale = getLang() === "zh" ? "zh-CN" : "en-US";
+  return new Date(ts * 1000).toLocaleTimeString(locale, { hour: "2-digit", minute: "2-digit" });
+}
+
+export function formatDateTime(ts: number): string {
+  const locale = getLang() === "zh" ? "zh-CN" : "en-US";
+  return new Date(ts * 1000).toLocaleString(locale);
+}
+
+const strings = {
+  // ── WebSocket notifications ────────────────────────────────────
+  ws_auth_ok:            { zh: "认证成功",           en: "Authenticated" },
+  ws_auth_fail:          { zh: "认证失败",           en: "Auth failed" },
+  ws_connected:          { zh: "已连接服务器",       en: "Connected to server" },
+  ws_disconnected:       { zh: "连接断开",           en: "Disconnected" },
+  ws_reconnect:          { zh: "5s 后重连",          en: "reconnecting in 5s" },
+  ws_not_registered:     { zh: "尚未注册，跳过 WS 连接", en: "Not registered, skipping WS" },
+  ws_new_msg_notify:     { zh: "[ClawSocial] 你有新消息，输入 /inbox 查看或打开收件箱。",
+                           en: "[ClawSocial] You have new messages. Type /inbox to view or open your inbox." },
+  ws_connect_req:        { zh: "收到连接请求！来自：{name}。请调用 clawsocial_open_inbox 查看收件箱。",
+                           en: "Connection request from {name}. Use clawsocial_open_inbox to view." },
+  ws_connect_req_notify: { zh: "[ClawSocial] 收到来自 {name} 的连接请求。可调用 clawsocial_open_inbox 查看。",
+                           en: "[ClawSocial] Connection request from {name}. Use clawsocial_open_inbox to view." },
+  ws_session_accepted:   { zh: "{name} 接受了连接请求，会话 ID：{id}",
+                           en: "{name} accepted your connection, session: {id}" },
+  ws_session_notify:     { zh: "[ClawSocial] {name} 开始了与你的会话。可调用 clawsocial_session_get 查看消息。",
+                           en: "[ClawSocial] {name} started a conversation with you. Use clawsocial_session_get to view." },
+  ws_msg_log:            { zh: "来自 {name}：{preview}",
+                           en: "From {name}: {preview}" },
+  ws_msg_notify:         { zh: "[ClawSocial] 收到 {name} 的新消息：{preview}",
+                           en: "[ClawSocial] New message from {name}: {preview}" },
+
+  // ── /inbox command ─────────────────────────────────────────────
+  inbox_local_running:   { zh: "🦞 本地收件箱已在运行：{url}",
+                           en: "🦞 Local inbox already running: {url}" },
+  inbox_local_started:   { zh: "🦞 本地收件箱已启动（完整历史，仅限本机访问）：\n{url}",
+                           en: "🦞 Local inbox started (full history, local only):\n{url}" },
+  inbox_session_404:     { zh: "❌ 未找到会话 {id}\n\n输入 /inbox 查看有未读消息的会话，/inbox all 查看全部会话。",
+                           en: "❌ Session {id} not found.\n\nType /inbox for unread sessions, /inbox all for all." },
+  inbox_chat_title:      { zh: "📨 与 {name} 的对话",   en: "📨 Chat with {name}" },
+  inbox_session_id:      { zh: "会话 ID: {id}",         en: "Session ID: {id}" },
+  inbox_no_messages:     { zh: "（暂无消息）",           en: "(no messages)" },
+  inbox_my_lobster:      { zh: "我的龙虾",               en: "My lobster" },
+  inbox_msg_count:       { zh: "（共 {total} 条消息，显示最近 {limit} 条）",
+                           en: "({total} messages total, showing last {limit})" },
+  inbox_more_hint:       { zh: "输入 /inbox open {id} more 查看更早的消息",
+                           en: "Type /inbox open {id} more for older messages" },
+  inbox_all_title:       { zh: "📬 ClawSocial 全部会话（共 {count} 个，{unread} 条未读）\n\n",
+                           en: "📬 ClawSocial all sessions ({count} total, {unread} unread)\n\n" },
+  inbox_unread_title:    { zh: "📬 ClawSocial 未读消息（{count} 条）\n\n",
+                           en: "📬 ClawSocial unread messages ({count})\n\n" },
+  inbox_no_sessions:     { zh: "暂无会话。\n",           en: "No sessions yet.\n" },
+  inbox_no_unread:       { zh: "没有未读消息。\n",       en: "No unread messages.\n" },
+  inbox_unread_badge:    { zh: " [{n}条未读]",           en: " [{n} unread]" },
+  inbox_no_preview:      { zh: "（无消息）",             en: "(no messages)" },
+  inbox_show_all:        { zh: "输入 /inbox all 查看全部会话\n",
+                           en: "Type /inbox all to view all sessions\n" },
+  inbox_more_sessions:   { zh: "... 还有 {n} 个会话\n\n",
+                           en: "... {n} more sessions\n\n" },
+  inbox_link_fail:       { zh: "\n（无法生成登录链接，请确认已注册）\n",
+                           en: "\n(Unable to generate login link — make sure you are registered)\n" },
+
+  // ── /clawsocial-notify command ─────────────────────────────────
+  notify_silent:         { zh: "静默 — 不推送通知",       en: "Silent — no notifications" },
+  notify_minimal:        { zh: "极简 — 仅提示有新消息",   en: "Minimal — new message hint only" },
+  notify_detail:         { zh: "详情 — 显示发送人和消息内容", en: "Detail — show sender and content" },
+  notify_set:            { zh: "✅ 通知模式已设为「{mode}」", en: "✅ Notification mode set to \"{mode}\"" },
+
+  // ── Local server UI ────────────────────────────────────────────
+  local_title:           { zh: "本地收件箱 — ClawSocial", en: "Local Inbox — ClawSocial" },
+  local_no_sessions:     { zh: "暂无会话",               en: "No sessions" },
+  local_no_sessions_p:   { zh: "通过 ClawSocial 发起或接受连接后，会话将显示在这里",
+                           en: "Sessions will appear here after you connect with someone via ClawSocial" },
+  local_unknown:         { zh: "未知",                   en: "Unknown" },
+  local_no_msg:          { zh: "（无消息）",             en: "(no messages)" },
+  local_active:          { zh: "进行中",                 en: "Active" },
+  local_pending:         { zh: "等待中",                 en: "Pending" },
+  local_tag:             { zh: "本地全量消息",           en: "Full local history" },
+  local_home:            { zh: "🦞 官网",                en: "🦞 Home" },
+  local_no_messages:     { zh: "暂无消息",               en: "No messages" },
+  local_placeholder:     { zh: "发送消息…",              en: "Send a message…" },
+  local_back:            { zh: "← 收件箱",              en: "← Inbox" },
+  local_msg_count:       { zh: "共 {n} 条消息",          en: "{n} messages" },
+  local_send_fail:       { zh: "发送失败",               en: "Send failed" },
+  local_unknown_err:     { zh: "未知错误",               en: "Unknown error" },
+  local_started:         { zh: "本地收件箱已启动",       en: "Local inbox started" },
+
+  // ── Tools ──────────────────────────────────────────────────────
+  tools_not_registered:  { zh: "尚未注册 ClawSocial，请先使用 clawsocial_register 注册。",
+                           en: "Not registered on ClawSocial. Use clawsocial_register first." },
+  tools_registered:      { zh: "✅ 已成功注册 ClawSocial。你的龙虾名：{name}",
+                           en: "✅ Registered on ClawSocial. Your lobster name: {name}" },
+  tools_msg_delivered:   { zh: "✅ 消息已送达",          en: "✅ Message delivered" },
+  tools_msg_queued:      { zh: "📬 消息已入队（对方龙虾当前离线）",
+                           en: "📬 Message queued (recipient offline)" },
+  tools_blocked:         { zh: "✅ 已屏蔽，对方将无法再联系你",
+                           en: "✅ Blocked. They can no longer contact you." },
+  tools_profile_updated: { zh: "✅ 资料已更新！其他人现在可以根据你的兴趣找到你了。",
+                           en: "✅ Profile updated! Others can now find you by your interests." },
+  tools_no_update:       { zh: "没有提供任何要更新的内容。",
+                           en: "No updates provided." },
+  tools_session_404:     { zh: "未找到该会话",           en: "Session not found" },
+  tools_no_match:        { zh: "暂时没有找到匹配的龙虾。可以稍后再试，或者换一个话题描述。",
+                           en: "No matches found. Try again later or use a different description." },
+  tools_me:              { zh: "我",                     en: "Me" },
+  tools_my_lobster:      { zh: "我的龙虾",               en: "My lobster" },
+  tools_other:           { zh: "对方",                   en: "Other" },
+  tools_inbox_link:      { zh: "🦞 收件箱登录链接（{min} 分钟有效，仅可使用一次）：\n{url}\n\n链接失效后可再次调用此工具重新生成。",
+                           en: "🦞 Inbox login link ({min} min, single use):\n{url}\n\nCall this tool again if the link expires." },
+  tools_local_inbox:     { zh: "🦞 本地收件箱已启动（完整历史，仅限本机访问）：\n{url}\n\n浏览器打开即可查看全部消息记录并回复。",
+                           en: "🦞 Local inbox started (full history, local only):\n{url}\n\nOpen in browser to view all messages and reply." },
+
+  // ── Common ─────────────────────────────────────────────────────
+  unknown:               { zh: "未知",                   en: "Unknown" },
+} as const;
+
+type StringKey = keyof typeof strings;
+
+/**
+ * Get a localized string, optionally with {placeholder} substitution.
+ */
+export function t(key: StringKey, vars?: Record<string, string | number>): string {
+  const lang = getLang();
+  const entry = strings[key];
+  let str: string = entry[lang] ?? entry.en;
+  if (vars) {
+    for (const [k, v] of Object.entries(vars)) {
+      str = str.replace(new RegExp(`\\{${k}\\}`, "g"), String(v));
+    }
+  }
+  return str;
+}