Host port mapped to IronsBot internal port 8080.

Ziel

8080

Standard

8085

Wert

8085

Persistent data directory for plugin caches, Bilibili cookies, and local database cache files.

Ziel

/app/data

Standard

/mnt/user/appdata/ironsbot/data

Wert

/mnt/user/appdata/ironsbot/data

NoneBot environment name.

Ziel

ENVIRONMENT

Standard

prod

Wert

prod

NoneBot driver setting.

Ziel

DRIVER

Standard

~fastapi+~httpx

Wert

~fastapi+~httpx

IronsBot listen host inside container.

Ziel

HOST

Standard

0.0.0.0

Wert

0.0.0.0

IronsBot listen port inside container.

Ziel

PORT

Standard

8080

Wert

8080

TRACE / DEBUG / INFO / WARNING / ERROR.

Ziel

LOG_LEVEL

Standard

INFO

Wert

INFO

NoneBot command prefixes.

Ziel

COMMAND_START

Standard

["/",""]

Wert

["/",""]

Run remote database sync during startup. Leave false to avoid slow startup; cached data loads from /app/data. Superusers can send 更新数据 or 数据更新 manually.

Ziel

DB_SYNC_ON_STARTUP

Standard

false

Wert

false

Enable scheduled database sync jobs after startup. Enabled by default; set false only if you want manual-only updates.

Ziel

DB_SYNC_INTERVAL_ENABLED

Standard

true

Wert

true

Access token used by NapCat or another OneBot v11 client to connect to IronsBot.

Ziel

ONEBOT_ACCESS_TOKEN

NoneBot superuser QQ list, for example ["123456789"].

Ziel

SUPERUSERS

Standard

[]

Wert

[]

Remote SeerAPI SQLite database URL.

Ziel

SEERAPI_SYNC_URL

Standard

https://github.com/SeerAPI/api-data/releases/download/latest/seerapi-data.sqlite

Wert

https://github.com/SeerAPI/api-data/releases/download/latest/seerapi-data.sqlite

Remote SeerAPI SHA256 fingerprint URL.

Ziel

SEERAPI_FINGERPRINT_URL

Standard

https://github.com/SeerAPI/api-data/releases/download/latest/seerapi-data.sqlite.sha256

Wert

https://github.com/SeerAPI/api-data/releases/download/latest/seerapi-data.sqlite.sha256

SeerAPI sync interval in minutes.

Ziel

SEERAPI_SYNC_INTERVAL_MINUTES

Standard

60

Wert

60

Local cache/fallback SeerAPI database path. Keep /app/data mounted for persistence.

Ziel

SEERAPI_LOCAL_PATH

Standard

data/seerapi-data.sqlite

Wert

data/seerapi-data.sqlite

Remote alias SQLite database URL.

Ziel

ALIAS_SYNC_URL

Standard

https://github.com/Nattsu39/ironsbot/releases/download/alias-db-latest/aliases-data.sqlite

Wert

https://github.com/Nattsu39/ironsbot/releases/download/alias-db-latest/aliases-data.sqlite

Remote alias SHA256 fingerprint URL.

Ziel

ALIAS_FINGERPRINT_URL

Standard

https://github.com/Nattsu39/ironsbot/releases/download/alias-db-latest/aliases-data.sqlite.sha256

Wert

https://github.com/Nattsu39/ironsbot/releases/download/alias-db-latest/aliases-data.sqlite.sha256

Alias database sync interval in minutes.

Ziel

ALIAS_SYNC_INTERVAL_MINUTES

Standard

65

Wert

65

Local cache/fallback alias database path. Keep /app/data mounted for persistence.

Ziel

ALIAS_LOCAL_PATH

Standard

data/aliases-data.sqlite

Wert

data/aliases-data.sqlite

Rendered image cache directory.

Ziel

RENDER_CACHE_DIR

Standard

render_cache

Wert

render_cache

Rendered image cache max size in MB.

