Hub GPT

Hub GPT connects a configured AI-powered Direct Connect bot to one assigned hub. It can answer addressed main-chat questions, accept private-message prompts, run implemented server-side commands, and use the selected OpenAI provider configuration. The same page gives authorized hub owners and administrators a live monitor, usage records, connection actions, and the bot configuration that determines future requests.

This guide serves hub users and authorized administrators. Users need to know how to address the bot and interpret a reply. Administrators need the bot identity, provider request, limits, recovery, record, and privacy behavior. The rendered reference after this guide comes from the live form inventory so a saved field cannot silently disappear from documentation.

Overview

Hub GPT is a configured bot identity, not a public bot-creation service and not a replacement for Hub Chat. The signed-in user must own the selected hub through this website or hold the appropriate administrator role before opening configuration. The hub must still permit the bot nickname, password, class, private-message route, and public-chat behavior.

Use a dedicated low-privilege bot account. A class 3 account is a common hub-side baseline when the hub software needs it for bot commands, but this application does not grant hub permissions or require operator rights. Give only the permissions your hub policy requires; never reuse an owner password as a shortcut.

Create or select a dedicated bot account that the hub accepts, then record only the credentials needed for that account.
Set the bot nickname, aliases, language, client profile, and NMDC capability flags so they match the hub policy.
Choose one valid OpenAI key source, an allowed model, instructions, and limits that fit the hub's expected traffic.
Save the configuration, start the bot with Enable or Connect, then confirm the Status panel reports a connected worker before testing it.

Hub GPT Versus Hub Chat

Hub Chat	Hub GPT
Connects a user-controlled browser session for an authorized hub user.	Connects the configured bot identity for the hub.
Messages are sent manually through the visible composer.	Replies can be generated after an addressed main-chat or private prompt.
Uses the user's session identity and Hub Chat profile.	Uses bot credentials, profile, provider options, limits, and logging policy.
Is documented in Hub Chat.	Embeds a monitor but does not become the same user session.

Switching pages does not merge credentials, messages, permissions, records, or worker lifecycle. The live-client visual language is shared, but a bot must be configured and managed as its own identity.

Access States And User Invocation

The configuration route is for the assigned hub owner or an administrator, not for anonymous users. The bot's Access Status has three distinct values: Public makes the bot available under its connection and hub policy, Admin restricts it to the supported administrative context, and Hidden prevents normal public availability. Access status, Enabled, and Connected are not interchangeable: a bot can be public but disconnected, enabled but connecting, or hidden while stopped.

In main chat, address the configured nickname or alias. The parser accepts an optional @, then the name followed by end of text, whitespace, a comma, colon, semicolon, or hyphen. For example, HubGPT: help, @HubGPT weather Warsaw, and helper, stats work when those names are configured. In private chat an addressed prefix is optional: an unprefixed non-empty message is a prompt.

Commands use the first prompt token and their localized names or aliases. Ordinary prompts reach the provider only after connection, provider configuration, input checks, and enforced quotas succeed. A disabled, disconnected, busy, limited, or unavailable bot cannot promise a reply; inspect status or the relevant error rather than treating silence as acceptance.

Token Usage

Token Usage aggregates the selected reporting period for provider-backed requests. It separates questions and replies from input tokens, cached input tokens when reported, output tokens, total tokens, failed requests, shared-key usage, and remaining shared-key allowance where active. Changing the reporting range changes included records; it does not reset billing or delete records.

One message is not always one provider request. A server-handled command can return with no OpenAI tokens, while failed or legacy records can have blank token fields because no metric was supplied. Questions and replies describe application records; tokens measure provider processing. Use totals for trends and Recent GPT Records for an individual request.

Hub Chat

The embedded live client monitors the bot's current connection: displayed nickname, hub address, Main Chat, private conversations, runtime mode, and notification controls belong to the bot monitor. Authorized hub owners and administrators can use available monitor composers to inspect bot message paths, but changing a monitor view does not save GPT configuration.

Read Hub Chat for the shared client behavior. On this page, GPT settings are persisted by the configuration panels and an active save attempts a worker restart; monitor controls alone do not change a stored key, prompt, model, or limit.

Status And Session Actions

Status shows the current connection state, hub endpoint, bot nickname, Access Status, Enabled, retry count, Last Connected, and Last Error. Worker states include disconnected, connecting, connected, reconnecting, failed, stopped, and deployment-stopped. Status is operational evidence, while Access Status controls availability and Enabled indicates whether the bot is intended to run.

Action	What It Changes	When To Use It
Enable	Sets access to Public and saves the action.	Make a configured bot available before connecting.
Disable	Stops the worker and changes access to Hidden.	Take the bot out of normal use without deleting configuration or records.
Connect	Makes the bot Public and starts it when no worker is active.	Start a correctly configured stopped bot.
Reconnect	Stops a current worker when necessary and starts one with saved settings.	Recover after correcting a transient failure.
Disconnect	Stops the worker and marks the connection stopped without changing configured access.	Perform maintenance without disabling the bot.
Save	Persists submitted settings; an active worker is restarted so it reloads them.	Apply a planned change and check the outcome.

Save a complete identity and provider configuration before requesting a connection.
Choose Enable or Connect, then wait for the saved nickname and endpoint to reach Connected.
Send one harmless addressed prompt or permitted private message and inspect the resulting record.
Use Disconnect for planned maintenance, Disable to withdraw normal availability, and Reconnect only after correcting a reported failure.

These actions do not delete GPT records, service-bot audits, commands, or stored configuration. Enable and Connect only succeed when the saved bot identity and hub endpoint can be used; a success flash is not evidence that the hub accepted the nickname until Status reaches Connected. On failure, read Last Error, correct the saved cause, and then use Connect or Reconnect once.

Credentials

Bot Nickname is the Direct Connect login name. Hub nickname rules, registration, duplicate checks, and passwords still apply. Changing it is connection-sensitive: save, then confirm the worker restart or reconnect after correcting a rejected name.

Bot Aliases are additional main-chat address names; they never change the login nickname. Separate aliases with commas or new lines, and avoid names used by a hub user, another bot, or a reserved command. A bot named HubGPT with helper, assistant can receive assistant: help. Private messages do not need an alias because an unaddressed private message is already a prompt.

Hub Password is used only when the hub requests authentication. The stored secret is never rendered. A blank protected input keeps its saved value; use the inline clear action to remove it, then save and reconnect. Bot Language is the default locale for future bot and command text; service implementations can use saved per-user choices. Test a harmless command after changing it.

Advanced Client Profile

Profile values become Direct Connect identity metadata. They do not open ports, publish files, or grant privileges. Inaccurate values can fail a hub rule or tag check, so use values that match the bot's intended role. Saving an active profile uses the normal configuration restart path, which is when the hub receives new metadata.

Field	Protocol Meaning	Practical Rule
Fake Share	Reported share size in bytes.	Zero is literal reported metadata; it does not expose files and can fail a minimum-share rule.
Normal Hubs	Reported normal connected-hub count in the client tag.	Use a value that matches the bot role. Zero is metadata, not a privilege change.
Registered Hubs	Reported registered connected-hub count in the client tag.	Zero does not unregister the bot or change the hub account class.
Operator Hubs	Reported operator connected-hub count in the client tag.	Zero does not remove operator rights, and a positive value does not grant them.
Open Slots	Reported upload-slot count.	Use a realistic value; zero can conflict with hubs requiring slots.
TCP Port	Optional listening TCP-port metadata.	Blank omits it; values from 1 to 65535 report metadata but do not open a server port.
UDP Port	Optional UDP-port metadata for compatible protocols.	Blank omits it; values from 1 to 65535 report metadata but do not create UDP reachability.
TLS Port	Optional secure-listener metadata.	Blank omits it; values from 1 to 65535 do not change whether the hub connection uses NMDCS or ADCS.
Client Description	Optional client identity text.	Keep it short, accurate, and free of secrets; blank omits it.
Client Email	Optional NMDC identity detail.	Leave it blank unless a hub rule requires it; do not use a private mailbox unnecessarily.

NMDC Support Flags

NMDC Support Flags are capabilities advertised during the NMDC/NMDCS $Supports exchange. They do not create a hub capability or permission; they only describe what the client claims it can understand. Use standard defaults unless reproducing a compatibility problem, then reconnect so the next login sends the new advertisement.

Flag	Compatibility Purpose	Use With Care
`NoHello`	Avoids duplicate hello traffic.	Changes the login exchange, not a hub greeting rule.
`NoGetINFO`	Avoids unnecessary per-user GETINFO traffic.	Missing detail is not a permission change.
`UserIP2`	Supports newer user/IP frames.	It does not reveal an address by itself.
`BotList`	Supports bot-list compatibility.	It does not classify every account as a bot.
`FailOver`	Supports redirects and failover.	Do not trust an arbitrary redirect without hub policy.
`NickRule`	Supports nickname-rule exchange.	The hub still decides whether the nickname is valid.
`HubURL`	Supports hub URL exchange.	It is metadata support, not a redirect command.
`ExtJSON2`	Supports extended JSON metadata.	Use only with compatible peers.
`BotINFO`	Supports bot-specific INFO behavior.	Off by default for normal chat-client behavior; enable only for a deliberate bot test.

OpenAI Client

Use Global API Key selects the site's shared key only when global sharing is enabled. With it enabled, the resolver uses global model/provider values for the shared-key request, while local Instructions can still override the global default. Disabling it requires a usable hub-specific direct key or secret reference; otherwise provider requests fail without exposing a secret.

OpenAI API Key is a write-only hub-specific secret. A blank input preserves the current key, and clear removes the direct key and secret reference together. API Key Secret Reference is an environment-variable name, not its secret value; the resolver uses it only when no direct encrypted key is present. A missing or invalid reference resolves to no key.

Model must be allowed by the global policy and affects future cost, latency, reasoning, streaming, tools, and response-format compatibility. Responses API URL, Organization, and Project are optional provider request settings; an incompatible gateway or mismatched ID can return authentication or request errors. Never paste a key into an article, record, log, or screenshot.

Max Output Tokens is a provider output budget, separate from the input-character and hub line limits. It accepts 16 or more; a low value can truncate a reply and a high value can increase cost and latency. Timeout Seconds controls provider requests, not the hub socket. Max Retries controls transient provider retries, not hub reconnect attempts. Instructions are system-level future-response guidance: keep them factual and free of secrets, then test one harmless prompt after saving.

Generation Settings

Temperature accepts values from 0 to 2, and Top P accepts values from 0 to 1. Lower values tend toward repeatability; higher values broaden variation. Change one sampling control at a time because changing both makes a new reply style, cost, or reliability problem difficult to attribute.

Reasoning Effort and Reasoning Summary are model-dependent. Use only values the selected model supports; incompatible combinations fail at the provider. Stream Response controls compatible provider response delivery. Store Response controls provider-side storage and is separate from this application's Log Responses setting. Parallel Tool Calls is provider-facing and does not turn Hub Commands into provider tools.

