mirror of
https://github.com/hansjone/oclaw.git
synced 2026-10-11 10:33:18 +08:00
oliver
dbbe3add6a
同时收敛启动与运维脚本默认行为（含 wiki worker）、更新 Admin 可观测性与相关测试，降低首轮时延并提高运行稳定性。 Made-with: Cursor
89 lines
2.3 KiB
Markdown
89 lines
2.3 KiB
Markdown
# @openclaw/twitch
|
|
|
|
Twitch channel plugin for OpenClaw.
|
|
|
|
## Install (local checkout)
|
|
|
|
```bash
|
|
openclaw plugins install ./path/to/local/twitch-plugin
|
|
```
|
|
|
|
## Install (npm)
|
|
|
|
```bash
|
|
openclaw plugins install @openclaw/twitch
|
|
```
|
|
|
|
Onboarding: select Twitch and confirm the install prompt to fetch the plugin automatically.
|
|
|
|
## Config
|
|
|
|
Minimal config (simplified single-account):
|
|
|
|
**⚠️ Important:** `requireMention` defaults to `true`. Add access control (`allowFrom` or `allowedRoles`) to prevent unauthorized users from triggering the bot.
|
|
|
|
```json5
|
|
{
|
|
channels: {
|
|
twitch: {
|
|
enabled: true,
|
|
username: "openclaw",
|
|
accessToken: "oauth:abc123...", // OAuth Access Token (add oauth: prefix)
|
|
clientId: "xyz789...", // Client ID from Token Generator
|
|
channel: "vevisk", // Channel to join (required)
|
|
allowFrom: ["123456789"], // (recommended) Your Twitch user ID only (Convert your twitch username to ID at https://www.streamweasels.com/tools/convert-twitch-username-to-user-id/)
|
|
},
|
|
},
|
|
}
|
|
```
|
|
|
|
**Access control options:**
|
|
|
|
- `requireMention: false` - Disable the default mention requirement to respond to all messages
|
|
- `allowFrom: ["your_user_id"]` - Restrict to your Twitch user ID only (find your ID at https://www.twitchangles.com/xqc or similar)
|
|
- `allowedRoles: ["moderator", "vip", "subscriber"]` - Restrict to specific roles
|
|
|
|
Multi-account config (advanced):
|
|
|
|
```json5
|
|
{
|
|
channels: {
|
|
twitch: {
|
|
enabled: true,
|
|
accounts: {
|
|
default: {
|
|
username: "openclaw",
|
|
accessToken: "oauth:abc123...",
|
|
clientId: "xyz789...",
|
|
channel: "vevisk",
|
|
},
|
|
channel2: {
|
|
username: "openclaw",
|
|
accessToken: "oauth:def456...",
|
|
clientId: "uvw012...",
|
|
channel: "secondchannel",
|
|
},
|
|
},
|
|
},
|
|
},
|
|
}
|
|
```
|
|
|
|
## Setup
|
|
|
|
1. Create a dedicated Twitch account for the bot, then generate credentials: [Twitch Token Generator](https://twitchtokengenerator.com/)
|
|
- Select **Bot Token**
|
|
- Verify scopes `chat:read` and `chat:write` are selected
|
|
- Copy the **Access Token** to `token` property
|
|
- Copy the **Client ID** to `clientId` property
|
|
2. Start the gateway
|
|
|
|
## Full documentation
|
|
|
|
See https://docs.openclaw.ai/channels/twitch for:
|
|
|
|
- Token refresh setup
|
|
- Access control patterns
|
|
- Multi-account configuration
|
|
- Troubleshooting
|
|
- Capabilities & limits
|