Misskey AI

一只 Python 实现的 Misskey 机器人
正运行在：oreeke.com/@ai

简介

主要功能

• 使用 OpenAI SDK 兼容性模型生成内容
  • OpenAI
  • DeepSeek（默认）
  • Gemini
  • Claude
  • Ollama
  • ...
• 自定义系统提示（性格）和发帖提示
• 根据已设置的周期和可见性自动发帖
• 实时响应用户提及（@）和聊天
• 利用插件系统添加丰富的额外功能
  • Example
  • Command
  • Topics
  • Weather
  • ...

开始

克隆仓库

git clone https://github.com/oreeke/misskey-ai.git
cd misskey-ai

部署方式

a 手动安装

• 复制 config.yaml.example 为 config.yaml 并修改配置

📃 config.yaml

misskey:
  instance_url: "https://misskey.example.com"       # Misskey 实例 URL
  access_token: "your_access_token_here"            # Misskey 访问令牌

openai:
  api_key: "your_api_key_here"                      # OpenAI API 密钥
  model: "deepseek-chat"                            # 使用的模型名称
  api_base: "https://api.deepseek.com/v1"           # OpenAI API 端点
  max_tokens: 1000                                  # 最大生成 token 数
  temperature: 0.8                                  # 温度参数

bot:
  system_prompt: |                                  # 系统提示词（支持文件导入："prompts/*.txt"，"file://path/to/*.txt"）
    你是一个可爱的AI助手，运行在Misskey平台上。
    请用简短、友好的方式发帖和回答问题。

  auto_post:
    enabled: true                                   # 是否启用自动发帖
    interval_minutes: 180                           # 发帖间隔（分钟）
    max_posts_per_day: 8                            # 每日最大发帖数量（凌晨 0 点重置计数器）
    visibility: "public"                            # 发帖可见性（public/home/followers/specified）
    prompt: |                                       # 发帖提示词
      生成一篇有趣、有见解的社交媒体帖子。

  response:
    mention_enabled: true                           # 是否响应提及（@）
    chat_enabled: true                              # 是否响应聊天
    chat_memory: 10                                 # 聊天上下文记忆长度（条）

log:
  level: "INFO"                                     # 日志级别 (DEBUG/INFO/WARNING/ERROR)

pip install -r requirements.txt
python run.py

后台运行（可选）

nohup python run.py & tail -f logs/misskey_ai.log

作为服务（可选）

📃 misskey-ai.service

[Unit]
Description=Misskey AI Service
After=network.target

[Service]
Type=exec
WorkingDirectory=/path/to/misskey-ai
ExecStart=/path/to/envs/misskey-ai/bin/python run.py
KillMode=control-group
TimeoutStopSec=5

[Install]
WantedBy=multi-user.target

systemctl daemon-reload
systemctl start misskey-ai.service

b Docker Compose

• 修改 docker-compose.yaml 中的环境变量

📃 docker-compose.yaml

MISSKEY_INSTANCE_URL=https://misskey.example.com           # Misskey 实例 URL
MISSKEY_ACCESS_TOKEN=your_access_token_here                # Misskey 访问令牌
OPENAI_API_KEY=your_api_key_here                           # OpenAI API 密钥
OPENAI_MODEL=deepseek-chat                                 # 使用的模型名称
OPENAI_API_BASE=https://api.deepseek.com/v1                # OpenAI API 端点
OPENAI_MAX_TOKENS=1000                                     # OpenAI 最大生成 token 数
OPENAI_TEMPERATURE=0.8                                     # OpenAI 温度参数
BOT_SYSTEM_PROMPT=你是一个可爱的AI助手...                    # 系统提示词（支持文件导入："prompts/*.txt"，"file://path/to/*.txt"）
BOT_AUTO_POST_ENABLED=true                                 # 是否启用自动发帖
BOT_AUTO_POST_INTERVAL=180                                 # 发帖间隔（分钟）
BOT_AUTO_POST_MAX_PER_DAY=8                                # 每日最大发帖数量（凌晨 0 点重置计数器）
BOT_AUTO_POST_VISIBILITY=public                            # 发帖可见性（public/home/followers/specified）
BOT_AUTO_POST_PROMPT=生成一篇有趣、有见解的社交媒体帖子。      # 发帖提示词
BOT_RESPONSE_MENTION_ENABLED=true                          # 是否响应提及（@）
BOT_RESPONSE_CHAT_ENABLED=true                             # 是否响应聊天
BOT_RESPONSE_CHAT_MEMORY=10                                # 聊天上下文记忆长度（条）
LOG_LEVEL=INFO                                             # 日志级别 (DEBUG/INFO/WARNING/ERROR)

docker compose build
docker compose up -d

Note

自动发帖会尽量绕过 Prompt caching
但相同提示词依然容易输出近似内容
想让帖子多样化请配置并启用 Topics 插件