Luckee Skill

Pre-flight

Before doing anything, check whether the plugin is already installed:

openclaw plugins list

If luckee-tool appears and shows as enabled, skip straight to Usage. Otherwise, follow Install below.

Install

Before installing, ask the user for confirmation: explain that the plugin will be fetched from its GitHub repository and registered with OpenClaw.

1. Register the plugin with OpenClaw

openclaw plugins install https://github.com/motse-ai/luckee-openclaw-plugin

This single command fetches the plugin and installs its dependencies. Do not run git clone or npm install manually.

2. Authenticate with Luckee

Run:

luckee login

This command opens a browser auth page. Ask the user to complete authorization in the web page, then continue in terminal once login finishes. Running regular luckee commands also checks login status and will prompt the same web authorization flow if the user is not logged in.

3. Restart and verify

openclaw gateway restart
openclaw plugins info luckee-tool
openclaw health

Confirm the plugin shows as loaded and the gateway is healthy. Do not ask the user for API URL, User ID, or Lingxing account details.

Usage

Chat command

/luckee <query>

Example: /luckee 查一下 asin B0DPJMTH4N 的信息 用skills

Set a token

/luckee token <token>

Set a token and run a query in one go:

/luckee token sk_xxx 查一下 asin B0DPJMTH4N 的信息

AI tool invocation

Call the luckee_query tool with:

{
  "query": "查一下 asin B0DPJMTH4N 的信息 用skills",
  "token": "sk_optional_override",
  "language": "CN",
  "timeout": 90
}

Only query is required. Auth context is handled by CLI/session state (via luckee login or the auto-login prompt when running luckee commands).

Token Management

• Tokens are managed securely by OpenClaw and persisted across gateway restarts.
• Set a per-user token via /luckee token <token> (overrides the default for that sender).
• Set a default token via config: openclaw config set plugins.entries.luckee-tool.config.defaultToken "<token>".
• See reference.md for advanced token store details.

Troubleshooting

Binary not found

The plugin auto-installs luckee-cli via pip when autoInstallCli is true (default). If that fails:

pip install --upgrade 'luckee-cli>=0.1.2026031307,<0.2.0'
openclaw gateway restart

Or set the path explicitly:

openclaw config set plugins.entries.luckee-tool.config.binaryPath "/path/to/luckee-cli"

Not logged in / auth expired

If queries fail with auth/login errors, re-run:

luckee login

Then retry the query. You can also retry with a normal luckee command; if not logged in, Luckee will prompt for web authorization automatically.

Timeout

Increase the default timeout (seconds):

openclaw config set plugins.entries.luckee-tool.config.defaultTimeout 180

Plugin ID mismatch warning

If you see "plugin id mismatch (manifest uses luckee-tool, entry hints luckee-openclaw-plugin)":

openclaw config unset plugins.entries.luckee-openclaw-plugin
openclaw gateway restart

Safety Rules

• Never log or display full tokens. Always redact to sk_x***xx format.
• All install/config operations are idempotent — safe to re-run.
• Do not overwrite unrelated config keys when setting luckee-tool config.
• Never request API URL, User ID, or Lingxing account credentials from users during normal setup/query flows.

Reference

For detailed config schema, channel list, token store format, and error catalog, see reference.md.