Advanced OpenAI Payload

Metadata JSON must be an object, Tools JSON an array, Tool Choice the supported plain-text or JSON form value, and Response Format JSON an object. The form validates JSON before saving; correct malformed text instead of silently sending it. Keep examples free of keys, user identifiers, and private hub text.

{"source":"hub-gpt"}

[{"type":"function","name":"lookup_status","parameters":{"type":"object","properties":{}}}]

{"type":"text"}

Tools JSON defines offered provider tools. Tool Choice constrains or selects them, so a choice naming a missing or unsupported tool can fail. Response Format can demand structured output that does not fit normal Direct Connect text; test the complete request and hub-safe rendering before public use.

Rate And Token Limits

Rate Limit Per User is enforced as an hourly cap on provider-backed API questions for the resolved user/nickname identity; zero or blank disables that check. Input Limit is measured in Unicode characters with mb_strlen, not tokens; zero or blank disables the current input check. Both controls reduce accidental loops and abusive prompts before a provider request.

Main Chat Response Line Limit and Private Response Line Limit format a bot reply into hub messages; they are not OpenAI token limits. Zero sends one complete chunk, while a positive value splits output into the configured line-sized chunks. Blank required submissions preserve the saved value.

Rate Limit Per Hub, Daily Token Limit, and Monthly Token Limit are persisted fields, but the current request path does not enforce a hub-wide request or daily/monthly token rejection from them. Use the enforced per-user limit and shared-key allowance for automatic blocking, and Token Usage for daily/monthly cost observation until an implementation explicitly adds enforcement.

Safety Identifier controls whether provider requests receive the application's stable hashed identity; the raw source is not shown. Shared-Key Messages and Shared-Key Period apply only when shared-key use is active. A positive allowance rejects further provider-backed questions for the hub when the hourly, daily, weekly, or monthly period reaches its cap; zero or no value disables it.

Reconnect And Logging

Reconnect Enabled, maximum attempts, and interval govern Direct Connect worker recovery. They are separate from OpenAI Max Retries: reconnect handles the worker/socket, while Max Retries handles provider requests. Avoid a short interval or high attempt count until the endpoint, nickname, password, or TLS problem is understood.

Restart After Deployment and Stop On Deployment govern lifecycle around deployment; they do not guarantee the external hub remains reachable. Log Prompts controls prompt text, Log Responses controls reply text, and Log Private Prompts is an additional private-prompt gate: private text is recorded only when both Log Prompts and Log Private Prompts are enabled. Disabled logging writes an explicit marker instead of the original prompt or response.

OpenAI Store Response is provider-side storage; Log Responses is the application record field. They are independent privacy choices. Restrict record access and do not infer that an empty preview means no external system retained data.

Hub Commands

Global commands are maintained by the site and reserved; hub-specific commands cannot overwrite their names or aliases. A command has a normalized name, aliases, locale, description, and reply template. In main chat address the bot first; in private chat the command can be the entire message. Commands do not grant website administration, request secrets, or reveal another user's conversation.

The table documents the commands currently implemented by the request path. A reply can be localized by the bot's default language or the sender's saved language. A command that cannot meet its prerequisite returns a specific usage, configuration, identity, or provider failure; it must not invent a result.

Command And Invocation	Behavior	Requirements, Storage, And Failure
`help` `HubGPT: help` `help`	Lists the built-in and permitted hub-specific commands available to this bot session, with main-chat and private-message guidance.	It is server-handled and makes no provider request or saved user preference. If an alias or command is not configured for the active locale, use the exact current command name instead.
`usage` `HubGPT usage` `usage`	Explains safe syntax: address the bot in main chat; send an exact command or normal question in a private message.	It is server-handled and stores nothing. It describes the bot's capabilities but cannot override hub access, account class, private-message, or anti-spam rules.
`stats` `HubGPT: stats` `stats`	Shows this bot's stored question and answer counts for 1 day, 1 week, 1 month, and lifetime.	It reads local GPT records and makes no provider request. Counts are activity evidence, not an OpenAI bill or remaining balance; an empty period legitimately shows zero activity.
`about` `HubGPT about` `about`	Explains Hub GPT and links to this localized Hub GPT guide for the assigned hub owner.	It is a static server-handled response and stores no user data. The guide link explains the required hub account, configuration, and access path; it does not create a bot for an unassigned hub.
`locale` `HubGPT: locale pl` `locale pl`	Without an argument it shows the current reply language and supported codes. With a supported code it changes the sender's reply language for this bot and hub.	A normalized hub sender nickname is required to persist the choice. An unsupported code returns the supported-code list; a missing stable sender identity returns an identity failure. It does not change website language, hub configuration, or another user's language.
`weather` `HubGPT weather Warsaw, Poland` `weather`	Returns current conditions and a short forecast for an explicit location, the sender's saved general location, a usable hub-provided public address, or the configured server fallback.	A configured weather provider and a resolvable location are required. Weather does not save a location by itself. An unavailable provider, unresolvable place, broad location that cannot identify one forecast point, or unavailable forecast returns a failure instead of a guessed result.
`location` `HubGPT: location Warsaw, Poland` `location reset`	Resolves and saves a general location for later weather and local-news requests. `location reset` clears it.	A configured weather provider must resolve the supplied place. When a stable identity exists, the saved label, coordinates, and timezone are scoped to the bot and an HMAC identity fingerprint; otherwise the location is available only for the current session. Invalid or broad unresolved locations return a location failure.
`news` `HubGPT news Chicago 50` `news Warsaw, Poland`	Returns configured local headlines for an explicit or resolved location. A final count is bounded by the configured maximum.	A configured news provider is required. News reads a saved location when available but does not create one. If no suitable saved, address-based, or fallback location is available, it uses the configured fallback label; an unavailable provider or empty result returns a service failure.
`sport` `HubGPT sport NBA results` `sport football today`	Requests supported schedules, live events, standings, or completed results. It can ask a clarifying question when sport, date, team, or competition is incomplete.	A configured sports provider and enough searchable criteria are required. The bot keeps a short sport conversation context for follow-up clarification; it expires after 10 minutes and is not the explicit memory list. Missing provider data or incomplete criteria returns a provider failure or clarification, not invented scores.
`remember` `HubGPT: remember I prefer concise answers` `remember I prefer concise answers`	Stores one fact that the sender explicitly asks the bot to retain for future GPT context.	A stable identity and non-empty text are required. The service accepts at most 20 saved facts, each at most 280 characters, scoped to the bot under an HMAC identity fingerprint. It rejects missing identity, oversized text, or a full memory list; ordinary chat is not automatically copied into this store.
`memory` `HubGPT memory` `memory`	Lists only the explicit facts previously saved with `remember`, numbered for deletion.	It reads the sender's scoped memory and changes nothing. An empty list is a normal result; it does not expose another identity's facts or temporary conversation context.
`forget` `HubGPT: forget 1` `forget all`	Deletes one numbered explicit fact, or every explicit fact when given `all`.	A valid positive memory number or `all` is required. An invalid number, unavailable identity, or missing item returns a usage or not-found response. Deletion affects only the saved explicit-memory store, not unrelated records, operational logs, or another user's data.

Custom commands are separate from this built-in list. Keep custom names and aliases distinct from reserved names so a later update cannot change which response a user receives. Do not use templates to claim privileged access, request keys or passwords, or disclose private conversations.

Command Placeholders

Reply templates support only the implemented placeholders below. They resolve when the command is handled, after the bot and locale are known. No placeholder resolves a key, password, raw safety identity, or arbitrary HTML.

Placeholder	Resolved Value	Scope, Empty Value, And Safe Use
`{{ command }}`	The normalized command name that matched the request.	Use it in a reply heading or usage sentence. It is a command identifier, not untrusted prompt text.
`{{ commands }}`	The formatted smart-help list of built-in and permitted hub-specific commands available to this bot session.	Availability depends on the bot configuration and locale. Use it when a full readable list is appropriate; it does not reveal disabled, inaccessible, or private data.
`{{ command_names }}`	The available command names as a comma-separated list.	Use it for compact help. It is names only, not descriptions, aliases, passwords, or arbitrary request content.
`{{ bot_username }}`	The configured bot login nickname.	Use it in examples such as `{{ bot_username }}: help`. A misconfigured or blank nickname must be corrected in Credentials; this placeholder does not create an alias.
`{{ stats }}`	The per-hub GPT activity block for 1 day, 1 week, 1 month, and lifetime.	Use it on a statistics response. It reports stored questions and answers, not provider billing, secrets, or another hub's data.

A safe help template can say {{ bot_username }} accepts: {{ command_names }}. Keep template text factual and readable in a hub client. Missing optional configuration follows the resolver's normal formatting; it is never permission to substitute raw HTML, a secret, or arbitrary user data.

Private Message Diagnostic

Private Message Diagnostic is only for site super administrators. It starts a temporary Hub Chat session with a generated diagnostic nickname, uses the selected hub endpoint and normal client defaults, then sends the fixed request Hub GPT diagnostic request. Reply with a short confirmation. to the bot. The live diagnostic opens in Hub Chat so an operator can inspect the result without reading unrelated user conversations.

Confirm bot nickname, Hub Chat availability, and private-message feature status.
Run the diagnostic as a super administrator.
Wait for the temporary session and the bot reply or visible failure.
Review the error or record if it fails, then close the temporary session.

The diagnostic is not a general chat session and does not bypass hub private-message rules. It is unavailable when Hub Chat or private messages are not enabled, and it can create normal operational evidence.

Service Bot Search Audit

The Service Bot Search Audit is a super-administrator troubleshooting table. It shows Created, Hub Sender, Service Bot, Feature, Correlation ID, Duration, Safety Identity Hash, Outcome, Request, Safe Context, and Response. The safety identity is a shortened hash, not a raw personal identifier. Expand a response only when it exists and treat it as protected operational data.

Use Correlation ID and Duration to relate a rejected or successful lookup to surrounding records. Outcome and reason code explain whether the service accepted, rejected, or failed. Safe Context is deliberately constrained; a missing field is not evidence that it was sent, stored, or safe to disclose.

Column	How To Read It
Created	When the audit entry was recorded in the configured display timezone.
Hub Sender	The hub nickname that triggered the service-bot request.
Service Bot	The configured bot that received or sent the request.
Feature	The implemented lookup or service feature involved.
Correlation ID	The trace identifier used to relate this entry to its surrounding operational evidence.
Duration	The recorded request duration, not a promise of normal provider latency.
Safe Identity Hash	A shortened safe identifier for correlation. It is not the raw account or personal identifier.
Outcome	The recorded result and, when present, a machine-readable reason code.
Request	The bounded request text available to this protected troubleshooting view.
Safe Context	Only approved contextual values. Do not treat absent values as permission to infer or reconstruct data.
Raw Response	A disclosed response is shown only when one was recorded. Expand it only for a necessary investigation.

Recent GPT Records

