​

Nextcloud Talk

​

バンドル済みplugin

openclaw plugins install @openclaw/nextcloud-talk

openclaw plugins install ./path/to/local/nextcloud-talk-plugin

​

クイックセットアップ（初級者向け）

1. Nextcloud Talk pluginが利用可能であることを確認します。
   • 現在のパッケージ済みOpenClawリリースには、すでにバンドルされています。
   • 古いインストールやカスタムインストールでは、上記コマンドで手動追加できます。
2. Nextcloudサーバーでbotを作成します。
   ./occ talk:bot:install "OpenClaw" "<shared-secret>" "<webhook-url>" --feature reaction
   
3. 対象ルームの設定でbotを有効にします。
4. OpenClawを設定します。
   • Config: channels.nextcloud-talk.baseUrl + channels.nextcloud-talk.botSecret
   • またはenv: NEXTCLOUD_TALK_BOT_SECRET（デフォルトアカウントのみ）
5. Gatewayを再起動します（またはセットアップを完了します）。

{
  channels: {
    "nextcloud-talk": {
      enabled: true,
      baseUrl: "https://cloud.example.com",
      botSecret: "shared-secret",
      dmPolicy: "pairing",
    },
  },
}

​

注意点

• botはDMを開始できません。ユーザー側から先にbotへメッセージを送る必要があります。
• Webhook URLはGatewayから到達可能である必要があります。プロキシの背後にある場合はwebhookPublicUrlを設定してください。
• bot APIではメディアアップロードはサポートされていません。メディアはURLとして送信されます。
• WebhookペイロードではDMとルームを区別できません。ルーム種別のルックアップを有効にするにはapiUser + apiPasswordを設定してください（設定しない場合、DMはルームとして扱われます）。

​

アクセス制御（DM）

• デフォルト: channels.nextcloud-talk.dmPolicy = "pairing"。未知の送信者にはpairingコードが送られます。
• 承認方法:
  • openclaw pairing list nextcloud-talk
  • openclaw pairing approve nextcloud-talk <CODE>
• 公開DM: channels.nextcloud-talk.dmPolicy="open"に加えてchannels.nextcloud-talk.allowFrom=["*"]。
• allowFromはNextcloudユーザーIDのみに一致します。表示名は無視されます。

​

ルーム（グループ）

• デフォルト: channels.nextcloud-talk.groupPolicy = "allowlist"（mentionゲートあり）。
• channels.nextcloud-talk.roomsでルームをallowlistに追加します。

{
  channels: {
    "nextcloud-talk": {
      rooms: {
        "room-token": { requireMention: true },
      },
    },
  },
}

• ルームを一切許可しない場合は、allowlistを空のままにするか、channels.nextcloud-talk.groupPolicy="disabled"を設定してください。

​

機能

​

設定リファレンス（Nextcloud Talk）

• channels.nextcloud-talk.enabled: チャンネル起動の有効化/無効化。
• channels.nextcloud-talk.baseUrl: NextcloudインスタンスURL。
• channels.nextcloud-talk.botSecret: bot共有シークレット。
• channels.nextcloud-talk.botSecretFile: 通常ファイルのシークレットパス。シンボリックリンクは拒否されます。
• channels.nextcloud-talk.apiUser: ルームルックアップ用APIユーザー（DM検出）。
• channels.nextcloud-talk.apiPassword: ルームルックアップ用API/アプリパスワード。
• channels.nextcloud-talk.apiPasswordFile: APIパスワードファイルのパス。
• channels.nextcloud-talk.webhookPort: Webhookリスナーポート（デフォルト: 8788）。
• channels.nextcloud-talk.webhookHost: Webhookホスト（デフォルト: 0.0.0.0）。
• channels.nextcloud-talk.webhookPath: Webhookパス（デフォルト: /nextcloud-talk-webhook）。
• channels.nextcloud-talk.webhookPublicUrl: 外部から到達可能なWebhook URL。
• channels.nextcloud-talk.dmPolicy: pairing | allowlist | open | disabled。
• channels.nextcloud-talk.allowFrom: DM allowlist（ユーザーID）。openには"*"が必要です。
• channels.nextcloud-talk.groupPolicy: allowlist | open | disabled。
• channels.nextcloud-talk.groupAllowFrom: グループallowlist（ユーザーID）。
• channels.nextcloud-talk.rooms: ルームごとの設定とallowlist。
• channels.nextcloud-talk.historyLimit: グループ履歴の上限（0で無効）。
• channels.nextcloud-talk.dmHistoryLimit: DM履歴の上限（0で無効。
• channels.nextcloud-talk.dms: DMごとのオーバーライド（historyLimit）。
• channels.nextcloud-talk.textChunkLimit: 送信テキストのチャンクサイズ（文字数）。
• channels.nextcloud-talk.chunkMode: length（デフォルト）またはnewline。長さで分割する前に空行（段落境界）で分割します。
• channels.nextcloud-talk.blockStreaming: このチャンネルのブロックストリーミングを無効化。
• channels.nextcloud-talk.blockStreamingCoalesce: ブロックストリーミングのcoalesce調整。
• channels.nextcloud-talk.mediaMaxMb: 受信メディア上限（MB）。

​

関連

• Channels Overview — サポートされているすべてのチャンネル
• Pairing — DM認証とpairingフロー
• Groups — グループチャットの動作とmentionゲート
• Channel Routing — メッセージのセッションルーティング
• Security — アクセスモデルとハードニング