Nextcloud Talk

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

​

同梱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 webhook --feature response --feature reaction
   
3. 対象ルームの設定でbotを有効にします。
4. OpenClawを設定します。
   • Config: channels.nextcloud-talk.baseUrl + channels.nextcloud-talk.botSecret
   • またはenv: NEXTCLOUD_TALK_BOT_SECRET（デフォルトアカウントのみ）
   CLIセットアップ:
   openclaw channels add --channel nextcloud-talk \
     --url https://cloud.example.com \
     --token "<shared-secret>"
   
   同等の明示フィールド:
   openclaw channels add --channel nextcloud-talk \
     --base-url https://cloud.example.com \
     --secret "<shared-secret>"
   
   ファイルベースのシークレット:
   openclaw channels add --channel nextcloud-talk \
     --base-url https://cloud.example.com \
     --secret-file /path/to/nextcloud-talk-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"。不明な送信者にはペアリングコードが返されます。
• 承認方法:
  • 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"（メンションゲート）。
• channels.nextcloud-talk.roomsでルームを許可リストに追加します。

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

• ルームを許可しない場合は、許可リストを空のままにするか、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: ルーム検索（DM検出）用のAPIユーザー。
• channels.nextcloud-talk.apiPassword: ルーム検索用のAPI/appパスワード。
• 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許可リスト（ユーザーID）。openには"*"が必要です。
• channels.nextcloud-talk.groupPolicy: allowlist | open | disabled。
• channels.nextcloud-talk.groupAllowFrom: グループ許可リスト（ユーザーID）。
• channels.nextcloud-talk.rooms: ルームごとの設定と許可リスト。
• 静的な送信者アクセスグループは、allowFromとgroupAllowFromからaccessGroup:<name>で参照できます。
• 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: ブロックストリーミングの結合調整。
• channels.nextcloud-talk.mediaMaxMb: 受信メディア上限（MB）。

​

関連

• チャンネル概要 — 対応しているすべてのチャンネル
• ペアリング — DM認証とペアリングフロー
• グループ — グループチャットの動作とメンションゲート
• チャンネルルーティング — メッセージのセッションルーティング
• セキュリティ — アクセスモデルと強化