Recent GPT Records lists the newest bot records. Common columns are Created, Hub Sender, Source, and Status. Administrators also see Input Tokens, Output Tokens, Total Tokens, Question, and Reply. main_chat and private_chat identify the message path. A server-handled command can be successful without provider tokens.

Question and Reply are truncated previews whose visibility depends on logging. Disabled logging writes an explicit marker rather than original text. Blank token values can come from a command, a failed request, a provider response without metrics, or an older record. Use Recent GPT Records for individual events and Token Usage for range totals.

Column	How To Read It
Created	When the bot record was created.
Hub Sender	The nickname associated with the recorded request.
Source	The message path, such as `main_chat` or `private_chat`.
Status	The stored result state. Read it with the record preview and status panel rather than assuming success.
Input Tokens	Provider input tokens when the provider returned that metric.
Output Tokens	Provider output tokens when the provider returned that metric.
Total Tokens	The provider total when reported. It is not a billing invoice.
Question	A logged, truncated request preview when the logging policy permits it.
Reply	A logged, truncated reply preview when the logging policy permits it.

Security And Privacy

Hub passwords and OpenAI keys are protected secrets; saved values are not rendered. A secret reference identifies an environment variable, not its content. Never add secrets to Instructions, command templates, screenshots, raw hub messages, audit notes, or support requests.

Prompt, response, and private-prompt logging have the exact interaction described in Reconnect And Logging. Provider Store Response is separate. Safety identifiers use the configured stable hashed mode without displaying their raw source. Location, language, and remembered-fact commands can store data needed by their implemented services, so users should not submit sensitive information merely because the bot sounds conversational.

Hub GPT Troubleshooting

Problem	Inspect	Recovery
The bot is enabled but disconnected	Status, Last Error, endpoint, nickname, and worker state.	Correct the reported cause, then Connect or Reconnect.
Connect immediately fails	Hub redirect, TLS/protocol mismatch, duplicate nickname, or worker error.	Use the exact endpoint and a unique permitted account.
The hub rejects nickname or password	Registration and protected Hub Password.	Use an authorized bot account and reconnect after saving.
OpenAI key is missing or authentication fails	Global-key choice, sharing policy, direct secret, secret reference, organization, and project.	Provide one authorized key source without exposing it; test a harmless prompt.
The model is not allowed	Global allowed-model policy and selected model.	Choose a compatible allowed model and save.
Requests time out or retry too long	Timeout, Max Retries, provider status, and Recent Records.	Use a reasonable timeout/retry count and test one request.
Main chat or alias gets no reply	Address syntax, nickname/aliases, state, access, and hub permission.	Address with a valid name and separator; correct aliases then save.
Private messages get no reply	Private-message availability, connection, provider, and limits.	Use the diagnostic when authorized or test a permitted account.
A per-user or shared-key limit is exhausted	Per-user rate, shared-key allowance, period, and Token Usage.	Wait for the period, change a deliberate policy limit, or use a private key.
Daily/monthly values do not block requests	The current enforced request path.	Use them for reporting policy; rely on enforced per-user/shared-key caps.
Responses are truncated or split	Max Output Tokens and main/private line limits.	Increase one budget carefully; line limits format hub messages, not tokens.
JSON cannot save or a tool fails	JSON type, model, endpoint, Tools JSON, and Tool Choice.	Validate the smallest compatible object/array first.
The bot repeatedly reconnects	Reconnect setting, attempts, interval, and Last Error.	Fix the underlying hub failure before increasing attempts.
Records or token values are blank	Logging, command status, provider metadata, and record age.	Respect disabled logging; run a controlled provider request for evidence.
A diagnostic or audit is rejected	Super-admin role, feature availability, outcome, reason, and safe context.	Correct the prerequisite; do not use diagnostics to bypass access.

Read Hub Chat for the shared live client, Hub Detail for ownership guidance, and Hub to return to a hub profile. The about command links users to this localized Hub GPT guide.

Parent Page

Return to Hub Detail for the Hub Help index and other Direct Connect administration guides.

Configuration Reference

Configure the GPT bot identity, OpenAI Responses settings, reconnect behavior, and logging policy for this hub.

Bot Identity

Bot Username

Nickname the bot uses to log in to this hub. Keep it unique enough that users can mention it clearly.

Default: Uses the global default when one is configured.
Allowed Values: 1-80
When Blank: A value is required.
When Zero: Not applicable.
Access: The assigned hub owner and site administrators.
Security And Cost: Operational setting; do not use it to claim a permission the hub has not granted.
After Saving: Save persists the setting. Reconnect or restart only when the live client needs the new value.
Related Settings: Bot Alias, Hub Password, Bot Locale, Access Status

Bot Alias

Additional names that address this bot in main chat. The default is gpt. Separate aliases with commas or new lines. They do not change the login nickname, reply language, or saved weather/news location.

Default: Uses the global default when one is configured.
Allowed Values: 0-512
When Blank: No value is sent.
When Zero: Not applicable.
Access: The assigned hub owner and site administrators.
Security And Cost: Operational setting; do not use it to claim a permission the hub has not granted.
After Saving: Save persists the setting. Reconnect or restart only when the live client needs the new value.
Related Settings: Bot Username, Hub Password, Bot Locale, Access Status

Hub Password

Optional. Used for registered NMDC/NMDCS nicknames when the hub requests a password.

Default: Uses the global default when one is configured.
Allowed Values: 0-128
When Blank: Leave blank to keep the saved secret; a new value replaces it.
When Zero: Not applicable.
Access: The assigned hub owner and site administrators.
Security And Cost: Treat this value as a secret. It is write-only and must not be copied into logs or chat.
After Saving: Save persists the setting. Reconnect or restart only when the live client needs the new value.
Related Settings: Bot Username, Bot Alias, Bot Locale, Access Status

Bot Locale

Language used for smart command replies and locale-specific command rows for this hub bot.

Default: Uses the global default when one is configured.
Allowed Values: See the field help and available choices on the configuration page.
When Blank: A value is required.
When Zero: Not applicable.
Access: The assigned hub owner and site administrators.
Security And Cost: Operational setting; do not use it to claim a permission the hub has not granted.
After Saving: Save persists the setting. Reconnect or restart only when the live client needs the new value.
Related Settings: Bot Username, Bot Alias, Hub Password, Access Status

Access Status

Public lets the bot run in the hub. Admin keeps the bot configured for staff review without public use. Hidden stops the bot.

Default: Uses the global default when one is configured.
Allowed Values: See the field help and available choices on the configuration page.
When Blank: A value is required.
When Zero: Not applicable.
Access: The assigned hub owner and site administrators.
Security And Cost: Access
After Saving: Save persists the setting. Reconnect or restart only when the live client needs the new value.
Related Settings: Bot Username, Bot Alias, Hub Password, Bot Locale

Hub Connection

Fake Share

Share size sent to the hub in bytes. Use 0 to test minimum-share restrictions.

Default: Uses the global default when one is configured.
Allowed Values: See the field help and available choices on the configuration page.
When Blank: A value is required.
When Zero: Zero is sent as the configured value.
Access: The assigned hub owner and site administrators.
Security And Cost: Operational setting; do not use it to claim a permission the hub has not granted.
After Saving: Save persists the setting. Reconnect or restart only when the live client needs the new value.
Related Settings: Normal Hubs, Registered Hubs, Operator Hubs, Open Slots

Normal Hubs

Number of normal hubs reported in the client tag.

Default: Uses the global default when one is configured.
Allowed Values: 0-999
When Blank: A value is required.
When Zero: Zero is sent as the configured value.
Access: The assigned hub owner and site administrators.
Security And Cost: Operational setting; do not use it to claim a permission the hub has not granted.
After Saving: Save persists the setting. Reconnect or restart only when the live client needs the new value.
Related Settings: Fake Share, Registered Hubs, Operator Hubs, Open Slots

Registered Hubs

Number of registered hubs reported in the client tag.

Default: Uses the global default when one is configured.
Allowed Values: 0-999
When Blank: A value is required.
When Zero: Zero is sent as the configured value.
Access: The assigned hub owner and site administrators.
Security And Cost: Operational setting; do not use it to claim a permission the hub has not granted.
After Saving: Save persists the setting. Reconnect or restart only when the live client needs the new value.
Related Settings: Fake Share, Normal Hubs, Operator Hubs, Open Slots

Operator Hubs

Number of operator hubs reported in the client tag.

Default: Uses the global default when one is configured.
Allowed Values: 0-999
When Blank: A value is required.
When Zero: Zero is sent as the configured value.
Access: The assigned hub owner and site administrators.
Security And Cost: Operational setting; do not use it to claim a permission the hub has not granted.
After Saving: Save persists the setting. Reconnect or restart only when the live client needs the new value.
Related Settings: Fake Share, Normal Hubs, Registered Hubs, Open Slots

Open Slots

Open upload slots reported to the hub.

Default: Uses the global default when one is configured.
Allowed Values: 0-999
When Blank: A value is required.
When Zero: Zero is sent as the configured value.
Access: The assigned hub owner and site administrators.
Security And Cost: Operational setting; do not use it to claim a permission the hub has not granted.
After Saving: Save persists the setting. Reconnect or restart only when the live client needs the new value.
Related Settings: Fake Share, Normal Hubs, Registered Hubs, Operator Hubs

TCP Port

Optional TCP listening port exposed in ADC client information.

Default: Uses the global default when one is configured.
Allowed Values: 1-65535
When Blank: No value is sent.
When Zero: Zero is not a valid value.
Access: The assigned hub owner and site administrators.
Security And Cost: Operational setting; do not use it to claim a permission the hub has not granted.
After Saving: Save persists the setting. Reconnect or restart only when the live client needs the new value.
Related Settings: Fake Share, Normal Hubs, Registered Hubs, Operator Hubs

UDP Port

Optional UDP listening port exposed in ADC client information.

Default: Uses the global default when one is configured.
Allowed Values: 1-65535
When Blank: No value is sent.
When Zero: Zero is not a valid value.
Access: The assigned hub owner and site administrators.
Security And Cost: Operational setting; do not use it to claim a permission the hub has not granted.
After Saving: Save persists the setting. Reconnect or restart only when the live client needs the new value.
Related Settings: Fake Share, Normal Hubs, Registered Hubs, Operator Hubs

TLS Port

Optional TLS listening port exposed in ADC client information.

Default: Uses the global default when one is configured.
Allowed Values: 1-65535
When Blank: No value is sent.
When Zero: Zero is not a valid value.
Access: The assigned hub owner and site administrators.
Security And Cost: Operational setting; do not use it to claim a permission the hub has not granted.
After Saving: Save persists the setting. Reconnect or restart only when the live client needs the new value.
Related Settings: Fake Share, Normal Hubs, Registered Hubs, Operator Hubs

Client Description

Optional description exposed to the hub as the diagnostic client description.

