openclaw-channel-dmwork 0.6.0-dev.248385c8 → 0.6.0-dev.93ccd127

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.
@@ -27,7 +27,8 @@ curl -X POST <apiUrl>/v1/bot/register \
27
27
  Response:
28
28
  ```json
29
29
  {
30
- "robot_id": "xxx_bot",
30
+ "robot_id": "27ba6or9NU_bot",
31
+ "name": "My Bot",
31
32
  "im_token": "xxxxxx",
32
33
  "ws_url": "<wsUrl>",
33
34
  "api_url": "<apiUrl>",
@@ -59,42 +60,25 @@ After registering, send a greeting to your owner (DM to owner_uid) to confirm yo
59
60
 
60
61
  ### Method A: OpenClaw Plugin (Recommended — Real-time)
61
62
 
62
- Install the pre-built adapter as an OpenClaw extension for instant message delivery, real-time online status, and auto-reconnect.
63
+ Install the pre-built adapter for instant message delivery, real-time online status, and auto-reconnect.
63
64
 
65
+ **Install plugin:**
64
66
  ```bash
65
- # Install via npm (recommended)
66
- openclaw plugins install openclaw-channel-dmwork
67
+ npx -y openclaw-channel-dmwork install
67
68
  ```
68
69
 
69
- Configure in `~/.openclaw/openclaw.json`:
70
-
71
- ```json
72
- {
73
- "channels": {
74
- "dmwork": {
75
- "botToken": "YOUR_BOT_TOKEN",
76
- "apiUrl": "<apiUrl>"
77
- }
78
- }
79
- }
70
+ **Single bot — bind to agent:**
71
+ ```bash
72
+ npx -y openclaw-channel-dmwork bind --bot-token YOUR_BOT_TOKEN --api-url <apiUrl> --account-id <robot_id> --agent <agent_id>
80
73
  ```
81
74
 
82
- Multiple bots on one Gateway (multi-account):
83
-
84
- ```json
85
- {
86
- "channels": {
87
- "dmwork": {
88
- "apiUrl": "<apiUrl>",
89
- "accounts": {
90
- "bot-a": { "botToken": "TOKEN_A" },
91
- "bot-b": { "botToken": "TOKEN_B" }
92
- }
93
- }
94
- }
95
- }
75
+ **All agents one-click setup:**
76
+ ```bash
77
+ npx -y openclaw-channel-dmwork quickstart --api-key uk_YOUR_KEY --api-url <apiUrl>
96
78
  ```
97
79
 
80
+ The CLI automatically writes `~/.openclaw/openclaw.json` config and agent bindings. No manual config editing needed.
81
+
98
82
  ### Multi-Agent Setup Guide
99
83
 
100
84
  When one owner creates multiple bots (e.g. via BotFather /newbot), each bot can be connected to a separate AI Agent. Each bot gets its own accountId in the OpenClaw config with independent settings.
@@ -920,13 +904,10 @@ Each API Key is bound to a specific Space. When you run /quickstart in a Space,
920
904
 
921
905
  ### Quickstart Flow
922
906
 
923
- 1. Get your User API Key from BotFather /quickstart command (key is bound to your current Space)
924
- 2. Create a bot via POST /v1/user/bots
925
- 3. Get the bot_token from the response
926
- 4. Register the bot via POST /v1/bot/register with the bot_token
927
- 5. Configure openclaw.json with the bot_token and apiUrl
928
- 6. Set session.dmScope to "per-account-channel-peer"
929
- 7. Verify the bot is online
907
+ 1. Get your User API Key from BotFather `/quickstart` command (key is bound to your current Space)
908
+ 2. Run `npx -y openclaw-channel-dmwork quickstart --api-key <key> --api-url <apiUrl>`
909
+ 3. The CLI automatically creates bots for all agents, writes config, and sends greetings
910
+ 4. Verify by sending a message to the bot in DMWork
930
911
 
931
912
  ### Endpoints
932
913
 
@@ -944,14 +925,16 @@ Each API Key is bound to a specific Space. When you run /quickstart in a Space,
944
925
  curl -X POST <apiUrl>/v1/user/bots \
945
926
  -H "Authorization: Bearer uk_YOUR_API_KEY" \
946
927
  -H "Content-Type: application/json" \
947
- -d '{"name": "My Bot", "username": "mybot", "description": "A helpful assistant"}'
928
+ -d '{"name": "My Bot", "description": "A helpful assistant"}'
948
929
  ```
949
930
 
931
+ Note: Bot ID (robot_id) is auto-generated by the server. The username field is deprecated and ignored if provided.
932
+
950
933
  Response:
951
934
  ```json
952
935
  {
953
- "robot_id": "mybot_bot",
954
- "username": "mybot_bot",
936
+ "robot_id": "27ba6or9NU_bot",
937
+ "username": "27ba6or9NU_bot",
955
938
  "name": "My Bot",
956
939
  "description": "A helpful assistant",
957
940
  "bot_token": "bf_xxxxxxxx"