docs: update all plugin docs to reflect bundled + auto-install

Updated docs for all bundled plugins to reflect:
- Plugins are bundled with Clawdbot
- Dependencies auto-install on first load when enabled
- npm install is an alternative, not required
- Simplified setup steps

Updated channels:
- line, matrix, mattermost, msteams, nextcloud-talk, nostr, zalo, zalouser

Updated plugins:
- voice-call, zalouser
This commit is contained in:
Hunter Miller 2026-01-26 12:55:13 -06:00
parent 3bf74611c2
commit 0b3f4a27ba
10 changed files with 170 additions and 112 deletions

View File

@ -16,20 +16,27 @@ Status: supported via plugin. Direct messages, group chats, media, locations, Fl
messages, template messages, and quick replies are supported. Reactions and threads
are not supported.
## Plugin required
## Plugin setup
Install the LINE plugin:
LINE is bundled with Clawdbot. Its dependencies are automatically installed on first load
when you enable the plugin.
To enable, add `line` to your plugins allow list:
```json5
{
plugins: {
allow: ["line"]
}
}
```
Alternatively, install explicitly from npm:
```bash
clawdbot plugins install @clawdbot/line
```
Local checkout (when running from a git repo):
```bash
clawdbot plugins install ./extensions/line
```
## Setup
1) Create a LINE Developers account and open the Console:

View File

@ -13,32 +13,32 @@ but it requires E2EE to be enabled.
Status: supported via plugin (matrix-bot-sdk). Direct messages, rooms, threads, media, reactions,
polls (send + poll-start as text), location, and E2EE (with crypto support).
## Plugin required
## Plugin setup
Matrix ships as a plugin and is not bundled with the core install.
Matrix is bundled with Clawdbot. Its dependencies are automatically installed on first load
when you enable the plugin.
Install via CLI (npm registry):
To enable, add `matrix` to your plugins allow list:
```json5
{
plugins: {
allow: ["matrix"]
}
}
```
Alternatively, install explicitly from npm:
```bash
clawdbot plugins install @clawdbot/matrix
```
Local checkout (when running from a git repo):
```bash
clawdbot plugins install ./extensions/matrix
```
If you choose Matrix during configure/onboarding and a git checkout is detected,
Clawdbot will offer the local install path automatically.
Details: [Plugins](/plugin)
## Setup
1) Install the Matrix plugin:
- From npm: `clawdbot plugins install @clawdbot/matrix`
- From a local checkout: `clawdbot plugins install ./extensions/matrix`
1) Add `matrix` to your plugins allow list (or install via CLI).
2) Create a Matrix account on a homeserver:
- Browse hosting options at [https://matrix.org/ecosystem/hosting/](https://matrix.org/ecosystem/hosting/)
- Or host it yourself.

View File

@ -11,22 +11,29 @@ Status: supported via plugin (bot token + WebSocket events). Channels, groups, a
Mattermost is a self-hostable team messaging platform; see the official site at
[mattermost.com](https://mattermost.com) for product details and downloads.
## Plugin required
Mattermost ships as a plugin and is not bundled with the core install.
## Plugin setup
Mattermost is bundled with Clawdbot. Its dependencies are automatically installed on first
load when you enable the plugin.
To enable, add `mattermost` to your plugins allow list:
```json5
{
plugins: {
allow: ["mattermost"]
}
}
```
The onboarding wizard and `clawdbot channels add` also offer to enable Mattermost.
Alternatively, install explicitly from npm:
Install via CLI (npm registry):
```bash
clawdbot plugins install @clawdbot/mattermost
```
Local checkout (when running from a git repo):
```bash
clawdbot plugins install ./extensions/mattermost
```
If you choose Mattermost during configure/onboarding and a git checkout is detected,
Clawdbot will offer the local install path automatically.
Details: [Plugins](/plugin)
## Quick setup

View File

@ -12,30 +12,34 @@ Updated: 2026-01-21
Status: text + DM attachments are supported; channel/group file sending requires `sharePointSiteId` + Graph permissions (see [Sending files in group chats](#sending-files-in-group-chats)). Polls are sent via Adaptive Cards.
## Plugin required
Microsoft Teams ships as a plugin and is not bundled with the core install.
## Plugin setup
**Breaking change (2026.1.15):** MS Teams moved out of core. If you use it, you must install the plugin.
Microsoft Teams is bundled with Clawdbot. Its dependencies are automatically installed on
first load when you enable the plugin.
Explainable: keeps core installs lighter and lets MS Teams dependencies update independently.
**Note (2026.1.15):** MS Teams is a plugin to keep core installs lighter and let its
dependencies update independently.
To enable, add `msteams` to your plugins allow list:
```json5
{
plugins: {
allow: ["msteams"]
}
}
```
Alternatively, install explicitly from npm:
Install via CLI (npm registry):
```bash
clawdbot plugins install @clawdbot/msteams
```
Local checkout (when running from a git repo):
```bash
clawdbot plugins install ./extensions/msteams
```
If you choose Teams during configure/onboarding and a git checkout is detected,
Clawdbot will offer the local install path automatically.
Details: [Plugins](/plugin)
## Quick setup (beginner)
1) Install the Microsoft Teams plugin.
1) Add `msteams` to your plugins allow list (or install via CLI).
2) Create an **Azure Bot** (App ID + client secret + tenant ID).
3) Configure Clawdbot with those credentials.
4) Expose `/api/messages` (port 3978 by default) via a public URL or tunnel.