Default: Uses the global default when one is configured.
Allowed Values: 0-120
When Blank: No value is sent.
When Zero: Not applicable.
Access: The assigned hub owner and site administrators.
Security And Cost: May identify a person or expose operational context; keep it minimal.
After Saving: Save persists the setting. Reconnect or restart only when the live client needs the new value.
Related Settings: Fake Share, Normal Hubs, Registered Hubs, Operator Hubs

Client Email

Optional email field exposed to NMDC hubs.

Default: Uses the global default when one is configured.
Allowed Values: 0-64
When Blank: No value is sent.
When Zero: Not applicable.
Access: The assigned hub owner and site administrators.
Security And Cost: May identify a person or expose operational context; keep it minimal.
After Saving: Save persists the setting. Reconnect or restart only when the live client needs the new value.
Related Settings: Fake Share, Normal Hubs, Registered Hubs, Operator Hubs

NMDC Support Flags

Choose the NMDC $Supports flags sent during login. BotINFO is off by default for normal chat-client behavior.

Default: Uses the global default when one is configured.
Allowed Values: See the field help and available choices on the configuration page.
When Blank: Uses the global default when one is configured.
When Zero: Not applicable.
Access: The assigned hub owner and site administrators.
Security And Cost: Operational setting; do not use it to claim a permission the hub has not granted.
After Saving: Save persists the setting. Reconnect or restart only when the live client needs the new value.
Related Settings: Fake Share, Normal Hubs, Registered Hubs, Operator Hubs

NMDC Support Flags

Choose the NMDC $Supports flags sent during login. BotINFO is off by default for normal chat-client behavior.

NoHello: Advertises the faster login flow in which the hub can omit a separate $Hello exchange. It is part of the normal default profile; disable it only when reproducing an older handshake. It does not authenticate the account.
NoGetINFO: Advertises support for a fast initial user list without individual $GetINFO requests. Keep it for a normal connection; disable it only while diagnosing legacy user-list behavior.
UserIP2: Advertises support for extended user and IP information. A hub may then send address data, so use it only when that handling is appropriate for the test. It grants no access or operator permission.
BotList: Advertises support for the $BotList frame and bot markers in the Guests list. It is a normal default; disable it only when testing an older parser or hub profile.
FailOver: Advertises support for hub-directed failover or redirect behavior. The flag does not make the client follow arbitrary addresses; the client connection policy still applies.
NickRule: Advertises that the client understands nickname rules sent by the hub. It helps the client report validation correctly, but it never overrides the hub rule.
HubURL: Advertises hub-URL exchange. When the hub sends $GetHubURL, this client sends one $MyHubURL built from the configured endpoint. Disable it only for a compatibility test.
ExtJSON2: Advertises compatibility with extended JSON metadata. The flag does not send JSON by itself; enable it only when the hub supports the format being tested.
BotINFO: Advertises bot-client behavior. Leave it disabled for normal chat-client behavior unless you are testing a bot-specific hub rule.

OpenAI Client

Use Global API Key

Use the shared global OpenAI key for this hub. Disable this when the hub owner provides a hub-specific key or secret reference.

Default: Uses the global default when one is configured.
Allowed Values: See the field help and available choices on the configuration page.
When Blank: Uses the global default when one is configured.
When Zero: Not applicable.
Access: The assigned hub owner and site administrators.
Security And Cost: Can change provider usage or billing. Review usage before raising it.
After Saving: Save persists the setting. Reconnect or restart only when the live client needs the new value.
Related Settings: OpenAI API Key, API Key Secret Reference, Responses API URL, Organization

OpenAI API Key

Stored for this hub only. Leave blank to keep the current key.

Default: Uses the global default when one is configured.
Allowed Values: See the field help and available choices on the configuration page.
When Blank: Leave blank to keep the saved secret; a new value replaces it.
When Zero: Not applicable.
Access: The assigned hub owner and site administrators.
Security And Cost: Treat this value as a secret. It is write-only and must not be copied into logs or chat.
After Saving: Save persists the setting. Reconnect or restart only when the live client needs the new value.
Related Settings: Use Global API Key, API Key Secret Reference, Responses API URL, Organization

API Key Secret Reference

Optional environment variable name for this hub key. Direct keys and secret values are never rendered here.

Default: Uses the global default when one is configured.
Allowed Values: 0-255
When Blank: No value is sent.
When Zero: Not applicable.
Access: The assigned hub owner and site administrators.
Security And Cost: Treat this value as a secret. It is write-only and must not be copied into logs or chat.
After Saving: Save persists the setting. Reconnect or restart only when the live client needs the new value.
Related Settings: Use Global API Key, OpenAI API Key, Responses API URL, Organization

Responses API URL

OpenAI-compatible Responses API endpoint. Leave the default unless this hub uses a compatible gateway.

Default: Uses the global default when one is configured.
Allowed Values: See the field help and available choices on the configuration page.
When Blank: Uses the global default when one is configured.
When Zero: Not applicable.
Access: The assigned hub owner and site administrators.
Security And Cost: Can change provider usage or billing. Review usage before raising it.
After Saving: Save persists the setting. Reconnect or restart only when the live client needs the new value.
Related Settings: Use Global API Key, OpenAI API Key, API Key Secret Reference, Organization

Organization

Optional OpenAI organization ID for this hub key.

Default: Uses the global default when one is configured.
Allowed Values: 0-120
When Blank: No value is sent.
When Zero: Not applicable.
Access: The assigned hub owner and site administrators.
Security And Cost: Can change provider usage or billing. Review usage before raising it.
After Saving: Save persists the setting. Reconnect or restart only when the live client needs the new value.
Related Settings: Use Global API Key, OpenAI API Key, API Key Secret Reference, Responses API URL

Project

Optional OpenAI project ID for this hub key.

Default: Uses the global default when one is configured.
Allowed Values: 0-120
When Blank: No value is sent.
When Zero: Not applicable.
Access: The assigned hub owner and site administrators.
Security And Cost: Can change provider usage or billing. Review usage before raising it.
After Saving: Save persists the setting. Reconnect or restart only when the live client needs the new value.
Related Settings: Use Global API Key, OpenAI API Key, API Key Secret Reference, Responses API URL

Model

Only models allowed by global Hub GPT settings can be selected here.

Default: Uses the global default when one is configured.
Allowed Values: See the field help and available choices on the configuration page.
When Blank: Uses the global default when one is configured.
When Zero: Not applicable.
Access: The assigned hub owner and site administrators.
Security And Cost: Can change provider usage or billing. Review usage before raising it.
After Saving: Save persists the setting. Reconnect or restart only when the live client needs the new value.
Related Settings: Use Global API Key, OpenAI API Key, API Key Secret Reference, Responses API URL

Generation Settings

Instructions

System-level behavior for this hub bot: tone, boundaries, what it should answer, and what it should avoid.

Default: Uses the global default when one is configured.
Allowed Values: See the field help and available choices on the configuration page.
When Blank: Uses the global default when one is configured.
When Zero: Not applicable.
Access: The assigned hub owner and site administrators.
Security And Cost: May identify a person or expose operational context; keep it minimal.
After Saving: Save persists the setting. Reconnect or restart only when the live client needs the new value.
Related Settings: Max Output Tokens, Timeout Seconds, Max Retries, Temperature

Max Output Tokens

Upper token budget for one answer. Lower values reduce cost and keep hub replies shorter.

Default: Uses the global default when one is configured.
Allowed Values: 16+
When Blank: Uses the global default when one is configured.
When Zero: Zero is not a valid value.
Access: The assigned hub owner and site administrators.
Security And Cost: Can change provider usage or billing. Review usage before raising it.
After Saving: Save persists the setting. Reconnect or restart only when the live client needs the new value.
Related Settings: Instructions, Timeout Seconds, Max Retries, Temperature

Timeout Seconds

Maximum seconds to wait for one OpenAI request before treating it as failed.

Default: Uses the global default when one is configured.
Allowed Values: 1+
When Blank: Uses the global default when one is configured.
When Zero: Zero is not a valid value.
Access: The assigned hub owner and site administrators.
Security And Cost: Operational setting; do not use it to claim a permission the hub has not granted.
After Saving: Save persists the setting. Reconnect or restart only when the live client needs the new value.
Related Settings: Instructions, Max Output Tokens, Max Retries, Temperature

Max Retries

Number of OpenAI request retry attempts after transient API failures.

Default: Uses the global default when one is configured.
Allowed Values: 0+
When Blank: Uses the global default when one is configured.
When Zero: Zero is sent as the configured value.
Access: The assigned hub owner and site administrators.
Security And Cost: Can change provider usage or billing. Review usage before raising it.
After Saving: Save persists the setting. Reconnect or restart only when the live client needs the new value.
Related Settings: Instructions, Max Output Tokens, Timeout Seconds, Temperature

Temperature

Creativity control from 0 to 2. Lower values are steadier; higher values are more varied.

Default: Uses the global default when one is configured.
Allowed Values: 0-2
When Blank: Uses the global default when one is configured.
When Zero: Zero is sent as the configured value.
Access: The assigned hub owner and site administrators.
Security And Cost: Can change provider usage or billing. Review usage before raising it.
After Saving: Save persists the setting. Reconnect or restart only when the live client needs the new value.
Related Settings: Instructions, Max Output Tokens, Timeout Seconds, Max Retries

Top P

Alternative sampling control from 0 to 1. Usually leave blank unless you know this model needs it.

Default: Uses the global default when one is configured.
Allowed Values: 0-1
When Blank: Uses the global default when one is configured.
When Zero: Zero is sent as the configured value.
Access: The assigned hub owner and site administrators.
Security And Cost: Can change provider usage or billing. Review usage before raising it.
After Saving: Save persists the setting. Reconnect or restart only when the live client needs the new value.
Related Settings: Instructions, Max Output Tokens, Timeout Seconds, Max Retries

Reasoning Effort

Optional model reasoning setting, such as low, medium, or high, when the selected model supports it.

Default: Uses the global default when one is configured.
Allowed Values: See the field help and available choices on the configuration page.
When Blank: Uses the global default when one is configured.
When Zero: Not applicable.
Access: The assigned hub owner and site administrators.
Security And Cost: Can change provider usage or billing. Review usage before raising it.
After Saving: Save persists the setting. Reconnect or restart only when the live client needs the new value.
Related Settings: Instructions, Max Output Tokens, Timeout Seconds, Max Retries

Reasoning Summary

Optional reasoning summary setting for models that support summaries.

Default: Uses the global default when one is configured.
Allowed Values: See the field help and available choices on the configuration page.
When Blank: Uses the global default when one is configured.
When Zero: Not applicable.
Access: The assigned hub owner and site administrators.
Security And Cost: Can change provider usage or billing. Review usage before raising it.
After Saving: Save persists the setting. Reconnect or restart only when the live client needs the new value.
Related Settings: Instructions, Max Output Tokens, Timeout Seconds, Max Retries

Stream Response

Stream model output when supported. Disable if the hub connector needs complete replies before sending.

