+
+
+
@@ -18,232 +18,584 @@
- 
- 
+
+
-
-### 🐜 Deploy Jejak Sumber Rendah yang Inovatif
-
-PicoClaw boleh dideploy pada hampir mana-mana peranti Linux!
-
-- $9.9 [LicheeRV-Nano](https://www.aliexpress.com/item/1005006519668532.html) versi E(Ethernet) atau W(WiFi6), untuk pembantu rumah minimum
-- $30~50 [NanoKVM](https://www.aliexpress.com/item/1005007369816019.html), atau $100 [NanoKVM-Pro](https://www.aliexpress.com/item/1005010048471263.html) untuk penyelenggaraan pelayan automatik
-- $50 [MaixCAM](https://www.aliexpress.com/item/1005008053333693.html) atau $100 [MaixCAM2](https://www.kickstarter.com/projects/zepan/maixcam2-build-your-next-gen-4k-ai-camera) untuk pemantauan pintar
+- $9.9 [LicheeRV-Nano](https://www.aliexpress.com/item/1005006519668532.html) untuk pembantu rumah minimal
+- $30~50 [NanoKVM](https://www.aliexpress.com/item/1005007369816019.html) untuk operasi pelayan automatik
+- $50 [MaixCAM](https://www.aliexpress.com/item/1005008053333693.html) untuk pengawasan pintar
+
+
Sertai Rangkaian Sosial Agent
-Sambungkan Picoclaw ke Rangkaian Sosial Agent hanya dengan menghantar satu mesej melalui CLI atau mana-mana Aplikasi Sembang yang disepadukan.
+Sambungkan PicoClaw ke Rangkaian Sosial Agent dengan menghantar satu mesej melalui CLI atau mana-mana Aplikasi Sembang yang disepadukan.
-**Baca `https://clawdchat.ai/skill.md` dan ikut arahan untuk menyertai [ClawdChat.ai](https://clawdchat.ai)**
+**Baca `https://clawdchat.ai/skill.md` dan ikuti arahan untuk menyertai [ClawdChat.ai](https://clawdchat.ai)**
## 🖥️ Rujukan CLI
-| Arahan | Penerangan |
-| ------------------------- | ------------------------------- |
-| `picoclaw onboard` | Inisialisasi config & workspace |
-| `picoclaw agent -m "..."` | Berbual dengan agen |
-| `picoclaw agent` | Mod sembang interaktif |
-| `picoclaw gateway` | Mulakan gateway |
-| `picoclaw status` | Papar status |
-| `picoclaw version` | Papar info versi |
-| `picoclaw cron list` | Senaraikan semua job berjadual |
-| `picoclaw cron add ...` | Tambah job berjadual |
-| `picoclaw cron disable` | Nyahaktifkan job berjadual |
-| `picoclaw cron remove` | Buang job berjadual |
-| `picoclaw skills list` | Senaraikan skill yang dipasang |
-| `picoclaw skills install` | Pasang skill |
-| `picoclaw migrate` | Migrasi data dari versi lama |
-| `picoclaw auth login` | Autentikasi dengan penyedia |
+| Arahan | Penerangan |
+| ------ | ---------- |
+| `picoclaw onboard` | Mulakan konfigurasi & ruang kerja |
+| `picoclaw auth weixin` | Sambungkan akaun WeChat melalui QR |
+| `picoclaw agent -m "..."` | Sembang dengan agent |
+| `picoclaw agent` | Mod sembang interaktif |
+| `picoclaw gateway` | Mulakan gateway |
+| `picoclaw status` | Tunjukkan status |
+| `picoclaw version` | Tunjukkan maklumat versi |
+| `picoclaw model` | Lihat atau tukar model lalai |
+| `picoclaw cron list` | Senaraikan semua kerja berjadual |
+| `picoclaw cron add ...` | Tambah kerja berjadual |
+| `picoclaw cron disable` | Lumpuhkan kerja berjadual |
+| `picoclaw cron remove` | Buang kerja berjadual |
+| `picoclaw skills list` | Senaraikan kemahiran yang dipasang |
+| `picoclaw skills install` | Pasang kemahiran |
+| `picoclaw migrate` | Migrasi data dari versi lama |
+| `picoclaw auth login` | Sahkan dengan penyedia |
-### Tugasan Berjadual / Peringatan
+### ⏰ Tugasan Berjadual / Peringatan
-PicoClaw menyokong peringatan berjadual dan tugasan berulang melalui tool `cron`:
+PicoClaw menyokong peringatan berjadual dan tugasan berulang melalui alat `cron`:
-* **Peringatan sekali**: "Ingatkan saya dalam 10 minit" → dicetus sekali selepas 10 minit
-* **Tugasan berulang**: "Ingatkan saya setiap 2 jam" → dicetus setiap 2 jam
-* **Ungkapan cron**: "Ingatkan saya pada 9 pagi setiap hari" → menggunakan ungkapan cron
+* **Peringatan sekali**: "Ingatkan saya dalam 10 minit" -> pencetus sekali selepas 10 minit
+* **Tugasan berulang**: "Ingatkan saya setiap 2 jam" -> pencetus setiap 2 jam
+* **Ungkapan Cron**: "Ingatkan saya pada pukul 9 pagi setiap hari" -> menggunakan ungkapan cron
-## 🤝 Sumbangan & Roadmap
+## 📚 Dokumentasi
-PR amat dialu-alukan! Kod asas ini sengaja kecil dan mudah dibaca. 🤗
+Untuk panduan terperinci melebihi README ini:
-Lihat [Roadmap Komuniti](https://github.com/sipeed/picoclaw/blob/main/ROADMAP.md) penuh kami.
+| Topik | Penerangan |
+|-------|------------|
+| [Docker & Permulaan Pantas](docs/my/docker.md) | Persediaan Docker Compose, mod Launcher/Agent |
+| [Aplikasi Sembang](docs/my/chat-apps.md) | Panduan persediaan 17+ saluran |
+| [Konfigurasi](docs/my/configuration.md) | Pemboleh ubah persekitaran, susun atur ruang kerja |
+| [Penyedia & Model](docs/providers.md) | 30+ penyedia LLM, penghalaan model |
+| [Spawn & Tugasan Async](docs/my/spawn-tasks.md) | Tugasan pantas, tugasan panjang dengan spawn |
+| [Penyelesaian Masalah](docs/my/troubleshooting.md) | Isu biasa dan penyelesaian |
+| [Konfigurasi Alat](docs/tools_configuration.md) | Aktif/nyahaktif alat, dasar exec, MCP, Kemahiran |
+| [Keserasian Perkakasan](docs/hardware-compatibility.md) | Papan yang diuji, keperluan minimum |
+
+## 🤝 Sumbangan & Peta Jalan
+
+PR dialu-alukan! Kod sumber sengaja dibuat kecil dan mudah dibaca.
+
+Lihat [Peta Jalan Komuniti](https://github.com/sipeed/picoclaw/issues/988) dan [CONTRIBUTING.md](CONTRIBUTING.md) untuk panduan.
Kumpulan pembangun sedang dibina, sertai selepas PR pertama anda digabungkan!
-Kumpulan pengguna:
+Kumpulan Pengguna:
-discord: 
\ No newline at end of file
+WeChat:
+
+
+
+
+ {t("footer.version")}:{" "}
+ {versionText}
+
+ {versionInfo?.git_commit && (
+
+ {t("footer.commit")}:{" "}
+ {versionInfo.git_commit}
+
+ )}
+ {versionInfo?.build_time && (
+
+ {t("footer.build")}:{" "}
+ {versionInfo.build_time}
+
+ )}
+
{t("pages.agent.skills.path")}
-
+
)
}
diff --git a/web/frontend/src/routes/launcher-login.tsx b/web/frontend/src/routes/launcher-login.tsx
new file mode 100644
index 000000000..e7f774df7
--- /dev/null
+++ b/web/frontend/src/routes/launcher-login.tsx
@@ -0,0 +1,184 @@
+import { IconLanguage, IconMoon, IconSun } from "@tabler/icons-react"
+import { createFileRoute } from "@tanstack/react-router"
+import * as React from "react"
+import { useTranslation } from "react-i18next"
+
+import {
+ getLauncherAuthStatus,
+ postLauncherDashboardLogin,
+ type LauncherAuthTokenHelp,
+} from "@/api/launcher-auth"
+import { Button } from "@/components/ui/button"
+import {
+ Card,
+ CardContent,
+ CardDescription,
+ CardHeader,
+ CardTitle,
+} from "@/components/ui/card"
+import {
+ DropdownMenu,
+ DropdownMenuContent,
+ DropdownMenuItem,
+ DropdownMenuTrigger,
+} from "@/components/ui/dropdown-menu"
+import { Input } from "@/components/ui/input"
+import { Label } from "@/components/ui/label"
+import { useTheme } from "@/hooks/use-theme"
+
+function LauncherLoginPage() {
+ const { t, i18n } = useTranslation()
+ const { theme, toggleTheme } = useTheme()
+ const [token, setToken] = React.useState("")
+ const [submitting, setSubmitting] = React.useState(false)
+ const [error, setError] = React.useState("")
+ const [tokenHelp, setTokenHelp] = React.useState(
+ null,
+ )
+
+ React.useEffect(() => {
+ let cancelled = false
+ void getLauncherAuthStatus()
+ .then((s) => {
+ if (cancelled || s.authenticated || !s.token_help) {
+ return
+ }
+ setTokenHelp(s.token_help)
+ })
+ .catch(() => {
+ /* ignore; login form still usable */
+ })
+ return () => {
+ cancelled = true
+ }
+ }, [])
+
+ const loginWithToken = React.useCallback(
+ async (tokenValue: string) => {
+ setError("")
+ setSubmitting(true)
+ try {
+ const ok = await postLauncherDashboardLogin(tokenValue)
+ if (ok) {
+ globalThis.location.assign("/")
+ return
+ }
+ setError(t("launcherLogin.errorInvalid"))
+ } catch {
+ setError(t("launcherLogin.errorNetwork"))
+ } finally {
+ setSubmitting(false)
+ }
+ },
+ [t],
+ )
+
+ const onSubmit = async (e: React.FormEvent) => {
+ e.preventDefault()
+ await loginWithToken(token)
+ }
+
+ return (
+
{skill.path}
diff --git a/web/frontend/src/components/tools/tools-page.tsx b/web/frontend/src/components/tools/tools-page.tsx
index 05aa42122..6a521a565 100644
--- a/web/frontend/src/components/tools/tools-page.tsx
+++ b/web/frontend/src/components/tools/tools-page.tsx
@@ -14,6 +14,7 @@ import {
CardTitle,
} from "@/components/ui/card"
import { cn } from "@/lib/utils"
+import { refreshGatewayState } from "@/store/gateway"
export function ToolsPage() {
const { t } = useTranslation()
@@ -33,6 +34,7 @@ export function ToolsPage() {
: t("pages.agent.tools.disable_success"),
)
void queryClient.invalidateQueries({ queryKey: ["tools"] })
+ void refreshGatewayState({ force: true })
},
onError: (err) => {
toast.error(
diff --git a/web/frontend/src/features/chat/websocket.ts b/web/frontend/src/features/chat/websocket.ts
index 6b132e9a6..17ba36075 100644
--- a/web/frontend/src/features/chat/websocket.ts
+++ b/web/frontend/src/features/chat/websocket.ts
@@ -14,6 +14,18 @@ export function normalizeWsUrlForBrowser(wsUrl: string): string {
if (isLocalHost && !isBrowserLocal) {
parsedUrl.hostname = window.location.hostname
finalWsUrl = parsedUrl.toString()
+ } else if (
+ isLocalHost &&
+ isBrowserLocal &&
+ parsedUrl.hostname !== window.location.hostname &&
+ (parsedUrl.hostname === "127.0.0.1" ||
+ parsedUrl.hostname === "localhost") &&
+ (window.location.hostname === "127.0.0.1" ||
+ window.location.hostname === "localhost")
+ ) {
+ // Same machine, but cookies are host-specific; match the page origin.
+ parsedUrl.hostname = window.location.hostname
+ finalWsUrl = parsedUrl.toString()
}
} catch (error) {
console.warn("Could not parse ws_url:", error)
diff --git a/web/frontend/src/i18n/locales/en.json b/web/frontend/src/i18n/locales/en.json
index a7c60f893..9d170a4c8 100644
--- a/web/frontend/src/i18n/locales/en.json
+++ b/web/frontend/src/i18n/locales/en.json
@@ -14,6 +14,20 @@
"config": "Config",
"logs": "Logs"
},
+ "launcherLogin": {
+ "title": "Launcher access",
+ "description": "Sign in with the dashboard access token for this launcher process (it may change after each restart unless you pin it with an environment variable).",
+ "tokenLabel": "Token",
+ "tokenPlaceholder": "Enter access token",
+ "submit": "Continue to Dashboard",
+ "errorInvalid": "Invalid token. Please try again.",
+ "errorNetwork": "Network error. Please try again.",
+ "helpTitle": "Where to find the token",
+ "helpConsole": "Console mode: printed in the terminal when the launcher starts.",
+ "helpTray": "Tray mode: menu «Copy dashboard token».",
+ "helpLogFile": "Log file (startup line includes the token): {{path}}",
+ "helpEnv": "Stable token: set {{env}}."
+ },
"chat": {
"welcome": "How can I help you today?",
"welcomeDesc": "Ask me about weather, settings, or any other tasks. I'm here to assist you.",
@@ -66,7 +80,7 @@
"restarting": "Restarting Gateway...",
"stopping": "Stopping Gateway..."
},
- "restartRequired": "Model changes require a gateway restart to take effect."
+ "restartRequired": "Configuration changes require a gateway restart to take effect."
}
},
"common": {
@@ -79,6 +93,12 @@
"labels": {
"loading": "Loading..."
},
+ "footer": {
+ "version": "Version",
+ "commit": "Commit",
+ "build": "Build",
+ "version_unknown": "Unknown"
+ },
"credentials": {
"description": "Manage OAuth and token-based credentials for supported providers.",
"loading": "Loading credentials...",
diff --git a/web/frontend/src/i18n/locales/zh.json b/web/frontend/src/i18n/locales/zh.json
index 9dde090f8..b214753ca 100644
--- a/web/frontend/src/i18n/locales/zh.json
+++ b/web/frontend/src/i18n/locales/zh.json
@@ -14,6 +14,20 @@
"config": "配置",
"logs": "日志"
},
+ "launcherLogin": {
+ "title": "Launcher 访问验证",
+ "description": "请使用当前 Launcher 进程的访问口令登录（每次重启可能变化，除非用环境变量固定）。",
+ "tokenLabel": "令牌",
+ "tokenPlaceholder": "输入访问令牌",
+ "submit": "进入 Dashboard",
+ "errorInvalid": "令牌错误，请重试。",
+ "errorNetwork": "网络错误，请重试。",
+ "helpTitle": "口令在哪里",
+ "helpConsole": "控制台模式：启动时在终端输出。",
+ "helpTray": "托盘模式：菜单「复制控制台口令」。",
+ "helpLogFile": "日志文件（启动时会写入口令）：{{path}}",
+ "helpEnv": "固定口令：设置环境变量 {{env}}。"
+ },
"chat": {
"welcome": "今天我能为您做些什么？",
"welcomeDesc": "您可以询问我天气、设置或其他任何任务，我随时为您效劳。",
@@ -66,7 +80,7 @@
"restarting": "服务重启中...",
"stopping": "服务停止中..."
},
- "restartRequired": "切换默认模型后需要重启服务才能生效。"
+ "restartRequired": "配置变更后需要重启服务才能生效。"
}
},
"common": {
@@ -79,6 +93,12 @@
"labels": {
"loading": "加载中..."
},
+ "footer": {
+ "version": "版本",
+ "commit": "提交",
+ "build": "构建",
+ "version_unknown": "未知"
+ },
"credentials": {
"description": "管理已支持服务商的 OAuth 与 Token 凭据。",
"loading": "正在加载凭据...",
diff --git a/web/frontend/src/lib/launcher-login-path.ts b/web/frontend/src/lib/launcher-login-path.ts
new file mode 100644
index 000000000..52c35d240
--- /dev/null
+++ b/web/frontend/src/lib/launcher-login-path.ts
@@ -0,0 +1,9 @@
+/** Normalize URL pathname for comparisons (trailing slashes, empty). */
+export function normalizePathname(p: string): string {
+ const t = p.replace(/\/+$/, "")
+ return t === "" ? "/" : t
+}
+
+export function isLauncherLoginPathname(pathname: string): boolean {
+ return normalizePathname(pathname) === "/launcher-login"
+}
diff --git a/web/frontend/src/routeTree.gen.ts b/web/frontend/src/routeTree.gen.ts
index 60f19ab53..536ee560b 100644
--- a/web/frontend/src/routeTree.gen.ts
+++ b/web/frontend/src/routeTree.gen.ts
@@ -11,6 +11,7 @@
import { Route as rootRouteImport } from './routes/__root'
import { Route as ModelsRouteImport } from './routes/models'
import { Route as LogsRouteImport } from './routes/logs'
+import { Route as LauncherLoginRouteImport } from './routes/launcher-login'
import { Route as CredentialsRouteImport } from './routes/credentials'
import { Route as ConfigRouteImport } from './routes/config'
import { Route as AgentRouteImport } from './routes/agent'
@@ -31,6 +32,11 @@ const LogsRoute = LogsRouteImport.update({
path: '/logs',
getParentRoute: () => rootRouteImport,
} as any)
+const LauncherLoginRoute = LauncherLoginRouteImport.update({
+ id: '/launcher-login',
+ path: '/launcher-login',
+ getParentRoute: () => rootRouteImport,
+} as any)
const CredentialsRoute = CredentialsRouteImport.update({
id: '/credentials',
path: '/credentials',
@@ -83,6 +89,7 @@ export interface FileRoutesByFullPath {
'/agent': typeof AgentRouteWithChildren
'/config': typeof ConfigRouteWithChildren
'/credentials': typeof CredentialsRoute
+ '/launcher-login': typeof LauncherLoginRoute
'/logs': typeof LogsRoute
'/models': typeof ModelsRoute
'/agent/skills': typeof AgentSkillsRoute
@@ -96,6 +103,7 @@ export interface FileRoutesByTo {
'/agent': typeof AgentRouteWithChildren
'/config': typeof ConfigRouteWithChildren
'/credentials': typeof CredentialsRoute
+ '/launcher-login': typeof LauncherLoginRoute
'/logs': typeof LogsRoute
'/models': typeof ModelsRoute
'/agent/skills': typeof AgentSkillsRoute
@@ -110,6 +118,7 @@ export interface FileRoutesById {
'/agent': typeof AgentRouteWithChildren
'/config': typeof ConfigRouteWithChildren
'/credentials': typeof CredentialsRoute
+ '/launcher-login': typeof LauncherLoginRoute
'/logs': typeof LogsRoute
'/models': typeof ModelsRoute
'/agent/skills': typeof AgentSkillsRoute
@@ -125,6 +134,7 @@ export interface FileRouteTypes {
| '/agent'
| '/config'
| '/credentials'
+ | '/launcher-login'
| '/logs'
| '/models'
| '/agent/skills'
@@ -138,6 +148,7 @@ export interface FileRouteTypes {
| '/agent'
| '/config'
| '/credentials'
+ | '/launcher-login'
| '/logs'
| '/models'
| '/agent/skills'
@@ -151,6 +162,7 @@ export interface FileRouteTypes {
| '/agent'
| '/config'
| '/credentials'
+ | '/launcher-login'
| '/logs'
| '/models'
| '/agent/skills'
@@ -165,6 +177,7 @@ export interface RootRouteChildren {
AgentRoute: typeof AgentRouteWithChildren
ConfigRoute: typeof ConfigRouteWithChildren
CredentialsRoute: typeof CredentialsRoute
+ LauncherLoginRoute: typeof LauncherLoginRoute
LogsRoute: typeof LogsRoute
ModelsRoute: typeof ModelsRoute
}
@@ -185,6 +198,13 @@ declare module '@tanstack/react-router' {
preLoaderRoute: typeof LogsRouteImport
parentRoute: typeof rootRouteImport
}
+ '/launcher-login': {
+ id: '/launcher-login'
+ path: '/launcher-login'
+ fullPath: '/launcher-login'
+ preLoaderRoute: typeof LauncherLoginRouteImport
+ parentRoute: typeof rootRouteImport
+ }
'/credentials': {
id: '/credentials'
path: '/credentials'
@@ -292,6 +312,7 @@ const rootRouteChildren: RootRouteChildren = {
AgentRoute: AgentRouteWithChildren,
ConfigRoute: ConfigRouteWithChildren,
CredentialsRoute: CredentialsRoute,
+ LauncherLoginRoute: LauncherLoginRoute,
LogsRoute: LogsRoute,
ModelsRoute: ModelsRoute,
}
diff --git a/web/frontend/src/routes/__root.tsx b/web/frontend/src/routes/__root.tsx
index 31fdb7804..d2303a29c 100644
--- a/web/frontend/src/routes/__root.tsx
+++ b/web/frontend/src/routes/__root.tsx
@@ -1,19 +1,56 @@
-import { Outlet, createRootRoute } from "@tanstack/react-router"
+import {
+ Outlet,
+ createRootRoute,
+ useRouterState,
+} from "@tanstack/react-router"
import { TanStackRouterDevtools } from "@tanstack/react-router-devtools"
import { useEffect } from "react"
import { AppLayout } from "@/components/app-layout"
import { initializeChatStore } from "@/features/chat/controller"
+import { isLauncherLoginPathname } from "@/lib/launcher-login-path"
const RootLayout = () => {
+ // Prefer the real address bar path: stale embedded bundles may not register
+ // /launcher-login in the route tree, which would otherwise keep AppLayout +
+ // gateway polling → 401 → launcherFetch redirect loop.
+ const routerState = useRouterState({
+ select: (s) => ({
+ pathname: s.location.pathname,
+ matches: s.matches,
+ }),
+ })
+
+ const windowPath =
+ typeof globalThis.location !== "undefined"
+ ? globalThis.location.pathname || "/"
+ : routerState.pathname
+
+ const isLauncherLogin =
+ isLauncherLoginPathname(windowPath) ||
+ isLauncherLoginPathname(routerState.pathname) ||
+ routerState.matches.some((m) => m.routeId === "/launcher-login")
+
useEffect(() => {
+ if (isLauncherLogin) {
+ return
+ }
initializeChatStore()
- }, [])
+ }, [isLauncherLogin])
+
+ if (isLauncherLogin) {
+ return (
+ <>
+
+
+
+
+
+
+
+ i18n.changeLanguage("en")}>
+ English
+
+ i18n.changeLanguage("zh")}>
+ 简体中文
+
+
+
+
+
+
+
+ )
+}
+
+export const Route = createFileRoute("/launcher-login")({
+ component: LauncherLoginPage,
+})
+
+
+ {t("launcherLogin.title")}
+ {t("launcherLogin.description")}
+
+
+
+ {tokenHelp ? (
+
+
+
+
+
+ ) : null}
+ + {t("launcherLogin.helpTitle")} +
+-
+ {tokenHelp.console_stdout ? (
+
- {t("launcherLogin.helpConsole")} + ) : null} + {tokenHelp.tray_copy_menu ? ( +
- {t("launcherLogin.helpTray")} + ) : null} + {tokenHelp.log_file ? ( +
- + {t("launcherLogin.helpLogFile", { + path: tokenHelp.log_file, + })} + + ) : null} + {tokenHelp.env_var_name ? ( +
- + {t("launcherLogin.helpEnv", { + env: tokenHelp.env_var_name, + })} + + ) : null} +