DeBox Community Management#

Manage DeBox communities, verify membership, and analyze community engagement.

Quick Start#

Configuration#

Set the DEBOX_API_KEY environment variable:

bash

export DEBOX_API_KEY="your-api-key"

Or add to ~/.openclaw/workspace/debox-community/config.json:

json

{
  "apiKey": "your-api-key",
  "defaultGroupId": "optional-default-group-id"
}

Get your API Key from https://developer.debox.pro

Commands#

Personal Data Report (推荐)#

查看你的 DeBox 个人数据报告：

bash

node scripts/debox-community.js profile --user-id "abc123"

Returns: 昵称、用户ID、钱包地址、等级、点赞数据

如何获取 user_id：

1. 打开 DeBox App
2. 进入个人主页
3. 点击分享，复制链接
4. 链接中的 id 参数就是 user_id

Group Info#

Query group information:

bash

node scripts/debox-community.js info --url "https://m.debox.pro/group?id=fxi3hqo5"

Returns: group name, member count, description, creator.

Member Verification#

Check if a user is in a group:

bash

node scripts/debox-community.js check-member --wallet "0x2267..." --group-url "https://m.debox.pro/group?id=fxi3hqo5"

Returns: boolean membership status.

User Profile#

Get user profile information (nickname, avatar, wallet address):

bash

node scripts/debox-community.js user-info --user-id "abc123"

Returns: user_id, nickname, avatar, wallet address.

Note: This API only supports user_id, not wallet address.

Vote Stats#

Query user's voting activity in a group:

bash

node scripts/debox-community.js vote-stats --wallet "0x2267..." --group-id "fxi3hqo5"

Returns: vote count, recent votes.

Lottery Stats#

Query user's lottery participation:

bash

node scripts/debox-community.js lottery-stats --wallet "0x2267..." --group-id "fxi3hqo5"

Returns: lottery count, win history.

Praise Info#

Get user's praise/like data:

bash

node scripts/debox-community.js praise-info --wallet "0x2267..." --chain-id 1

Returns: total likes received, recent praise.

Comprehensive Verification#

Verify user eligibility with multiple criteria:

bash

node scripts/debox-community.js verify --wallet "0x2267..." --group-url "..." --min-votes 5 --min-lotteries 1

Returns: pass/fail status with detailed breakdown.

API Reference#

See references/api.md for complete API documentation.

Use Cases#

DAO Membership Verification#

Verify if a user is a DAO member with voting history:

bash

node scripts/debox-community.js verify --wallet "0xabc..." --group-url "https://m.debox.pro/group?id=dao123" --min-votes 1

NFT Community Access#

Verify NFT holder is in community group:

bash

node scripts/debox-community.js check-member --wallet "0xabc..." --group-url "https://m.debox.pro/group?id=nft456"

Whitelist Generation#

Batch verify multiple wallets:

bash

node scripts/debox-community.js batch-verify --file wallets.txt --group-url "..." --min-votes 3

Error Handling#

ErrorCauseSolutionINVALID_API_KEYAPI key missing or invalidCheck configurationGROUP_NOT_FOUNDGroup ID/URL invalidVerify group URL formatUSER_NOT_FOUNDWallet address not registeredConfirm user has DeBox accountRATE_LIMITToo many requestsWait and retry

Environment Variables#

VariableRequiredDescriptionDEBOX_API_KEYYesYour DeBox API keyDEBOX_DEFAULT_GROUPNoDefault group ID for commands