OpenClawSkills
GitHub
チャンネル • 5分で読める

Nextcloud Talk(チャット)

Nextcloud Talk: support status, capabilities, and configuration.

ステータス:プラグイン経由で対応(webhook bot)。DM、ルーム、リアクション、Markdownメッセージをサポート。

Tutorial.step

プラグインのインストールが必要

Nextcloud Talkはプラグインとして提供されており、コアインストールには含まれていません。

CLI経由でインストール(npm registry):

Bash
openclaw plugins install @openclaw/nextcloud-talk

ローカルインストール(gitリポジトリから実行する場合):

Bash
openclaw plugins install ./extensions/nextcloud-talk

configure/onboardingでNextcloud Talkを選択し、gitチェックアウトが検出された場合、OpenClawは自動的にローカルインストールパスを提供します。

Details: ''/plugin''

Tutorial.step

クイックセットアップ

1. Nextcloud Talkプラグインをインストールします。

2. Nextcloudサーバーでbotを作成します:

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

Notes

- BotはDMを開始できません:ユーザーが最初にbotにメッセージを送信する必要があります。

- webhook URLはGatewayからアクセス可能である必要があります。リバースプロキシの背後にある場合は、<code>webhookPublicUrl</code>を設定してください。

- Bot APIはメディアアップロードをサポートしていません。メディアはURLとして送信されます。

- webhookペイロードは「DMとルーム」を区別しません。区別するには、ルームタイプクエリのために<code>apiUser</code> + <code>apiPassword</code>を設定してください(そうしないとDMはルームとして処理されます)。

Tutorial.step

アクセス制御(DM)

- デフォルト:<code>channels.nextcloud-talk.dmPolicy = "pairing"</code>。不明な送信者はペアリングコードを受け取ります。

- Approve:

- <code>openclaw pairing list nextcloud-talk</code>

- <code>openclaw pairing approve nextcloud-talk &lt;CODE&gt;</code>

- 公開DM:<code>channels.nextcloud-talk.dmPolicy="open"</code>および<code>channels.nextcloud-talk.allowFrom=["*"]</code>。

Tutorial.step

ルーム(グループチャット)

- デフォルト:<code>channels.nextcloud-talk.groupPolicy = "allowlist"</code>(デフォルトでメンションが必要)。

- <code>channels.nextcloud-talk.rooms</code>を使用してルームを許可リストに追加:

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

- すべてのルームを処理しない場合:許可リストを空のままにするか、<code>channels.nextcloud-talk.groupPolicy="disabled"</code>を設定します。

Tutorial.step

Capabilities

| 機能 | ステータス |

| -- |

| DM | 対応済み|

| ルーム | 対応済み|

| スレッド | 非対応|

| メディア | URLのみ|

| リアクション | 対応済み|

| ネイティブコマンド | 非対応|

Tutorial.step

設定リファレンス(Nextcloud Talk)

完全な設定:''/gateway/configuration''

プロバイダーオプション:

- <code>channels.nextcloud-talk.enabled</code>: enable/disable

- <code>channels.nextcloud-talk.baseUrl</code>:NextcloudインスタンスURL

- <code>channels.nextcloud-talk.botSecret</code>:bot共有シークレット

- <code>channels.nextcloud-talk.botSecretFile</code>:シークレットファイルパス

- <code>channels.nextcloud-talk.apiUser</code>:ルーム検索用APIユーザー(DM識別)

- <code>channels.nextcloud-talk.apiPassword</code>:ルーム検索用API/アプリパスワード

- <code>channels.nextcloud-talk.apiPasswordFile</code>:APIパスワードファイルパス

- <code>channels.nextcloud-talk.webhookPort</code>:webhookリッスンポート(デフォルト8788)

- <code>channels.nextcloud-talk.webhookHost</code>:webhookホスト(デフォルト0.0.0.0)

- <code>channels.nextcloud-talk.webhookPath</code>:webhookパス(デフォルト<code>/nextcloud-talk-webhook</code>)

- <code>channels.nextcloud-talk.webhookPublicUrl</code>:外部からアクセス可能なwebhook URL

- <code>channels.nextcloud-talk.dmPolicy</code>:<code>pairing | allowlist | open | disabled</code>

- <code>channels.nextcloud-talk.allowFrom</code>:DM許可リスト(ユーザーID);公開には<code>"*"</code>が必要

- <code>channels.nextcloud-talk.groupPolicy</code>:<code>allowlist | open | disabled</code>

- <code>channels.nextcloud-talk.groupAllowFrom</code>:グループ送信者許可リスト(ユーザーID)

- <code>channels.nextcloud-talk.rooms</code>:ルームごとの設定と許可リスト

- <code>channels.nextcloud-talk.historyLimit</code>:グループ履歴数(<code>0</code>で無効)

- <code>channels.nextcloud-talk.dmHistoryLimit</code>:DM履歴数(<code>0</code>で無効)

- <code>channels.nextcloud-talk.dms</code>:DMごとのオーバーライド(historyLimit)

- <code>channels.nextcloud-talk.textChunkLimit</code>:送信チャンクサイズ(文字数)

- <code>channels.nextcloud-talk.chunkMode</code>:<code>length</code>(デフォルト)/ <code>newline</code>

- <code>channels.nextcloud-talk.blockStreaming</code>:このチャンネルのブロックストリーミングを無効化

- <code>channels.nextcloud-talk.blockStreamingCoalesce</code>:ブロックストリーミング結合パラメータ

- <code>channels.nextcloud-talk.mediaMaxMb</code>:受信メディア制限(MB)