GeeLark Complete
Dieser Skill ist der zentrale End-to-End Skill fuer GeeLark und deckt alle aktuell praktikablen Faehigkeiten im Workspace ab.
Scope
- - GeeLark Setup und Betriebsbereitschaft
- Lokale Agent-API auf INLINECODE0
- Nativer Desktop-Sync ueber
mssvr (signierte Requests) - UI-Automation als Fallback bei API-Limits
- Browser-/Profil-Start und URL-Navigation
- Asset-Transfer und Posting-Vorbereitung
- Strikte Verifikation und reproduzierbares Troubleshooting
Voraussetzungen
- - App: INLINECODE2
- Env in
openclaw-config/.env:
-
GEELARK_API_BASE=http://localhost:40185
-
GEELARK_API_KEY=<bearer token>
-
scripts/geelark/local_client.py
-
scripts/geelark/sync_client.mjs
- - Fuer Sync: GeeLark nativer
mssvr muss aufloesbar/startbar sein
Faehigkeiten (Capability Matrix)
- 1. Setup
- - Team/Workspace-Basis pruefen
- Proxy/Phone/App-Basis dokumentieren
- INLINECODE9 Mapping aus Dashboard/Baserow festhalten
- 2. API Ops
- - Agent-Liveness und Port-Info pruefen
- Endpunkt-Footprint (
probe, request) - Lesende Ersttests vor schreibenden Calls
- Upload-/Task-Routen vorbereiten, sofern Methode/Payload belegt
- 3. Native Sync Ops
- - Signierte Requests mit
app-id + INLINECODE13 - Session-Lifecycle: INLINECODE14
- Preconditions pruefen (
sid, Handle-Anzahl, Handle-Matching)
- 4. UI/RPA Ops
- - App starten/fokussieren
- Sichtbare Profile/Browser oeffnen
- Klare, belegbare Klickpfade ausfuehren
- Bei Captcha/MFA bis zum belegbaren Blocker gehen und stoppen
- 5. Posting Ops
- - Asset-Transfer bis GeeLark-Endstation
- Plattformspezifische Posting-Sequenz vorbereiten
- Timing/Line-Disziplin aus dem Workflow einhalten
- 6. Verification Ops
- - Nach Aktionen immer dual pruefen:
- Zustand A: richtige Vordergrund-App/Fenster
- Zustand B: inhaltliche Zielpruefung (z. B. URL, Session-ID, API-Response)
- - Ohne Gegencheck gilt eine Aktion als nicht abgeschlossen
- 7. Recovery/Triage
- - API 404: Methode/Payload pruefen statt Endpunkt sofort verwerfen
- Sync-Fehler: erst
mssvr-Port und Signaturpfad checken - UI-Fehler: Fokusproblem von Logikproblem trennen
- Jede reproduzierbare Erkenntnis in Memory/Skill-Doku hinterlegen
Standard-Runbook
- 1. Klasse bestimmen: Setup, API, Sync, UI, Posting.
- API-first starten (harmloser Call zuerst).
- Wenn Sync gebraucht wird: nur
sync_client.mjs oder local_client.py sync-* nutzen. - Bei API-Blocker auf UI-Fallback wechseln.
- Nach jedem Schritt verifizieren.
- Nur bei validiertem Zustand weiter zum naechsten Schritt.
Kommandos (sicherer Einstieg)
CODEBLOCK0
Kommandos (Sync-Lifecycle)
CODEBLOCK1
Kommandos (UI-Fallback)
CODEBLOCK2
Claw/OpenClaw Integration
- - Lokale Nutzung: Skill liegt unter
skills/geelark-complete/ und ist damit im Workspace verfuegbar. - Mit ClawHub CLI publizieren:
CODEBLOCK3
Beziehungen zu vorhandenen Skills
- - Nutzt und konsolidiert:
-
geelark-ops
-
geelark-setup
-
geelark-api-ops
-
geelark-rpa-ops
-
geelark-posting-ops
-
geelark-sync-operational
- - Dieser Skill ist der zentrale Einstieg, die anderen bleiben als Deep-Dive erhalten.
Grenzen
- - Keine destruktiven Calls ohne belegte Route, Methode, Payload
- Keine externen Postings ohne explizite User-Absicht
- Keine erfundenen Endpunkte oder ungepruefte Automationsversprechen
Zielbild
Ein einziger GeeLark Skill, der operative End-to-End Aufgaben von Diagnose bis Ausfuehrung mit Pflicht-Verifikation abdeckt und zugleich in ClawHub versionierbar ist.
GeeLark Complete
该技能是GeeLark的核心端到端技能,覆盖工作区中所有当前可行的功能。
范围
- - GeeLark设置与运行就绪
- 基于GEELARKAPIBASE的本地Agent API
- 通过mssvr(签名请求)实现的原生桌面同步
- 作为API限制时的回退方案的UI自动化
- 浏览器/配置文件启动与URL导航
- 资产转移与发布准备
- 严格验证与可复现的故障排查
前提条件
- - 应用程序:/Applications/GeeLark.app
- openclaw-config/.env中的环境变量:
- GEELARK
APIBASE=http://localhost:40185
- GEELARK
APIKEY=
- scripts/geelark/local_client.py
- scripts/geelark/sync_client.mjs
- - 对于同步:GeeLark原生mssvr必须可解析/可启动
功能(能力矩阵)
- 1. 设置
- - 检查团队/工作区基础
- 记录代理/手机/应用基础信息
- 从仪表盘/Baserow记录phone_id映射
- 2. API操作
- - 检查Agent存活状态与端口信息
- 端点足迹(probe、request)
- 在写入调用前进行只读初步测试
- 准备上传/任务路由(若方法/负载已定义)
- 3. 原生同步操作
- - 使用app-id + app-auth的签名请求
- 会话生命周期:start -> config -> input/input_list -> stop
- 检查前置条件(sid、句柄数量、句柄匹配)
- 4. UI/RPA操作
- - 启动/聚焦应用
- 打开可见的配置文件/浏览器
- 执行清晰、可验证的点击路径
- 遇到验证码/MFA时,到达可验证的阻塞点后停止
- 5. 发布操作
- - 资产转移至GeeLark终点
- 准备特定平台的发布序列
- 遵循工作流中的时间/行纪律
- 6. 验证操作
- 状态A:正确的前台应用/窗口
- 状态B:内容目标检查(例如URL、会话ID、API响应)
- 7. 恢复/分类
- - API 404:检查方法/负载,而非立即丢弃端点
- 同步错误:首先检查mssvr端口和签名路径
- UI错误:将焦点问题与逻辑问题分开
- 将每个可复现的发现记录到内存/技能文档中
标准运行手册
- 1. 确定类别:设置、API、同步、UI、发布。
- 从API优先开始(先进行无害调用)。
- 如需同步:仅使用syncclient.mjs或localclient.py sync-*。
- 遇到API阻塞时切换到UI回退方案。
- 每一步后进行验证。
- 仅在状态验证通过后进入下一步。
命令(安全入门)
bash
python3 scripts/geelark/local_client.py info
python3 scripts/geelark/local_client.py health
python3 scripts/geelark/local_client.py probe --endpoint /v1/browser/core/list --methods GET OPTIONS POST --json-body {}
python3 scripts/geelark/local_client.py sync-info
node scripts/geelark/sync_client.mjs info
命令(同步生命周期)
bash
node scripts/geelark/sync_client.mjs start --main-hwnd 101 --hwnd 101 --hwnd 202
node scripts/geelark/syncclient.mjs config --sid abc --json-body {delayrangebeforeclick:[300,900]}
node scripts/geelark/sync_client.mjs same-input --sid abc --text hello world --input-interval 0,0
node scripts/geelark/sync_client.mjs stop --sid abc
命令(UI回退方案)
bash
open -a GeeLark
osascript -e tell application GeeLark to activate
Claw/OpenClaw集成
- - 本地使用:技能位于skills/geelark-complete/目录下,可在工作区中使用。
- 通过ClawHub CLI发布:
bash
clawdhub publish ./skills/geelark-complete \
--slug geelark-complete \
--name GeeLark Complete \
--version 1.0.0 \
--changelog Initial all-in-one GeeLark skill
与现有技能的关系
- geelark-ops
- geelark-setup
- geelark-api-ops
- geelark-rpa-ops
- geelark-posting-ops
- geelark-sync-operational
限制
- - 未经验证的路由、方法、负载,不执行破坏性调用
- 未经用户明确意图,不执行外部发布
- 不虚构端点或做出未经检验的自动化承诺
目标愿景
一个统一的GeeLark技能,覆盖从诊断到执行的端到端操作任务,并强制进行验证,同时可在ClawHub中进行版本管理。