配置参考

connect 与插件的凭据字段存于 data/secrets.yaml，其余存于 data/settings.yaml。缺省即默认值，未知字段会校验失败。除标注 重启 的分区外均热更新。

connect 重启

键	环境变量	说明
misskey_url	MISSKEY_INSTANCE_URL	实例根地址，如 https://misskey.example.com
misskey_token	MISSKEY_ACCESS_TOKEN	机器人访问令牌
ai_base_url	AI_BASE_URL	留空使用 OpenAI 官方端点
ai_api_key	AI_API_KEY	API 密钥

环境变量（含工作目录 .env）优先于文件。TZ 决定日志与每日计数的本地时间。

bot

键	默认值	说明
system_prompt	You are a cute AI assistant...	系统提示词，可引用 prompts/*.md（或 *.txt）
admins	[]	管理员用户 ID 或 username@host
model	gpt-6-luna	文本模型
api_mode	auto	auto / chat / responses
max_tokens	2000	最大输出 token，须大于 0
temperature	0.8	0–2

timeline

键	默认值	说明
home	false	Home 时间线
local	false	Local 时间线，Iincho 必需
hybrid	false	Hybrid 时间线
global	false	Global 时间线
antennas	[]	天线 ID 或名称，Radar 必需

仅建立订阅，实际动作由插件决定。

autopost

键	默认值	说明
prompt	Write an interesting social media post...	可引用 prompts/*.md（或 *.txt）
visibility	public	public / home / followers
local_only	false	仅本地发布，不联合
mode	off	off / rotation（每 interval 发帖）/ schedule（在 times 各时间点发帖）
interval	3h	仅 rotation；30m、2h、1d，相邻至少 5 分钟
daily_max	8	仅 rotation；每日上限，0 不发帖
times	[]	仅 schedule；"HH:MM"，主机时区，最多 24 个，相邻至少 5 分钟

reply

键	默认值	说明
mention	true	响应提及
chat	true	响应私聊与群聊
ignore_bots	true	忽略 Bot 账号的提及与聊天
memory	10	上下文条数，0–100
ctx_tokens	2000	上下文 token 预算，0 禁用
rate_limit	-1	同一用户最小回复间隔
rate_limit_msg	空	间隔提示，留空静默
max_turns	-1	每用户回复次数上限，-1 不限且不计数
max_turns_msg	空	上限提示，留空静默
turns_release	1h	达上限后的解除时间，-1 改为拉黑
whitelist	[]	豁免间隔与次数限制，管理员自动豁免
blacklist	[]	禁用普通回复

时长支持整数秒、30s、5m、1h、1d 及组合；-1、off、none、unlimited 表示不限。

system

键	默认值	说明
log_level	INFO	DEBUG / INFO / WARNING / ERROR
dump_events	false	记录原始 Streaming 事件
db_clear_days	-1	回复限制状态保留天数，-1 不清理
allow_nets	[]	允许访问的 CIDR 列表，见链接下载安全

数据库 data/twipsybot.db 与日志 data/logs/twipsybot.log 路径固定。

链接下载安全

附件、图片生成结果与 Web 抓取的外部 URL 仅允许公网 http(s) 地址，重定向同样校验；Misskey 实例与管理员配置的端点不受限。

Fake-IP 代理等环境会把域名解析到保留网段，需将其填入 allow_nets。仅填信任的网段，内网网段会让机器人可访问这些内网地址。

plugins

键为本地插件目录名或 Entry Point 名，context.config 是其只读视图。通用字段：

键	默认值	说明
enabled	false	启用插件

其余字段见各插件页面。

plugins:
  mllm:
    enabled: true
  keyact:
    enabled: true
    rules: |-
      # 测试
      ping = pong