Default: Uses the global default when one is configured.
Allowed Values: See the field help and available choices on the configuration page.
When Blank: Uses the global default when one is configured.
When Zero: Not applicable.
Access: The assigned hub owner and site administrators.
Security And Cost: Operational setting; do not use it to claim a permission the hub has not granted.
After Saving: Save persists the setting. Reconnect or restart only when the live client needs the new value.
Related Settings: Instructions, Max Output Tokens, Timeout Seconds, Max Retries

Store Response

Controls the OpenAI store flag. Provider Default leaves storage behavior to the configured API provider.

Default: The provider default is used.
Allowed Values: See the field help and available choices on the configuration page.
When Blank: The provider default is used.
When Zero: Not applicable.
Access: The assigned hub owner and site administrators.
Security And Cost: May identify a person or expose operational context; keep it minimal.
After Saving: Save persists the setting. Reconnect or restart only when the live client needs the new value.
Related Settings: Instructions, Max Output Tokens, Timeout Seconds, Max Retries

Advanced OpenAI Payload

Parallel Tool Calls

Provider default is safest. Enable or disable only when a model/tool setup requires a specific value.

Default: Uses the global default when one is configured.
Allowed Values: See the field help and available choices on the configuration page.
When Blank: Uses the global default when one is configured.
When Zero: Not applicable.
Access: The assigned hub owner and site administrators.
Security And Cost: Can change provider usage or billing. Review usage before raising it.
After Saving: Save persists the setting. Reconnect or restart only when the live client needs the new value.
Related Settings: Metadata JSON, Tools JSON, Tool Choice, Response Format JSON

Metadata JSON

Optional JSON object sent as Responses API metadata.

Default: Uses the global default when one is configured.
Allowed Values: See the field help and available choices on the configuration page.
When Blank: Uses the global default when one is configured.
When Zero: Not applicable.
Access: The assigned hub owner and site administrators.
Security And Cost: May identify a person or expose operational context; keep it minimal.
After Saving: Save persists the setting. Reconnect or restart only when the live client needs the new value.
Related Settings: Parallel Tool Calls, Tools JSON, Tool Choice, Response Format JSON

Tools JSON

Optional JSON array of Responses API tool definitions.

Default: Uses the global default when one is configured.
Allowed Values: See the field help and available choices on the configuration page.
When Blank: Uses the global default when one is configured.
When Zero: Not applicable.
Access: The assigned hub owner and site administrators.
Security And Cost: Can change provider usage or billing. Review usage before raising it.
After Saving: Save persists the setting. Reconnect or restart only when the live client needs the new value.
Related Settings: Parallel Tool Calls, Metadata JSON, Tool Choice, Response Format JSON

Tool Choice

Use a plain value like auto, or a JSON object for a specific tool choice.

Default: Uses the global default when one is configured.
Allowed Values: See the field help and available choices on the configuration page.
When Blank: Uses the global default when one is configured.
When Zero: Not applicable.
Access: The assigned hub owner and site administrators.
Security And Cost: Can change provider usage or billing. Review usage before raising it.
After Saving: Save persists the setting. Reconnect or restart only when the live client needs the new value.
Related Settings: Parallel Tool Calls, Metadata JSON, Tools JSON, Response Format JSON

Response Format JSON

Optional JSON object for the Responses API response_format option.

Default: Uses the global default when one is configured.
Allowed Values: See the field help and available choices on the configuration page.
When Blank: Uses the global default when one is configured.
When Zero: Not applicable.
Access: The assigned hub owner and site administrators.
Security And Cost: Can change provider usage or billing. Review usage before raising it.
After Saving: Save persists the setting. Reconnect or restart only when the live client needs the new value.
Related Settings: Parallel Tool Calls, Metadata JSON, Tools JSON, Tool Choice

Rate And Token Limits

Rate Limit Per User

Maximum GPT requests one hub nickname may send per hour. Keep this enabled to prevent automated misuse.

Default: Uses the global default when one is configured.
Allowed Values: 0+
When Blank: Uses the global default when one is configured.
When Zero: Zero disables this limit.
Access: The assigned hub owner and site administrators.
Security And Cost: Can change provider usage or billing. Review usage before raising it.
After Saving: Save persists the setting. Reconnect or restart only when the live client needs the new value.
Related Settings: Rate Limit Per Hub, Main Chat Reply Line Limit, Private Reply Line Limit, Input Limit

Rate Limit Per Hub

Maximum GPT requests allowed for this hub during the active rate-limit window. Use 0 or blank for no cap.

Default: Uses the global default when one is configured.
Allowed Values: 0+
When Blank: Uses the global default when one is configured.
When Zero: Zero disables this limit.
Access: The assigned hub owner and site administrators.
Security And Cost: Can change provider usage or billing. Review usage before raising it.
After Saving: Save persists the setting. Reconnect or restart only when the live client needs the new value.
Related Settings: Rate Limit Per User, Main Chat Reply Line Limit, Private Reply Line Limit, Input Limit

Main Chat Reply Line Limit

Maximum lines sent in one public chat message. Use 0 to send the complete reply in one message.

Default: Uses the global default when one is configured.
Allowed Values: 0+
When Blank: A value is required.
When Zero: Zero is sent as the configured value.
Access: The assigned hub owner and site administrators.
Security And Cost: Operational setting; do not use it to claim a permission the hub has not granted.
After Saving: Save persists the setting. Reconnect or restart only when the live client needs the new value.
Related Settings: Rate Limit Per User, Rate Limit Per Hub, Private Reply Line Limit, Input Limit

Private Reply Line Limit

Maximum lines sent in one private message. Use 0 to send the complete reply in one message.

Default: Uses the global default when one is configured.
Allowed Values: 0+
When Blank: A value is required.
When Zero: Zero is sent as the configured value.
Access: The assigned hub owner and site administrators.
Security And Cost: May identify a person or expose operational context; keep it minimal.
After Saving: Save persists the setting. Reconnect or restart only when the live client needs the new value.
Related Settings: Rate Limit Per User, Rate Limit Per Hub, Main Chat Reply Line Limit, Input Limit

Input Limit

Maximum characters accepted from one prompt before the bot calls OpenAI. Use 0 or blank to disable the cap.

Default: Uses the global default when one is configured.
Allowed Values: 0+
When Blank: Uses the global default when one is configured.
When Zero: Zero disables this limit.
Access: The assigned hub owner and site administrators.
Security And Cost: Can change provider usage or billing. Review usage before raising it.
After Saving: Save persists the setting. Reconnect or restart only when the live client needs the new value.
Related Settings: Rate Limit Per User, Rate Limit Per Hub, Main Chat Reply Line Limit, Private Reply Line Limit

Safety Identifier

Controls whether OpenAI receives a stable hashed identifier for the user who triggered the request.

Default: Uses the global default when one is configured.
Allowed Values: See the field help and available choices on the configuration page.
When Blank: A value is required.
When Zero: Not applicable.
Access: The assigned hub owner and site administrators.
Security And Cost: May identify a person or expose operational context; keep it minimal.
After Saving: Save persists the setting. Reconnect or restart only when the live client needs the new value.
Related Settings: Rate Limit Per User, Rate Limit Per Hub, Main Chat Reply Line Limit, Private Reply Line Limit

Daily Token Limit

Maximum tokens this hub bot may spend per day. Use 0 or leave blank for no daily cap.

Default: No per-hub limit is set.
Allowed Values: 0+
When Blank: No per-hub limit is set.
When Zero: Zero disables this limit.
Access: The assigned hub owner and site administrators.
Security And Cost: Can change provider usage or billing. Review usage before raising it.
After Saving: Save persists the setting. Reconnect or restart only when the live client needs the new value.
Related Settings: Rate Limit Per User, Rate Limit Per Hub, Main Chat Reply Line Limit, Private Reply Line Limit

Monthly Token Limit

Maximum tokens this hub bot may spend per calendar month. Use 0 or leave blank for no monthly cap.

Default: No per-hub limit is set.
Allowed Values: 0+
When Blank: No per-hub limit is set.
When Zero: Zero disables this limit.
Access: The assigned hub owner and site administrators.
Security And Cost: Can change provider usage or billing. Review usage before raising it.
After Saving: Save persists the setting. Reconnect or restart only when the live client needs the new value.
Related Settings: Rate Limit Per User, Rate Limit Per Hub, Main Chat Reply Line Limit, Private Reply Line Limit

Shared-Key Messages

Maximum OpenAI requests this hub may send during the selected shared-key period when it uses the global key. Leave blank to use the global default.

Default: Uses the global default when one is configured.
Allowed Values: 0+
When Blank: Uses the global default when one is configured.
When Zero: Zero disables this limit.
Access: Site administrators.
Security And Cost: Can change provider usage or billing. Review usage before raising it.
After Saving: Save persists the setting. Reconnect or restart only when the live client needs the new value.
Related Settings: Rate Limit Per User, Rate Limit Per Hub, Main Chat Reply Line Limit, Private Reply Line Limit

Shared-Key Period

Time window used for this hub shared-key message limit.

Default: Uses the global default when one is configured.
Allowed Values: See the field help and available choices on the configuration page.
When Blank: A value is required.
When Zero: Not applicable.
Access: Site administrators.
Security And Cost: Can change provider usage or billing. Review usage before raising it.
After Saving: Save persists the setting. Reconnect or restart only when the live client needs the new value.
Related Settings: Rate Limit Per User, Rate Limit Per Hub, Main Chat Reply Line Limit, Private Reply Line Limit

Reconnect And Logging

Reconnect Enabled

Let the bot reconnect automatically after a disconnect or transient hub failure.

Default: Uses the global default when one is configured.
Allowed Values: See the field help and available choices on the configuration page.
When Blank: Not applicable.
When Zero: Not applicable.
Access: The assigned hub owner and site administrators.
Security And Cost: Operational setting; do not use it to claim a permission the hub has not granted.
After Saving: Save persists the setting. Reconnect or restart only when the live client needs the new value.
Related Settings: Reconnect Max Attempts, Reconnect Interval Seconds, Restart After Deployment, Stop On Deployment

Reconnect Max Attempts

Maximum reconnect attempts before the bot stays stopped for manual review.

Default: Uses the global default when one is configured.
Allowed Values: 0+
When Blank: A value is required.
When Zero: Zero is sent as the configured value.
Access: The assigned hub owner and site administrators.
Security And Cost: Operational setting; do not use it to claim a permission the hub has not granted.
After Saving: Save persists the setting. Reconnect or restart only when the live client needs the new value.
Related Settings: Reconnect Enabled, Reconnect Interval Seconds, Restart After Deployment, Stop On Deployment

Reconnect Interval Seconds

Seconds to wait between reconnect attempts.

Default: Uses the global default when one is configured.
Allowed Values: 1+
When Blank: A value is required.
When Zero: Zero is not a valid value.
Access: The assigned hub owner and site administrators.
Security And Cost: Operational setting; do not use it to claim a permission the hub has not granted.
After Saving: Save persists the setting. Reconnect or restart only when the live client needs the new value.
Related Settings: Reconnect Enabled, Reconnect Max Attempts, Restart After Deployment, Stop On Deployment