Ziel

RENDER_CACHE_MAX_SIZE_MB

Standard

200

Wert

200

Optional Seer user ID / Mimi number for features that require login.

Ziel

HEADLESS_SEER_USER_ID

Optional MD5 password for the headless Seer login client.

Ziel

HEADLESS_SEER_PASSWORD

Headless client reconnect retry count.

Ziel

HEADLESS_SEER_RECONNECT_RETRIES

Standard

3

Wert

3

Tencent Meeting number, for example 1234567890 or 123-456-7890. The meeting URL is generated automatically.

Ziel

MEETING_REPLY_NUMBER

Meeting reply template. Variables: {meeting_number}, {meeting_digits}, {meeting_url}.

Ziel

MEETING_REPLY_TEMPLATE

Standard

Tencent Meeting Meeting Number: {meeting_number} Join Link: {meeting_url}

Wert

Tencent Meeting Meeting Number: {meeting_number} Join Link: {meeting_url}

QQ groups allowed to use meeting reply, for example [123456789].

Ziel

MEETING_REPLY_GROUPS

Standard

[]

Wert

[]

QQ users allowed to use meeting reply in private chat, for example [123456789].

Ziel

MEETING_REPLY_USERS

Standard

[]

Wert

[]

QQ groups allowed to query event links.

Ziel

EVENT_LINK_REPLY_GROUPS

Standard

[]

Wert

[]

QQ users allowed to query event links in private chat.

Ziel

EVENT_LINK_REPLY_USERS

Standard

[]

Wert

[]

QQ groups receiving scheduled event links.

Ziel

EVENT_LINK_SEND_GROUPS

Standard

[]

Wert

[]

QQ users receiving scheduled event links in private chat.

Ziel

EVENT_LINK_SEND_USERS

Standard

[]

Wert

[]

Scheduled event link send hour.

Ziel

EVENT_LINK_SEND_HOUR

Standard

23

Wert

23

Scheduled event link send minute.

Ziel

EVENT_LINK_SEND_MINUTE

Standard

0

Wert

0

JSON list of private message tasks. Example: [{"id":"morning","user_ids":[123456789],"hour":8,"minute":30,"message":"hello"}].

Ziel

SCHEDULED_PRIVATE_MESSAGES

Standard

[]

Wert

[]

QQ team groups where the shortcut command should trigger team queries. Keep private group IDs here instead of committing them to Git.

Ziel

TEAM_SHORTCUT_GROUP_IDS

Standard

[]

Wert

[]

Team IDs queried for the team group shortcut command, for example [1234567,7654321]. Keep private values out of Git.

Ziel

TEAM_SHORTCUT_TEAM_IDS

Standard

[]

Wert

[]

Exact team group shortcut commands that trigger the configured team queries.

Ziel

TEAM_SHORTCUT_COMMANDS

Standard

["战队"]

Wert

["战队"]

Send a private startup notice after the bot connects. SUPERUSERS receive it automatically.

Ziel

STARTUP_NOTICE_ENABLED

Standard

true

Wert

true

Extra QQ users receiving startup notices. SUPERUSERS are included automatically.

Ziel

STARTUP_NOTICE_USERS

Standard

[]

Wert

[]

Private message sent when IronsBot starts and connects.

Ziel

STARTUP_NOTICE_MESSAGE

Standard

Bot started.

Wert

Bot started.

Seconds to wait after bot connection before sending the startup notice.

Ziel

STARTUP_NOTICE_DELAY_SECONDS

Standard

3

Wert

3

DeepSeek API key. Keep this private.

Ziel

AI_CHAT_API_KEY

OpenAI-compatible API base URL. For relay/NewAPI services, usually use the /v1 endpoint, for example https://example.com/v1.

Ziel

AI_CHAT_BASE_URL

Standard

https://api.deepseek.com

Wert

https://api.deepseek.com

Model name used by the configured AI chat provider.

