claude4misskey

Misskey で特定のハッシュタグを含むノートを投稿するか、bot にメンションすると、Claude が自動で返信します。 claude4memos の Misskey 版

Misskey の Streaming API で bot 側から能動的に接続するため、公開HTTPSエンドポイントや リバースプロキシ・トンネルは不要。既存のMisskeyインスタンスに接続して動きます。

対応タグ

デフォルトで対応している対応タグです。内蔵プロンプトに記述されていて、カスタマイズ可能です。詳しくは後述

ハッシュタグは付けなくても動きます。メンションだけのノートは default にフォールバックします。

タグ	動作
（なし） / default	汎用的な応答
#expand	アイデアを拡張・補足
#critique	批評・フィードバック
#summarize	要約
#explainmath	数学の問題をステップごとに解説
#dev	専門的・技術的な応答（IT専門家として）
#research	Web検索を使った調査・要約

---

セットアップ

1. アクセストークンを発行

Misskey の Settings → API → アクセストークンの発行 で、以下の権限を付与したトークンを発行します。

• アカウントの情報を見る (read:account)
• ノートを作成・削除する (write:notes)
• 通知を見る (read:notifications)

2. .env を編集

CLAUDE_API=sk-ant-api03-...             # https://console.anthropic.com でキー取得
MISSKEY_HOST=https://your-instance.example
MISSKEY_TOKEN=...                        # 手順1で発行したアクセストークン
RATE_LIMIT_SECONDS=300                   # 同タグの連続実行を制限する秒数（デフォルト: 300）

3. 起動

docker compose up -d

compose使わなくてもOK

---

プロンプトのカスタマイズ

カスタマイズしたい場合は、リポジトリ直下に prompts.json を置くと、内蔵プロンプトより優先してそちらが使われます

雛形として prompts.example.json を参考にしてください。内蔵プロンプトは prompts.example.json を使用しています。

cp prompts.example.json prompts.json

{
  "default": "...",
  "mynewtag": "You are a ..."
}

コンテナの再起動は不要で、次のイベント受信時から反映されます。default キーは、タグなしメンション／ 未知タグ時のフォールバックとして使われる特別なキーです。

prompts.json が壊れている（JSON構文エラーなど）場合はエラーログを出しつつ内蔵デフォルトにフォールバックします。

Docker で使う場合は docker-compose.yml の ./prompts.json:/app/prompts.json:ro の行のコメントを 外し、ホスト側の prompts.json をコンテナにマウントしてください。

---

更新

docker compose pull && docker compose up -d

停止

docker compose down

ログ確認

docker compose logs claude4misskey -f