Restart After Deployment

Reconnect this bot after deployments if it was expected to be running.

Default: Uses the global default when one is configured.
Allowed Values: See the field help and available choices on the configuration page.
When Blank: Not applicable.
When Zero: Not applicable.
Access: The assigned hub owner and site administrators.
Security And Cost: Operational setting; do not use it to claim a permission the hub has not granted.
After Saving: Save persists the setting. Reconnect or restart only when the live client needs the new value.
Related Settings: Reconnect Enabled, Reconnect Max Attempts, Reconnect Interval Seconds, Stop On Deployment

Stop On Deployment

Stop this bot before deployment work so it can be restarted cleanly afterward.

Default: Uses the global default when one is configured.
Allowed Values: See the field help and available choices on the configuration page.
When Blank: Not applicable.
When Zero: Not applicable.
Access: The assigned hub owner and site administrators.
Security And Cost: Operational setting; do not use it to claim a permission the hub has not granted.
After Saving: Save persists the setting. Reconnect or restart only when the live client needs the new value.
Related Settings: Reconnect Enabled, Reconnect Max Attempts, Reconnect Interval Seconds, Restart After Deployment

Log Prompts

Store prompt text in GPT records. Disable this when you need less retention.

Default: Uses the global default when one is configured.
Allowed Values: See the field help and available choices on the configuration page.
When Blank: Not applicable.
When Zero: Not applicable.
Access: The assigned hub owner and site administrators.
Security And Cost: May identify a person or expose operational context; keep it minimal.
After Saving: Save persists the setting. Reconnect or restart only when the live client needs the new value.
Related Settings: Reconnect Enabled, Reconnect Max Attempts, Reconnect Interval Seconds, Restart After Deployment

Log Responses

Store generated reply text in GPT records. Disable this when you only need counters and errors.

Default: Uses the global default when one is configured.
Allowed Values: See the field help and available choices on the configuration page.
When Blank: Not applicable.
When Zero: Not applicable.
Access: The assigned hub owner and site administrators.
Security And Cost: May identify a person or expose operational context; keep it minimal.
After Saving: Save persists the setting. Reconnect or restart only when the live client needs the new value.
Related Settings: Reconnect Enabled, Reconnect Max Attempts, Reconnect Interval Seconds, Restart After Deployment

Log Private Prompts

Store private-message GPT prompts in GPT records for audit and troubleshooting.

Default: Uses the global default when one is configured.
Allowed Values: See the field help and available choices on the configuration page.
When Blank: Not applicable.
When Zero: Not applicable.
Access: The assigned hub owner and site administrators.
Security And Cost: May identify a person or expose operational context; keep it minimal.
After Saving: Save persists the setting. Reconnect or restart only when the live client needs the new value.
Related Settings: Reconnect Enabled, Reconnect Max Attempts, Reconnect Interval Seconds, Restart After Deployment

Global Hub GPT Settings

Configure the shared GPT defaults, allowed model policy, and global commands that every hub bot must respect.

Global Hub GPT Settings

Status

Public runs the global Hub GPT feature. Admin keeps settings visible to staff only. Hidden disables public bot use.

Default: This is the site-wide default. New bot configurations start with it unless a hub overrides the setting.
Allowed Values: See the field help and available choices on the configuration page.
When Blank: A value is required.
When Zero: Not applicable.
Access: Site administrators.
Security And Cost: Access
After Saving: Not applicable.
Related Settings: Hub GPT Access, Hub Chat Access

Hub GPT Access

Controls whether hub owners may administer the one primary GPT bot for hubs they own.

Default: This is the site-wide default. New bot configurations start with it unless a hub overrides the setting.
Allowed Values: See the field help and available choices on the configuration page.
When Blank: A value is required.
When Zero: Not applicable.
Access: Site administrators.
Security And Cost: Access
After Saving: Not applicable.
Related Settings: Status, Hub Chat Access

Hub Chat Access

Controls whether hub owners may open one reusable Chat session for each hub they own.

Default: This is the site-wide default. New bot configurations start with it unless a hub overrides the setting.
Allowed Values: See the field help and available choices on the configuration page.
When Blank: A value is required.
When Zero: Not applicable.
Access: Site administrators.
Security And Cost: Access
After Saving: Not applicable.
Related Settings: Status, Hub GPT Access

GPT Client Defaults

Default Bot Username

Default: This is the site-wide default. New bot configurations start with it unless a hub overrides the setting.
Allowed Values: 1-80
When Blank: A value is required.
When Zero: Not applicable.
Access: Site administrators.
Security And Cost: Operational setting; do not use it to claim a permission the hub has not granted.
After Saving: Not applicable.
Related Settings: Default Bot Alias, Default Fake Share, Default Normal Hubs, Default Registered Hubs

Default Bot Alias

Additional names that address a newly created bot in main chat. Separate aliases with commas or new lines.

Default: This is the site-wide default. New bot configurations start with it unless a hub overrides the setting.
Allowed Values: 0-512
When Blank: No value is sent.
When Zero: Not applicable.
Access: Site administrators.
Security And Cost: Operational setting; do not use it to claim a permission the hub has not granted.
After Saving: Not applicable.
Related Settings: Default Bot Username, Default Fake Share, Default Normal Hubs, Default Registered Hubs

Default Fake Share

Share size announced by a newly created GPT client. Use 0 when the bot does not share files.

Default: This is the site-wide default. New bot configurations start with it unless a hub overrides the setting.
Allowed Values: See the field help and available choices on the configuration page.
When Blank: A value is required.
When Zero: Zero is sent as the configured value.
Access: Site administrators.
Security And Cost: Operational setting; do not use it to claim a permission the hub has not granted.
After Saving: Not applicable.
Related Settings: Default Bot Username, Default Bot Alias, Default Normal Hubs, Default Registered Hubs

Default Normal Hubs

Normal hub count announced by a newly created GPT client.

Default: This is the site-wide default. New bot configurations start with it unless a hub overrides the setting.
Allowed Values: 0-999
When Blank: A value is required.
When Zero: Zero is sent as the configured value.
Access: Site administrators.
Security And Cost: Operational setting; do not use it to claim a permission the hub has not granted.
After Saving: Not applicable.
Related Settings: Default Bot Username, Default Bot Alias, Default Fake Share, Default Registered Hubs

Default Registered Hubs

Registered hub count announced by a newly created GPT client.

Default: This is the site-wide default. New bot configurations start with it unless a hub overrides the setting.
Allowed Values: 0-999
When Blank: A value is required.
When Zero: Zero is sent as the configured value.
Access: Site administrators.
Security And Cost: Operational setting; do not use it to claim a permission the hub has not granted.
After Saving: Not applicable.
Related Settings: Default Bot Username, Default Bot Alias, Default Fake Share, Default Normal Hubs

Default Operator Hubs

Operator hub count announced by a newly created GPT client.

Default: This is the site-wide default. New bot configurations start with it unless a hub overrides the setting.
Allowed Values: 0-999
When Blank: A value is required.
When Zero: Zero is sent as the configured value.
Access: Site administrators.
Security And Cost: Operational setting; do not use it to claim a permission the hub has not granted.
After Saving: Not applicable.
Related Settings: Default Bot Username, Default Bot Alias, Default Fake Share, Default Normal Hubs

Default Open Slots

Open slot count announced by a newly created GPT client. Use 0 for the bot.

Default: This is the site-wide default. New bot configurations start with it unless a hub overrides the setting.
Allowed Values: 0-999
When Blank: A value is required.
When Zero: Zero is sent as the configured value.
Access: Site administrators.
Security And Cost: Operational setting; do not use it to claim a permission the hub has not granted.
After Saving: Not applicable.
Related Settings: Default Bot Username, Default Bot Alias, Default Fake Share, Default Normal Hubs

Default NMDC Support Flags

NMDC $Supports flags sent by a newly created GPT client. Leave BotINFO disabled for normal chat-client behavior.

Default: This is the site-wide default. New bot configurations start with it unless a hub overrides the setting.
Allowed Values: See the field help and available choices on the configuration page.
When Blank: No value is sent.
When Zero: Not applicable.
Access: Site administrators.
Security And Cost: Operational setting; do not use it to claim a permission the hub has not granted.
After Saving: Not applicable.
Related Settings: Default Bot Username, Default Bot Alias, Default Fake Share, Default Normal Hubs

NMDC Support Flags

Choose the NMDC $Supports flags sent during login. BotINFO is off by default for normal chat-client behavior.

NoHello: Advertises the faster login flow in which the hub can omit a separate $Hello exchange. It is part of the normal default profile; disable it only when reproducing an older handshake. It does not authenticate the account.
NoGetINFO: Advertises support for a fast initial user list without individual $GetINFO requests. Keep it for a normal connection; disable it only while diagnosing legacy user-list behavior.
UserIP2: Advertises support for extended user and IP information. A hub may then send address data, so use it only when that handling is appropriate for the test. It grants no access or operator permission.
BotList: Advertises support for the $BotList frame and bot markers in the Guests list. It is a normal default; disable it only when testing an older parser or hub profile.
FailOver: Advertises support for hub-directed failover or redirect behavior. The flag does not make the client follow arbitrary addresses; the client connection policy still applies.
NickRule: Advertises that the client understands nickname rules sent by the hub. It helps the client report validation correctly, but it never overrides the hub rule.
HubURL: Advertises hub-URL exchange. When the hub sends $GetHubURL, this client sends one $MyHubURL built from the configured endpoint. Disable it only for a compatibility test.
ExtJSON2: Advertises compatibility with extended JSON metadata. The flag does not send JSON by itself; enable it only when the hub supports the format being tested.
BotINFO: Advertises bot-client behavior. Leave it disabled for normal chat-client behavior unless you are testing a bot-specific hub rule.

Global OpenAI Provider

Default Model

This model is applied to new hub bots unless a specific hub is configured to use another allowed model.

Default: The provider default is used.
Allowed Values: See the field help and available choices on the configuration page.
When Blank: The provider default is used.
When Zero: Not applicable.
Access: Site administrators.
Security And Cost: Can change provider usage or billing. Review usage before raising it.
After Saving: Not applicable.
Related Settings: Global OpenAI API Key, Global API Key Secret Reference, Global Responses API URL, Organization

Global OpenAI API Key

Write-only shared Secret Key for OpenAI model sync and hubs allowed to use the global key. Paste the sk- value from the Secret Key column. Do not paste the key- Tracking ID. Leave blank to keep the current saved key.

Default: This is the site-wide default. New bot configurations start with it unless a hub overrides the setting.
Allowed Values: See the field help and available choices on the configuration page.
When Blank: Leave blank to keep the saved secret; a new value replaces it.
When Zero: Not applicable.
Access: Site administrators.
Security And Cost: Treat this value as a secret. It is write-only and must not be copied into logs or chat.
After Saving: Not applicable.
Related Settings: Default Model, Global API Key Secret Reference, Global Responses API URL, Organization

