| name | linkmind-interaction |
| description | Operate LinkMind Interaction menu features against the hosted LinkMind server with API-key identity: recommended/joined/owned channels, subscribe/unsubscribe, monitor/list/send messages, create/enable/disable/delete/translate channels. Use when the user asks to manage LinkMind interaction/social channels without installing the LinkMind client. |
linkmind-interaction
Use this skill to operate the LinkMind "Interaction" menu directly from an agent.
The user only configures one LinkMind API key. Do not ask for, expose, or invent a
user ID. The bundled script resolves the key through the server, registers the
interaction user if needed, saves the last-login marker, and then performs the
requested channel operation.
Default server:
https://ai.linkmind.top
User configuration
The user's config file must contain only the API key value or a single key field.
Supported examples:
LINKMIND_API_KEY=sk-...
{"apiKey":"sk-..."}
apiKey: sk-...
If no key is configured, tell the user to register at https://ai.linkmind.top/.
After registration, the default key is shown under "API Keys" / "API miyao".
Do not call or propose any API that creates or reveals keys.
Prefer passing a config file path with --config. Avoid placing the raw key in
the command line because command lines may be logged by agent runtimes.
Keep this file in the agent user's private config area, not in this repository.
For this script, any of the following names are auto-detected in the current
working directory or this skill directory: linkmind.key, linkmind_api_key.txt,
config.json, config.txt, config.md, .env.
Command runner
All operations go through:
python scripts/linkmind_interaction.py --config <CONFIG_FILE> <command> [options]
The script uses only Python standard library modules. Do not rewrite requests
with curl, wget, ad-hoc PowerShell, node, or another HTTP client. If Python or
the script fails, report the failure and stop.
The script accepts --base-url for testing or private deployments, but normal
use should omit it so the hosted server is used.
Covered Interaction menu operations
- Account/session bootstrap: resolve API key with
/apiKey/getUserId and keep
the agent side transparent to user IDs. The script also has a compatibility
fallback for the common /apiKey/getUserld typo.
- Running mode:
mode maps to GET /socialChannel/runningMode.
- Subscribe page:
recommend, joined, join, leave, messages, monitor
map to public channels, joined channels, subscribe, unsubscribe, and message
listing/refresh.
- Subscribe page background translation:
translate maps to
POST /socialChannel/translateChannel.
- Publish page:
owned, create, enable, disable, delete map to owned
channel listing, create, toggle status, and delete.
- Message writing:
send is included so one skill can complete channel read and
write workflows, even though the older social-channel skill also supports it.
Admin-only servlet functions such as listUsers, deleteUser, and
deleteMessages are not Interaction menu operations. Do not use them for normal
user requests.
Server cascade settings (/socialChannel/cascadeConfig) are administrator-only
deployment configuration and are intentionally not exposed by this skill.
Common commands
List recommended channels and whether the current key's user has joined them:
python scripts/linkmind_interaction.py --config <CONFIG_FILE> recommend --limit 100 --lang zh-CN
Join or leave a channel:
python scripts/linkmind_interaction.py --config <CONFIG_FILE> join --channel-name "channel name"
python scripts/linkmind_interaction.py --config <CONFIG_FILE> leave --channel-id 12
Monitor channel messages once, or poll a finite number of times:
python scripts/linkmind_interaction.py --config <CONFIG_FILE> monitor --channel-name "channel name" --limit 100
python scripts/linkmind_interaction.py --config <CONFIG_FILE> monitor --channel-id 12 --polls 3 --interval 5
Create and manage owned channels:
python scripts/linkmind_interaction.py --config <CONFIG_FILE> create --name "channel name" --description "short intro"
python scripts/linkmind_interaction.py --config <CONFIG_FILE> disable --channel-name "channel name"
python scripts/linkmind_interaction.py --config <CONFIG_FILE> enable --channel-id 12
python scripts/linkmind_interaction.py --config <CONFIG_FILE> delete --channel-id 12 --yes
Response handling
The script prints JSON. If status is success, summarize the operation in the
user's language and include useful channel/message IDs. If status is failed,
relay msg and do not invent success.
Do not show the API key. Do not show the resolved user ID unless the user
explicitly asks for diagnostic details.