View File

@ -7,22 +7,29 @@ read_when:
Status: supported via plugin (webhook bot). Direct messages, rooms, reactions, and markdown messages are supported.
## Plugin required
Nextcloud Talk ships as a plugin and is not bundled with the core install.
## Plugin setup
Nextcloud Talk is bundled with Clawdbot. Its dependencies are automatically installed on first
load when you enable the plugin.
To enable, add `nextcloud-talk` to your plugins allow list:
```json5
{
plugins: {
allow: ["nextcloud-talk"]
}
}
```
The onboarding wizard and `clawdbot channels add` also offer to enable Nextcloud Talk.
Alternatively, install explicitly from npm:
Install via CLI (npm registry):
```bash
clawdbot plugins install @clawdbot/nextcloud-talk
```
Local checkout (when running from a git repo):
```bash
clawdbot plugins install ./extensions/nextcloud-talk
```
If you choose Nextcloud Talk during configure/onboarding and a git checkout is detected,
Clawdbot will offer the local install path automatically.
Details: [Plugins](/plugin)
## Quick setup (beginner)

View File

@ -10,33 +10,31 @@ read_when:
Nostr is a decentralized protocol for social networking. This channel enables Clawdbot to receive and respond to encrypted direct messages (DMs) via NIP-04.
## Install (on demand)
## Plugin setup
### Onboarding (recommended)
Nostr is bundled with Clawdbot. Its dependencies are automatically installed on first load
when you enable the plugin.
- The onboarding wizard (`clawdbot onboard`) and `clawdbot channels add` list optional channel plugins.
- Selecting Nostr prompts you to install the plugin on demand.
To enable, add `nostr` to your plugins allow list:
Install defaults:
```json5
{
plugins: {
allow: ["nostr"]
}
}
```
- **Dev channel + git checkout available:** uses the local plugin path.
- **Stable/Beta:** downloads from npm.
The onboarding wizard (`clawdbot onboard`) and `clawdbot channels add` also offer to enable
Nostr when you select it.
You can always override the choice in the prompt.
### Manual install
Alternatively, install explicitly from npm:
```bash
clawdbot plugins install @clawdbot/nostr
```
Use a local checkout (dev workflows):
```bash
clawdbot plugins install --link <path-to-clawdbot>/extensions/nostr
```
Restart the Gateway after installing or enabling plugins.
Restart the Gateway after enabling plugins.
## Quick setup

View File