Global API Key Secret Reference

Optional environment variable name for the shared OpenAI key. Direct keys and secret values are never rendered here.

Default: This is the site-wide default. New bot configurations start with it unless a hub overrides the setting.
Allowed Values: 0-255
When Blank: No value is sent.
When Zero: Not applicable.
Access: Site administrators.
Security And Cost: Treat this value as a secret. It is write-only and must not be copied into logs or chat.
After Saving: Not applicable.
Related Settings: Default Model, Global OpenAI API Key, Global Responses API URL, Organization

Global Responses API URL

Shared OpenAI-compatible Responses API endpoint. Model sync uses the same host with /v1/models.

Default: The provider default is used.
Allowed Values: See the field help and available choices on the configuration page.
When Blank: The provider default is used.
When Zero: Not applicable.
Access: Site administrators.
Security And Cost: Can change provider usage or billing. Review usage before raising it.
After Saving: Not applicable.
Related Settings: Default Model, Global OpenAI API Key, Global API Key Secret Reference, Organization

Organization

Optional OpenAI organization ID for the shared key.

Default: This is the site-wide default. New bot configurations start with it unless a hub overrides the setting.
Allowed Values: 0-120
When Blank: No value is sent.
When Zero: Not applicable.
Access: Site administrators.
Security And Cost: Can change provider usage or billing. Review usage before raising it.
After Saving: Not applicable.
Related Settings: Default Model, Global OpenAI API Key, Global API Key Secret Reference, Global Responses API URL

Project

Optional OpenAI project ID for the shared key.

Default: This is the site-wide default. New bot configurations start with it unless a hub overrides the setting.
Allowed Values: 0-120
When Blank: No value is sent.
When Zero: Not applicable.
Access: Site administrators.
Security And Cost: Can change provider usage or billing. Review usage before raising it.
After Saving: Not applicable.
Related Settings: Default Model, Global OpenAI API Key, Global API Key Secret Reference, Global Responses API URL

Allow Hubs To Use Global Key

When enabled, a hub can use the shared key instead of its own key if that hub also enables Use Global API Key.

Default: This is the site-wide default. New bot configurations start with it unless a hub overrides the setting.
Allowed Values: See the field help and available choices on the configuration page.
When Blank: Not applicable.
When Zero: Not applicable.
Access: Site administrators.
Security And Cost: Can change provider usage or billing. Review usage before raising it.
After Saving: Not applicable.
Related Settings: Default Model, Global OpenAI API Key, Global API Key Secret Reference, Global Responses API URL

Default Shared-Key Messages

Default maximum number of OpenAI requests each hub may send during the selected shared-key period. Use 0 or blank for no default cap.

Default: No per-hub limit is set.
Allowed Values: 0+
When Blank: No per-hub limit is set.
When Zero: Zero disables this limit.
Access: Site administrators.
Security And Cost: Can change provider usage or billing. Review usage before raising it.
After Saving: Not applicable.
Related Settings: Default Model, Global OpenAI API Key, Global API Key Secret Reference, Global Responses API URL

Default Shared-Key Period

Time window used for the default shared-key message limit.

Default: This is the site-wide default. New bot configurations start with it unless a hub overrides the setting.
Allowed Values: See the field help and available choices on the configuration page.
When Blank: A value is required.
When Zero: Not applicable.
Access: Site administrators.
Security And Cost: Can change provider usage or billing. Review usage before raising it.
After Saving: Not applicable.
Related Settings: Default Model, Global OpenAI API Key, Global API Key Secret Reference, Global Responses API URL

Generation Settings

Instructions

System-level context used for every shared-key bot and as the starting context for hubs with their own key. Hub owners may replace it only when they use their own key.

Default: This is the site-wide default. New bot configurations start with it unless a hub overrides the setting.
Allowed Values: See the field help and available choices on the configuration page.
When Blank: No value is sent.
When Zero: Not applicable.
Access: Site administrators.
Security And Cost: May identify a person or expose operational context; keep it minimal.
After Saving: Not applicable.
Related Settings: Default Reasoning Effort, Default Temperature, Default Top P, Default Reasoning Summary

Default Reasoning Effort

Default reasoning effort for new hub bots when the model supports it. Low is a good latency-focused starting point.

Default: The provider default is used.
Allowed Values: See the field help and available choices on the configuration page.
When Blank: The provider default is used.
When Zero: Not applicable.
Access: Site administrators.
Security And Cost: Can change provider usage or billing. Review usage before raising it.
After Saving: Not applicable.
Related Settings: Instructions, Default Temperature, Default Top P, Default Reasoning Summary

Default Temperature

Fallback creativity setting for hubs that do not set their own temperature.

Default: The provider default is used.
Allowed Values: 0-2
When Blank: The provider default is used.
When Zero: Zero is sent as the configured value.
Access: Site administrators.
Security And Cost: Can change provider usage or billing. Review usage before raising it.
After Saving: Not applicable.
Related Settings: Instructions, Default Reasoning Effort, Default Top P, Default Reasoning Summary

Default Top P

Fallback nucleus-sampling setting for hubs that do not set their own Top P value.

Default: The provider default is used.
Allowed Values: 0-1
When Blank: The provider default is used.
When Zero: Zero is sent as the configured value.
Access: Site administrators.
Security And Cost: Can change provider usage or billing. Review usage before raising it.
After Saving: Not applicable.
Related Settings: Instructions, Default Reasoning Effort, Default Temperature, Default Reasoning Summary

Default Reasoning Summary

Fallback reasoning-summary setting for models that support it.

Default: The provider default is used.
Allowed Values: See the field help and available choices on the configuration page.
When Blank: The provider default is used.
When Zero: Not applicable.
Access: Site administrators.
Security And Cost: Can change provider usage or billing. Review usage before raising it.
After Saving: Not applicable.
Related Settings: Instructions, Default Reasoning Effort, Default Temperature, Default Top P

Default Max Output Tokens

Default answer token budget for new hub bots. A starting value around 1000 to 2000 balances cost and usefulness.

Default: The provider default is used.
Allowed Values: 16+
When Blank: The provider default is used.
When Zero: Zero is not a valid value.
Access: Site administrators.
Security And Cost: Can change provider usage or billing. Review usage before raising it.
After Saving: Not applicable.
Related Settings: Instructions, Default Reasoning Effort, Default Temperature, Default Top P

Default Timeout Seconds

Default request timeout in seconds. 60 seconds prevents hanging requests without cutting off ordinary chat.

Default: The provider default is used.
Allowed Values: 1+
When Blank: The provider default is used.
When Zero: Zero is not a valid value.
Access: Site administrators.
Security And Cost: Operational setting; do not use it to claim a permission the hub has not granted.
After Saving: Not applicable.
Related Settings: Instructions, Default Reasoning Effort, Default Temperature, Default Top P

Default Max Retries

Default retry count for temporary OpenAI or network failures. A starting value of 2 handles short outages without looping too long.

Default: The provider default is used.
Allowed Values: 0+
When Blank: The provider default is used.
When Zero: Zero is sent as the configured value.
Access: Site administrators.
Security And Cost: Can change provider usage or billing. Review usage before raising it.
After Saving: Not applicable.
Related Settings: Instructions, Default Reasoning Effort, Default Temperature, Default Top P

Default Streaming

Disabled by default because a hub receives each reply as one complete protocol message. Enable it only for a connector that supports incremental output.

Default: This is the site-wide default. New bot configurations start with it unless a hub overrides the setting.
Allowed Values: See the field help and available choices on the configuration page.
When Blank: Not applicable.
When Zero: Not applicable.
Access: Site administrators.
Security And Cost: Operational setting; do not use it to claim a permission the hub has not granted.
After Saving: Not applicable.
Related Settings: Instructions, Default Reasoning Effort, Default Temperature, Default Top P

Default Store

Fallback provider storage setting. Leave it at the provider default unless a policy requires a value.

Default: The provider default is used.
Allowed Values: See the field help and available choices on the configuration page.
When Blank: The provider default is used.
When Zero: Not applicable.
Access: Site administrators.
Security And Cost: May identify a person or expose operational context; keep it minimal.
After Saving: Not applicable.
Related Settings: Instructions, Default Reasoning Effort, Default Temperature, Default Top P

Default Prompt Caching

Send a stable cache key only to supported OpenAI Responses requests. This does not cache replies in the application.

Default: This is the site-wide default. New bot configurations start with it unless a hub overrides the setting.
Allowed Values: See the field help and available choices on the configuration page.
When Blank: Not applicable.
When Zero: Not applicable.
Access: Site administrators.
Security And Cost: Can change provider usage or billing. Review usage before raising it.
After Saving: Not applicable.
Related Settings: Instructions, Default Reasoning Effort, Default Temperature, Default Top P

Default Prompt Cache Retention

Optional 24-hour OpenAI cache retention. It is sent only when the selected official OpenAI model supports it.

Default: The provider default is used.
Allowed Values: See the field help and available choices on the configuration page.
When Blank: The provider default is used.
When Zero: Not applicable.
Access: Site administrators.
Security And Cost: Can change provider usage or billing. Review usage before raising it.
After Saving: Not applicable.
Related Settings: Instructions, Default Reasoning Effort, Default Temperature, Default Top P

Advanced OpenAI Payload

Default Parallel Tool Calls

Fallback setting for parallel provider tool calls.

Default: The provider default is used.
Allowed Values: See the field help and available choices on the configuration page.
When Blank: The provider default is used.
When Zero: Not applicable.
Access: Site administrators.
Security And Cost: Can change provider usage or billing. Review usage before raising it.
After Saving: Not applicable.
Related Settings: Default Metadata, Default Tools, Default Tool Choice, Default Response Format

Default Metadata

Fallback JSON metadata sent with requests from hubs that do not define their own metadata.

Default: This is the site-wide default. New bot configurations start with it unless a hub overrides the setting.
Allowed Values: See the field help and available choices on the configuration page.
When Blank: No value is sent.
When Zero: Not applicable.
Access: Site administrators.
Security And Cost: May identify a person or expose operational context; keep it minimal.
After Saving: Not applicable.
Related Settings: Default Parallel Tool Calls, Default Tools, Default Tool Choice, Default Response Format

Default Tools

Fallback JSON tool definitions sent with requests from hubs that do not define tools.

Default: This is the site-wide default. New bot configurations start with it unless a hub overrides the setting.
Allowed Values: See the field help and available choices on the configuration page.
When Blank: No value is sent.
When Zero: Not applicable.
Access: Site administrators.
Security And Cost: Can change provider usage or billing. Review usage before raising it.
After Saving: Not applicable.
Related Settings: Default Parallel Tool Calls, Default Metadata, Default Tool Choice, Default Response Format

Default Tool Choice

Fallback tool-choice value. It may be plain text or JSON, depending on the provider.

Default: This is the site-wide default. New bot configurations start with it unless a hub overrides the setting.
Allowed Values: See the field help and available choices on the configuration page.
When Blank: No value is sent.
When Zero: Not applicable.
Access: Site administrators.
Security And Cost: Can change provider usage or billing. Review usage before raising it.
After Saving: Not applicable.
Related Settings: Default Parallel Tool Calls, Default Metadata, Default Tools, Default Response Format

Default Response Format

Fallback JSON response-format setting for models that support structured output.

Default: This is the site-wide default. New bot configurations start with it unless a hub overrides the setting.
Allowed Values: See the field help and available choices on the configuration page.
When Blank: No value is sent.
When Zero: Not applicable.
Access: Site administrators.
Security And Cost: Can change provider usage or billing. Review usage before raising it.
After Saving: Not applicable.
Related Settings: Default Parallel Tool Calls, Default Metadata, Default Tools, Default Tool Choice

Rate And Token Limits

Default Input Limit

Default maximum characters accepted from one prompt before an OpenAI request is made. Use 0 or blank to disable the cap.

Default: No per-hub limit is set.
Allowed Values: 0+
When Blank: No per-hub limit is set.
When Zero: Zero disables this limit.
Access: Site administrators.
Security And Cost: Can change provider usage or billing. Review usage before raising it.
After Saving: Not applicable.
Related Settings: Default Per-User Rate Limit, Default Safety Identifier

Default Per-User Rate Limit

Default hourly GPT request cap for one hub nickname. Keep a real limit to prevent automated misuse.

Default: No per-hub limit is set.
Allowed Values: 0+
When Blank: No per-hub limit is set.
When Zero: Zero disables this limit.
Access: Site administrators.
Security And Cost: Can change provider usage or billing. Review usage before raising it.
After Saving: Not applicable.
Related Settings: Default Input Limit, Default Safety Identifier

Default Safety Identifier

Default safety identifier behavior. Stable hashes help providers detect abuse without exposing raw hub nicknames.

Default: This is the site-wide default. New bot configurations start with it unless a hub overrides the setting.
Allowed Values: See the field help and available choices on the configuration page.
When Blank: A value is required.
When Zero: Not applicable.
Access: Site administrators.
Security And Cost: May identify a person or expose operational context; keep it minimal.
After Saving: Not applicable.
Related Settings: Default Input Limit, Default Per-User Rate Limit

Hub Commands

Text sent back when this command runs. You can use the placeholders listed below this editor.

`help`

List server-handled commands and explain private and main chat use.

Aliases: commands

`usage`

Show message syntax, Direct Connect topics, and safe-use rules.

Aliases: guide, howto

`stats`

Show this hub's question and answer counts for each reporting period.

Aliases: statistics

`about`

Explain what this Hub GPT bot is and how a hub owner can configure it.

Aliases: bot, gpt

`locale`

Show supported reply languages or save one for your hub conversation.

Aliases: language

`weather`

Show current weather for your saved location, a supplied location, or the hub fallback location.

Aliases: forecast

`location`

Explain or save the general location used for your weather and local news requests.

Aliases: place

`news`

Show current local headlines for your saved location or a supplied location.

Aliases: headlines

`sport`

Show live scores, schedules, and completed results from the configured sports provider.

Aliases: sports

`remember`

Save a short fact that you explicitly want this bot to remember.

Aliases: save memory

`memory`

Show the short facts that this bot remembers for you.

Aliases: memories

`forget`

Remove one remembered fact or clear all remembered facts.

Aliases: clear memory

Weather Command And Official Sources

Weather needs a configured provider and one resolved location. Use the explicit place first; otherwise the bot can use the sender’s saved location, a usable hub-provided public IP location, or the configured server fallback.

weather Chicago, Illinois: Returns current conditions and daily outlooks. A named day uses the matching daily record when the provider has one.
weather tomorrow in Chicago: Returns current conditions and daily outlooks. A named day uses the matching daily record when the provider has one.
weather in 5 hours: Returns the nearest provider hourly forecast for the resolved location. The hour is rounded to the provider’s hourly timetable.

Current weather includes official National Weather Service forecast, hourly forecast, and location-centred radar links. Daily and hourly replies include the matching official forecast link; radar is shown only for the current-weather reply.

A past-day request reports historical provider data and links to NOAA/NCEI observations. It does not claim to recreate a forecast that was published in the past.

Available Placeholders

{{ command }}: renders the command name that matched the message.
{{ commands }}: renders the smart help list with global and hub commands available in this bot session.
{{ command_names }}: renders the command names as a comma-separated list.
{{ bot_username }}: renders the hub nickname used by this GPT bot.
{{ stats }}: renders per-hub GPT usage for 1 day, 1 week, 1 month, and lifetime. Use it on the stats command.

Icon Reference

Icon	Label	What It Does
	Hub Chat	Admin-only tool that connects to a hub as a configurable diagnostic user and shows raw hub responses, chat lines, private messages, and user-list data returned during the session.
	Hub Connection	Admin-only tool that connects to a hub as a configurable diagnostic user and shows raw hub responses, chat lines, private messages, and user-list data returned during the session.
	Raw Hub Response	Waiting for hub chat lines. Restriction and login messages are still available in the raw response.
	Raw Hub Requests	Optional. Used for registered NMDC/NMDCS nicknames when the hub requests a password.
	Starting	Starting hub chat worker...
	Connected	Connected as %nick% to %target%. Keep this panel open until you close the session.
	Error	Could not refresh the live hub session. Retrying...
	Closed	Disconnected from hub.
	Switch To Background	Background Low CPU Mode is active. Main chat and private messages are still received. Guest list, raw protocol, and diagnostics are paused until Interactive mode.
	Switch To Interactive	Background Low CPU Mode is active. Main chat and private messages are still received. Guest list, raw protocol, and diagnostics are paused until Interactive mode.
	Enable Browser Notifications	Choose a notification mode, then enable browser permission.
	Restart Session	Restarting hub chat session.
	Reconnect	The hub session could not be reconnected from the browser.
	Close Session	The hub session could not be closed from the browser.
	Collapse Hub Chat	Changes the panel between expanded and collapsed.
	Expand Hub Chat	Changes the panel between expanded and collapsed.
	Send	Press Enter to send. Press Shift+Enter for a new line.
	Guests	No guest list has been returned yet.
	Search Guests By Nickname	Search guest nickname...
	Message	Choose a guest before sending a private message.
	Conversations	Search nickname or message...
	Regular User	Guests
	Bot	Bot
	Operator	Operator
	Login Identity	Optional. Used for registered NMDC/NMDCS nicknames when the hub requests a password.
	NMDC Support Flags	Choose the NMDC $Supports flags sent during login. BotINFO is off by default for normal chat-client behavior.
	joined	Guest Activity
	left	Guest Activity
	Role	Guests
	Role	Guests
	Role	Guests
	Close Private Chat	Close Private Chat
	Guest Online	Guest Online
	Guest Offline	Guest Offline
	Open Help	Opens this help article.
	View	Configure the GPT bot identity, OpenAI Responses settings, reconnect behavior, and logging policy for this hub.
	Enable	Configure the GPT bot identity, OpenAI Responses settings, reconnect behavior, and logging policy for this hub.
	Disable	Configure the GPT bot identity, OpenAI Responses settings, reconnect behavior, and logging policy for this hub.
	Token Usage	Review stored GPT questions, replies, command usage, errors, and the user or hub nickname that triggered each response.
	Advanced Client Profile	Choose the NMDC $Supports flags sent during login. BotINFO is off by default for normal chat-client behavior.
	Rate And Token Limits	Maximum GPT requests one hub nickname may send per hour. Keep this enabled to prevent automated misuse.
	Hub Commands	Hub commands are available to anyone who can talk to this bot in hub chat. Do not use commands for website-admin-only actions.
	Global Commands	These command names are owned by global Hub GPT settings and cannot be overwritten by per-hub commands.
	Private Message Diagnostic	Connects as a temporary diagnostic user, sends one fixed private message to this bot, and opens the live session so you can review the reply and any failure details.
	Service-Bot Lookup Audit	Review stored GPT questions, replies, command usage, errors, and the user or hub nickname that triggered each response.
	Recent GPT Records	Review stored GPT questions, replies, command usage, errors, and the user or hub nickname that triggered each response.
	Save	Configure the GPT bot identity, OpenAI Responses settings, reconnect behavior, and logging policy for this hub.
	All GPT Sessions	Review persistent GPT bot sessions connected to hubs and open per-hub configuration.
	Allowed Models	Allowed models are managed as rows. Use Sync OpenAI Models to copy model ids from the configured global key, then keep each model public, admin-only, or hidden as site policy.
	GPT Client Defaults	Starting Direct Connect profile for newly created Hub GPT bots. Each hub keeps later changes to its own bot.
	Background Process Commands	Use these exact commands from the Symfony project root when a Hub GPT worker needs a focused manual run, reconnect, deploy restart, or pre-deploy pause.
	Configure	Configure the GPT bot identity, OpenAI Responses settings, reconnect behavior, and logging policy for this hub.
	Add Command	Hub commands are available to anyone who can talk to this bot in hub chat. Do not use commands for website-admin-only actions.
	Clear Secret	Clear Secret

Overview

Hub GPT Versus Hub Chat

Access States And User Invocation

Token Usage

Hub Chat

Status And Session Actions

Credentials

Advanced Client Profile

NMDC Support Flags

OpenAI Client

Generation Settings

Advanced OpenAI Payload

Rate And Token Limits

Reconnect And Logging

Hub Commands

Command Placeholders

Private Message Diagnostic

Service Bot Search Audit

Recent GPT Records

Security And Privacy

Hub GPT Troubleshooting

Related Pages

Parent Page

Configuration Reference

Bot Identity

Bot Username

Bot Alias

Hub Password

Bot Locale

Access Status

Hub Connection

Fake Share

Normal Hubs

Registered Hubs

Operator Hubs

Open Slots

TCP Port

UDP Port

TLS Port

Client Description

Client Email

NMDC Support Flags

NMDC Support Flags

OpenAI Client

Use Global API Key

OpenAI API Key

API Key Secret Reference

Responses API URL

Organization

Project

Model

Generation Settings

Instructions

Max Output Tokens

Timeout Seconds

Max Retries

Temperature

Top P

Reasoning Effort

Reasoning Summary

Stream Response

Store Response

Advanced OpenAI Payload

Parallel Tool Calls

Metadata JSON

Tools JSON

Tool Choice

Response Format JSON

Rate And Token Limits

Rate Limit Per User

Rate Limit Per Hub

Main Chat Reply Line Limit

Private Reply Line Limit

Input Limit

Safety Identifier

Daily Token Limit

Monthly Token Limit

Shared-Key Messages

Shared-Key Period

`help`

`usage`

`stats`

`about`

`locale`

`weather`

`location`

`news`

`sport`

`remember`

`memory`

`forget`