@hagivu/openclaw-mattermost 1.0.0 → 1.0.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +148 -0
- package/hagivu-openclaw-mattermost-1.0.2.tgz +0 -0
- package/package.json +29 -23
- package/package.json.backup +28 -0
- package/package.json.workspace +28 -0
package/README.md
ADDED
|
@@ -0,0 +1,148 @@
|
|
|
1
|
+
# @hagivu/openclaw-mattermost
|
|
2
|
+
|
|
3
|
+
OpenClaw Mattermost channel plugin - enables your AI assistant to interact through Mattermost chat.
|
|
4
|
+
|
|
5
|
+
## Installation
|
|
6
|
+
|
|
7
|
+
```bash
|
|
8
|
+
# Install OpenClaw (if not already installed)
|
|
9
|
+
npm install -g openclaw
|
|
10
|
+
|
|
11
|
+
# Install Mattermost plugin
|
|
12
|
+
openclaw plugins install @hagivu/openclaw-mattermost
|
|
13
|
+
|
|
14
|
+
# Enable the plugin
|
|
15
|
+
openclaw plugins enable mattermost
|
|
16
|
+
```
|
|
17
|
+
|
|
18
|
+
## Requirements
|
|
19
|
+
|
|
20
|
+
- **Mattermost Server**: Self-hosted Mattermost instance (version 7.0+)
|
|
21
|
+
- **Bot Account**: Create a bot account in Mattermost
|
|
22
|
+
- Go to **System Console → Integrations → Bot Accounts**
|
|
23
|
+
- Click **Add Bot Account**
|
|
24
|
+
- Copy the **Bot Token**
|
|
25
|
+
- **Base URL**: Your Mattermost server URL (e.g., `https://team.example.com`)
|
|
26
|
+
|
|
27
|
+
## Configuration
|
|
28
|
+
|
|
29
|
+
### Interactive Setup
|
|
30
|
+
|
|
31
|
+
```bash
|
|
32
|
+
openclaw configure
|
|
33
|
+
```
|
|
34
|
+
|
|
35
|
+
Select "Mattermost" channel and provide:
|
|
36
|
+
- **Bot Token**: Your Mattermost bot access token
|
|
37
|
+
- **Base URL**: Your Mattermost server URL (including https://)
|
|
38
|
+
|
|
39
|
+
### Manual Configuration
|
|
40
|
+
|
|
41
|
+
Edit `~/.openclaw/openclaw.json`:
|
|
42
|
+
|
|
43
|
+
```json
|
|
44
|
+
{
|
|
45
|
+
"channels": {
|
|
46
|
+
"mattermost": {
|
|
47
|
+
"botToken": "your-bot-token-here",
|
|
48
|
+
"baseUrl": "https://team.example.com"
|
|
49
|
+
}
|
|
50
|
+
}
|
|
51
|
+
}
|
|
52
|
+
```
|
|
53
|
+
|
|
54
|
+
## Usage
|
|
55
|
+
|
|
56
|
+
### Start the Gateway
|
|
57
|
+
|
|
58
|
+
```bash
|
|
59
|
+
# Install as system service (recommended)
|
|
60
|
+
openclaw gateway install --force
|
|
61
|
+
sudo systemctl start openclaw-gateway # Linux
|
|
62
|
+
# or just run: openclaw gateway install --force (macOS)
|
|
63
|
+
|
|
64
|
+
# Or run in foreground
|
|
65
|
+
openclaw gateway
|
|
66
|
+
```
|
|
67
|
+
|
|
68
|
+
### Interact with the Bot
|
|
69
|
+
|
|
70
|
+
In Mattermost:
|
|
71
|
+
```
|
|
72
|
+
@yourbotname hello
|
|
73
|
+
@yourbotname what's the weather today?
|
|
74
|
+
@yourbotname help me write some code
|
|
75
|
+
```
|
|
76
|
+
|
|
77
|
+
## Features
|
|
78
|
+
|
|
79
|
+
- ✅ Direct messages and @mentions
|
|
80
|
+
- ✅ Channel conversations
|
|
81
|
+
- ✅ Thread support
|
|
82
|
+
- ✅ File attachments
|
|
83
|
+
- ✅ Real-time message streaming
|
|
84
|
+
- ✅ Group mentions (@channel, @all)
|
|
85
|
+
- ✅ Multi-account support
|
|
86
|
+
|
|
87
|
+
## Troubleshooting
|
|
88
|
+
|
|
89
|
+
### Plugin not loading
|
|
90
|
+
|
|
91
|
+
```bash
|
|
92
|
+
# Check plugin status
|
|
93
|
+
openclaw plugins list | grep mattermost
|
|
94
|
+
|
|
95
|
+
# Should show: mattermost (enabled)
|
|
96
|
+
```
|
|
97
|
+
|
|
98
|
+
### Connection errors
|
|
99
|
+
|
|
100
|
+
```bash
|
|
101
|
+
# Test Mattermost connection
|
|
102
|
+
curl https://your-mattermost-url/api/v4/system/ping
|
|
103
|
+
|
|
104
|
+
# Check gateway logs
|
|
105
|
+
sudo journalctl -u openclaw-gateway -f # Linux
|
|
106
|
+
tail -f ~/.openclaw/logs/gateway.log # macOS
|
|
107
|
+
```
|
|
108
|
+
|
|
109
|
+
### Bot not responding
|
|
110
|
+
|
|
111
|
+
1. Verify bot token is correct
|
|
112
|
+
2. Check bot has permissions in the channel
|
|
113
|
+
3. Ensure gateway is running: `openclaw gateway status`
|
|
114
|
+
4. Check OpenClaw logs for errors
|
|
115
|
+
|
|
116
|
+
## Development
|
|
117
|
+
|
|
118
|
+
### Build from source
|
|
119
|
+
|
|
120
|
+
```bash
|
|
121
|
+
git clone https://github.com/yourusername/openclaw.git
|
|
122
|
+
cd openclaw/extensions/mattermost
|
|
123
|
+
pnpm install
|
|
124
|
+
pnpm build
|
|
125
|
+
```
|
|
126
|
+
|
|
127
|
+
## License
|
|
128
|
+
|
|
129
|
+
MIT
|
|
130
|
+
|
|
131
|
+
## Links
|
|
132
|
+
|
|
133
|
+
- [OpenClaw Documentation](https://openclaw.ai/docs)
|
|
134
|
+
- [Mattermost API Docs](https://api.mattermost.com/)
|
|
135
|
+
- [npm Package](https://www.npmjs.com/package/@hagivu/openclaw-mattermost)
|
|
136
|
+
- [Report Issues](https://github.com/hagivu/openclaw/issues)
|
|
137
|
+
|
|
138
|
+
## Version History
|
|
139
|
+
|
|
140
|
+
### 1.0.1 (2026-02-07)
|
|
141
|
+
- ✅ Fixed: Added `openclaw.extensions` metadata for plugin system
|
|
142
|
+
- ✅ Added: Complete README documentation
|
|
143
|
+
|
|
144
|
+
### 1.0.0 (2026-02-07)
|
|
145
|
+
- 🎉 Initial release
|
|
146
|
+
- ✅ Basic Mattermost channel support
|
|
147
|
+
- ✅ Bot integration
|
|
148
|
+
- ✅ Message streaming
|
|
Binary file
|
package/package.json
CHANGED
|
@@ -1,33 +1,39 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@hagivu/openclaw-mattermost",
|
|
3
|
-
"version": "1.0.
|
|
4
|
-
"description": "OpenClaw Mattermost channel plugin -
|
|
3
|
+
"version": "1.0.2",
|
|
4
|
+
"description": "OpenClaw Mattermost channel plugin - enables your AI assistant to interact through Mattermost chat",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"main": "./index.ts",
|
|
7
|
-
"files": [
|
|
8
|
-
"index.ts",
|
|
9
|
-
"src/",
|
|
10
|
-
"openclaw.plugin.json"
|
|
11
|
-
],
|
|
12
|
-
"keywords": [
|
|
13
|
-
"openclaw",
|
|
14
|
-
"plugin",
|
|
15
|
-
"mattermost",
|
|
16
|
-
"channel",
|
|
17
|
-
"chat",
|
|
18
|
-
"bot"
|
|
19
|
-
],
|
|
20
|
-
"author": "HaGi <hagivu@example.com>",
|
|
21
|
-
"license": "MIT",
|
|
22
|
-
"repository": {
|
|
23
|
-
"type": "git",
|
|
24
|
-
"url": "https://github.com/hagivu/openclaw.git",
|
|
25
|
-
"directory": "extensions/mattermost"
|
|
26
|
-
},
|
|
27
7
|
"peerDependencies": {
|
|
28
8
|
"openclaw": "^2026.2.0"
|
|
29
9
|
},
|
|
10
|
+
"openclaw": {
|
|
11
|
+
"extensions": [
|
|
12
|
+
"./index.ts"
|
|
13
|
+
],
|
|
14
|
+
"channel": {
|
|
15
|
+
"id": "mattermost",
|
|
16
|
+
"label": "Mattermost",
|
|
17
|
+
"selectionLabel": "Mattermost (plugin)",
|
|
18
|
+
"docsPath": "/channels/mattermost",
|
|
19
|
+
"docsLabel": "mattermost",
|
|
20
|
+
"blurb": "self-hosted Slack-style chat; install the plugin to enable.",
|
|
21
|
+
"order": 65
|
|
22
|
+
},
|
|
23
|
+
"install": {
|
|
24
|
+
"npmSpec": "@hagivu/openclaw-mattermost",
|
|
25
|
+
"defaultChoice": "npm"
|
|
26
|
+
}
|
|
27
|
+
},
|
|
30
28
|
"publishConfig": {
|
|
31
29
|
"access": "public"
|
|
32
|
-
}
|
|
30
|
+
},
|
|
31
|
+
"repository": {
|
|
32
|
+
"type": "git",
|
|
33
|
+
"url": "https://github.com/hagivu/openclaw.git",
|
|
34
|
+
"directory": "extensions/mattermost"
|
|
35
|
+
},
|
|
36
|
+
"keywords": ["openclaw", "plugin", "mattermost", "channel", "chat", "bot"],
|
|
37
|
+
"author": "hagivu",
|
|
38
|
+
"license": "MIT"
|
|
33
39
|
}
|
|
@@ -0,0 +1,28 @@
|
|
|
1
|
+
{
|
|
2
|
+
"name": "@openclaw/mattermost",
|
|
3
|
+
"version": "2026.2.6",
|
|
4
|
+
"description": "OpenClaw Mattermost channel plugin",
|
|
5
|
+
"type": "module",
|
|
6
|
+
"devDependencies": {
|
|
7
|
+
"openclaw": "workspace:*"
|
|
8
|
+
},
|
|
9
|
+
"openclaw": {
|
|
10
|
+
"extensions": [
|
|
11
|
+
"./index.ts"
|
|
12
|
+
],
|
|
13
|
+
"channel": {
|
|
14
|
+
"id": "mattermost",
|
|
15
|
+
"label": "Mattermost",
|
|
16
|
+
"selectionLabel": "Mattermost (plugin)",
|
|
17
|
+
"docsPath": "/channels/mattermost",
|
|
18
|
+
"docsLabel": "mattermost",
|
|
19
|
+
"blurb": "self-hosted Slack-style chat; install the plugin to enable.",
|
|
20
|
+
"order": 65
|
|
21
|
+
},
|
|
22
|
+
"install": {
|
|
23
|
+
"npmSpec": "@openclaw/mattermost",
|
|
24
|
+
"localPath": "extensions/mattermost",
|
|
25
|
+
"defaultChoice": "npm"
|
|
26
|
+
}
|
|
27
|
+
}
|
|
28
|
+
}
|
|
@@ -0,0 +1,28 @@
|
|
|
1
|
+
{
|
|
2
|
+
"name": "@openclaw/mattermost",
|
|
3
|
+
"version": "2026.2.6",
|
|
4
|
+
"description": "OpenClaw Mattermost channel plugin",
|
|
5
|
+
"type": "module",
|
|
6
|
+
"devDependencies": {
|
|
7
|
+
"openclaw": "workspace:*"
|
|
8
|
+
},
|
|
9
|
+
"openclaw": {
|
|
10
|
+
"extensions": [
|
|
11
|
+
"./index.ts"
|
|
12
|
+
],
|
|
13
|
+
"channel": {
|
|
14
|
+
"id": "mattermost",
|
|
15
|
+
"label": "Mattermost",
|
|
16
|
+
"selectionLabel": "Mattermost (plugin)",
|
|
17
|
+
"docsPath": "/channels/mattermost",
|
|
18
|
+
"docsLabel": "mattermost",
|
|
19
|
+
"blurb": "self-hosted Slack-style chat; install the plugin to enable.",
|
|
20
|
+
"order": 65
|
|
21
|
+
},
|
|
22
|
+
"install": {
|
|
23
|
+
"npmSpec": "@openclaw/mattermost",
|
|
24
|
+
"localPath": "extensions/mattermost",
|
|
25
|
+
"defaultChoice": "npm"
|
|
26
|
+
}
|
|
27
|
+
}
|
|
28
|
+
}
|