@ -7,17 +7,31 @@ read_when:
Status: experimental. Direct messages only; groups coming soon per Zalo docs.
## Plugin required
Zalo ships as a plugin and is not bundled with the core install.
- Install via CLI: `clawdbot plugins install @clawdbot/zalo`
- Or select **Zalo** during onboarding and confirm the install prompt
- Details: [Plugins](/plugin)
## Plugin setup
Zalo is bundled with Clawdbot. Its dependencies are automatically installed on first load
when you enable the plugin.
To enable, add `zalo` to your plugins allow list:
```json5
{
plugins: {
allow: ["zalo"]
}
}
```
Or select **Zalo** during onboarding. Alternatively, install explicitly from npm:
```bash
clawdbot plugins install @clawdbot/zalo
```
Details: [Plugins](/plugin)
## Quick setup (beginner)
1) Install the Zalo plugin:
- From a source checkout: `clawdbot plugins install ./extensions/zalo`
- From npm (if published): `clawdbot plugins install @clawdbot/zalo`
- Or pick **Zalo** in onboarding and confirm the install prompt
1) Add `zalo` to your plugins allow list (or install via CLI/onboarding).
2) Set the token:
- Env: `ZALO_BOT_TOKEN=...`
- Or config: `channels.zalo.botToken: "..."`.

View File

@ -10,11 +10,24 @@ Status: experimental. This integration automates a **personal Zalo account** via
> **Warning:** This is an unofficial integration and may result in account suspension/ban. Use at your own risk.
## Plugin required
Zalo Personal ships as a plugin and is not bundled with the core install.
- Install via CLI: `clawdbot plugins install @clawdbot/zalouser`
- Or from a source checkout: `clawdbot plugins install ./extensions/zalouser`
- Details: [Plugins](/plugin)
## Plugin setup
Zalo Personal is bundled with Clawdbot. Its dependencies are automatically installed on first
load when you enable the plugin.
To enable, add `zalouser` to your plugins allow list:
```json5
{
plugins: {
allow: ["zalouser"]
}
}
```
Alternatively, install explicitly from npm: `clawdbot plugins install @clawdbot/zalouser`
Details: [Plugins](/plugin)
## Prerequisite: zca-cli
The Gateway machine must have the `zca` binary available in `PATH`.

View File

@ -28,9 +28,22 @@ The Voice Call plugin runs **inside the Gateway process**.
If you use a remote Gateway, install/configure the plugin on the **machine running the Gateway**, then restart the Gateway to load it.
## Install
## Plugin setup
### Option A: install from npm (recommended)
Voice Call is bundled with Clawdbot. Its dependencies are automatically installed on first
load when you enable the plugin.
To enable, add `voice-call` to your plugins allow list:
```json5
{
plugins: {
allow: ["voice-call"]
}
}
```
Alternatively, install explicitly from npm:
```bash
clawdbot plugins install @clawdbot/voice-call
@ -38,15 +51,6 @@ clawdbot plugins install @clawdbot/voice-call
Restart the Gateway afterwards.
### Option B: install from a local folder (dev, no copying)
```bash
clawdbot plugins install ./extensions/voice-call
cd ./extensions/voice-call && pnpm install
```
Restart the Gateway afterwards.
## Config
Set config under `plugins.entries.voice-call.config`:

View File

@ -19,9 +19,22 @@ This plugin runs **inside the Gateway process**.
If you use a remote Gateway, install/configure it on the **machine running the Gateway**, then restart the Gateway.
## Install
## Plugin setup
### Option A: install from npm
Zalo Personal is bundled with Clawdbot. Its dependencies are automatically installed on first
load when you enable the plugin.
To enable, add `zalouser` to your plugins allow list:
```json5
{
plugins: {
allow: ["zalouser"]
}
}
```
Alternatively, install explicitly from npm:
```bash
clawdbot plugins install @clawdbot/zalouser
@ -29,15 +42,6 @@ clawdbot plugins install @clawdbot/zalouser
Restart the Gateway afterwards.
### Option B: install from a local folder (dev)
```bash
clawdbot plugins install ./extensions/zalouser
cd ./extensions/zalouser && pnpm install
```
Restart the Gateway afterwards.
## Prerequisite: zca-cli
The Gateway machine must have `zca` on `PATH`: