logicx-skill-test

---

name: logicx-skill description: Call LogicX frontend proxy APIs for health checks, browser binding, password login, user info, orders, payments, and account actions. homepage: http://43.139.104.95:8070 metadata: openclaw: emoji: "🔗" requires: bins: ["curl", "bash"]

---

LogicX Skill

Interact with the LogicX platform on behalf of the user. All API calls go through the frontend proxy (/api/proxy/*). Use scripts/logicx_api.sh for every request — never write ad-hoc curl commands.

Rules

Only call /api/proxy/* (or /api/health). Never call backend /v1/* directly.

Default to browser binding. Only ask for email and password if the user explicitly chooses password login.

Confirm before any mutating call: payment/create, payment/cancel, auth/change-password, agent/unlink.

Never echo LOGICX_AGENT_SERVICE_KEY or LOGICX_USER_TOKEN in full.

Never infer binding, membership, order, or payment state — report API responses only.

Summarize results in natural language unless the user asks for raw JSON.

Auth

No user token required:

GET /api/health

POST agent/link/start

POST agent/link/status

POST agent/auth/login

All other calls require both headers:

Authorization: Bearer 
X-LogicX-User-Token: 

The script handles headers automatically. Built-in defaults: LOGICX_BASE_URL=http://43.139.104.95:8070, LOGICX_AGENT_SERVICE_KEY=openclaw-public.

Default Flow

1. If connectivity is uncertain, run GET /api/health. 2. If a user token is needed and none exists, start browser binding (see below). 3. After login, verify with GET user/. 4. Run the requested action.

Login: Browser Binding (Default)

{baseDir}/scripts/logicx_api.sh POST agent/link/start '{"install_id":"openclaw-main"}'

The script auto-saves link_code and install_id to ~/.config/logicx/skill-state.json.

Reply to the user:

你可以点击以下链接登录并完成授权：
登录完成后请回来告诉我一声，比如直接回复"我登录好了"。
如果你不想跳转浏览器，也可以直接把用户名和密码告诉我，我可以直接帮你登录。

When the user says they have finished, run:

{baseDir}/scripts/check_link_status.sh

Interpret the response:

pending — browser authorization not complete yet; ask the user to confirm and try again

expired — ask whether to restart binding

confirmed — token saved automatically; verify with GET user/

If the script fails with "No bind state found", restart with agent/link/start.

Login: Password (Fallback)

Only when the user explicitly chooses not to use the browser flow.

{baseDir}/scripts/logicx_api.sh POST agent/auth/login \
  '{"email":"user@example.com","password":"secret","install_id":"openclaw-main"}'

Rate limit: 5 attempts per 15 minutes per IP + email. On 429, tell the user to wait before retrying.

After success, verify:

{baseDir}/scripts/logicx_api.sh GET user/

Common Calls

# Health
{baseDir}/scripts/logicx_api.sh GET /api/health
Account
{baseDir}/scripts/logicx_api.sh GET user/
Orders
{baseDir}/scripts/logicx_api.sh GET payment/orders
{baseDir}/scripts/logicx_api.sh GET payment/orders/ORDER_NO
Payment (confirm before calling)
{baseDir}/scripts/logicx_api.sh POST payment/create '{"plan":"pro_monthly","gateway":"mock"}'
{baseDir}/scripts/logicx_api.sh POST payment/cancel '{"orderNo":"ORDER_NO"}'
Password change (confirm before calling)
{baseDir}/scripts/logicx_api.sh POST auth/change-password '{"currentPassword":"old","newPassword":"new-min-8"}'
Unlink device (confirm before calling)
{baseDir}/scripts/logicx_api.sh POST agent/unlink '{"install_id":"INSTALL_ID"}'

Error Handling

Agent service key required / Unauthorized — the backend may not have enabled the public key yet; ask the user to try again later or contact LogicX support

429 on login — rate limit hit; wait 15 minutes

Auth failure on user-scoped calls — clear the saved token and restart binding

References

references/api-reference.md — full endpoint specs

examples.md — example dialogues

Only call /api/proxy/* (or /api/health). Never call backend /v1/* directly.

Default to browser binding. Only ask for email and password if the user explicitly chooses password login.

Confirm before any mutating call: payment/create, payment/cancel, auth/change-password, agent/unlink.

Never echo LOGICX_AGENT_SERVICE_KEY or LOGICX_USER_TOKEN in full.

Never infer binding, membership, order, or payment state — report API responses only.

Summarize results in natural language unless the user asks for raw JSON.