Ziel

AI_CHAT_MODEL

Standard

deepseek-v4-flash

Wert

deepseek-v4-flash

System prompt sent to the AI model.

Ziel

AI_CHAT_SYSTEM_PROMPT

Standard

You are IronsBot, a QQ group bot for Seer information queries. Help users discuss Seer pets, skills, abilities, stats, type matchups, events, and bot usage. You may chat naturally, but keep replies concise, friendly, and honest. If unsure, say so instead of inventing facts.

Wert

You are IronsBot, a QQ group bot for Seer information queries. Help users discuss Seer pets, skills, abilities, stats, type matchups, events, and bot usage. You may chat naturally, but keep replies concise, friendly, and honest. If unsure, say so instead of inventing facts.

Optional QQ group whitelist. Empty means no group restriction. Group chats still require mentioning the bot.

Ziel

AI_CHAT_ALLOWED_GROUP_IDS

Standard

[]

Wert

[]

QQ users allowed to use AI chat. Group chats require mentioning the bot.

Ziel

AI_CHAT_ALLOWED_USER_IDS

Standard

[]

Wert

[]

Extra AI chat admins. SUPERUSERS are allowed automatically.

Ziel

AI_CHAT_ADMIN_UIDS

Standard

[]

Wert

[]

Allow group owners to use AI chat by mentioning the bot.

Ziel

AI_CHAT_ALLOW_GROUP_OWNER

Standard

true

Wert

true

Conversation history turns kept per user.

Ziel

AI_CHAT_HISTORY_TURNS

Standard

6

Wert

6

AI API request timeout in seconds.

Ziel

AI_CHAT_TIMEOUT_SECONDS

Standard

45

Wert

45

Maximum generated tokens per AI reply.

Ziel

AI_CHAT_MAX_TOKENS

Standard

800

Wert

800

AI sampling temperature from 0 to 2.

Ziel

AI_CHAT_TEMPERATURE

Standard

0.7

Wert

0.7

Enable DeepSeek thinking mode. Disabled is usually faster for casual chat.

Ziel

AI_CHAT_THINKING_ENABLED

Standard

false

Wert

false

Send a short waiting message before calling the AI API.

Ziel

AI_CHAT_SEND_WAITING_NOTICE

Standard

false

Wert

false

Maximum characters sent back to QQ before truncation.

Ziel

AI_CHAT_MAX_REPLY_CHARS

Standard

1500

Wert

1500

Bilibili UID to monitor.

Ziel

BILIBILI_MONITOR_UID

Standard

1310714247

Wert

1310714247

Directory for Bilibili cookie and dynamic timestamp cache. Keep /app/data mounted for persistence.

Ziel

BILIBILI_MONITOR_DATA_DIR

Standard

data/bilibili_monitor

Wert

data/bilibili_monitor

Bilibili dynamic check interval in minutes.

Ziel

BILIBILI_MONITOR_CHECK_INTERVAL_MINUTES

Standard

5

Wert

5

Low-frequency check start hour.

Ziel

BILIBILI_MONITOR_SLEEP_START_HOUR

Standard

23

Wert

23

Low-frequency check end hour.

Ziel

BILIBILI_MONITOR_SLEEP_END_HOUR

Standard

7

Wert

7

Low-frequency check interval in minutes.

Ziel

BILIBILI_MONITOR_SLEEP_INTERVAL_MINUTES

Standard

30

Wert

30

QQ groups receiving Bilibili dynamic updates.

Ziel

BILIBILI_MONITOR_TARGET_GROUP_IDS

Standard

[]

Wert

[]

QQ users receiving Bilibili dynamic updates in private chat.

Ziel

BILIBILI_MONITOR_TARGET_USER_IDS

Standard

[]

Wert

[]

QQ users allowed to run Bilibili monitor admin commands.

Ziel

BILIBILI_MONITOR_ADMIN_UIDS

Standard

[]

Wert

[]