discord-awaken-claw

Category: Databases & Storage | Uploader: talesofai | Downloads: 0 | Version: v1.0（Latest）
Triggered by an "start awakening" command. Through interaction with the user, this skill helps openclaw acquire a new character identity. It guides the user to input character concept words, outputs using Discord sendMessage components, accepts user @bot input, uses a "guess the character" approach to identify the user's target character, and upon user confirmation updates the bot avatar, server nickname, and soul.md — transforming openclaw into that character.
Changelog: Source: GitHub https://github.com/talesofai/travelclaw
Directory Structure

Current level: skills/discord-awaken-claw/
📁 reference/
- 📄 channel-listener.js 5.2 KB
- 📄 direct-handler.js 20.6 KB
- 📄 discord-profile.js 17.7 KB
- 📄 LISTENER-README.md 6.1 KB
- 📄 llm_judge.js 1.7 KB
- 📄 neta-avatar-search.js 7.9 KB
- 📄 package-lock.json 12.7 KB
- 📄 package.json 642 B
- 📄 start-listener.sh 2.8 KB
- 📄 update-profile-temp.js 1.3 KB
📄 openclaw-integration.js 18.1 KB
📄 README.md 3.1 KB
📄 SKILL.md 27.1 KB
📄 update-profile.js 3.9 KB
SKILL.md

---
name: discord-awaken-claw
description: Triggered by an "start awakening" command. Through interaction with the user, this skill helps openclaw acquire a new character identity. It guides the user to input character concept words, outputs using Discord sendMessage components, accepts user @bot input, uses a "guess the character" approach to identify the user's target character, and upon user confirmation updates the bot avatar, server nickname, and soul.md — transforming openclaw into that character.
---

## Read before executing! Check the following checklist before starting character awakening 🎭

**Prerequisites**
- Discord event listener scripts (e.g., button listeners) are already running;
- A valid neta token (`NETA_TOKEN`) is available in the environment variables.
**Trigger conditions and output format**
- Triggered when the user sends "开始觉醒"; output uses Discord sendMessage components with a fixed opening template.
- After receiving trait words from the user, each round uses the same component to output intelligent follow-up questions and option buttons.
**Nickname and avatar replacement**
- Once the character is confirmed and awakening begins, the bot's server nickname and avatar must be replaced with that character's.
- Anime/fictional characters ➡️ prefer using `reference/neta-avatar-search.js` (direct call to the Neta TCP API) to search for the character avatar ➡️ otherwise use Wikimedia search; for non-anime real-world figures, use Wikimedia directly to search for a portrait.
**Skill switching**
- Once the character awakens and the awakening narrative is output, immediately load the travelclaw skill (it's in your skills folder — find it yourself).

## ⚙️ Installation & Initialization (execute on first load, silently skip afterward)

### Step 1: Install dependencies

Check if `reference/node_modules` exists; if not, run:

```bash
cd [this skill's directory]/reference && npm install
```

### Step 2: Environment variable check

**Required variables** (listener cannot start without these):

| Variable | Purpose | How to obtain |
|------|------|----------|
| `DISCORD_TOKEN` | Discord Bot authentication | Discord Developer Portal |
| `DISCORD_GUILD_ID` | Target server ID | Discord server settings |



### Step 3: Start the listener (only triggered on channel creation)

**Listener purpose**: Only automatically sends an initial guide message when the Bot joins a new channel

```bash
# Run the listener in the background
cd [this skill's directory]
DISCORD_TOKEN="your token" DISCORD_GUILD_ID="your server ID" node reference/channel-listener.js &
```

**Verify it's running**:
```bash
ps aux | grep channel-listener
# Output should show a node process
```

**View logs**:
```bash
tail -f reference/channel-listener.log
```

---

## 🚀 Quick Deployment (for other OpenClaw users)

### Prerequisites

1. **Discord Bot has been created** and invited to the server
2. **Environment variables are configured** (`~/.env` or system environment variables)
3. **Node.js is installed** (v18+)

### One-command startup

```bash
# 1. Install dependencies
cd ~/.openclaw/workspace/skills/travelclaw/skills/discord-awaken-claw/reference
npm install

# 2. Start the listener (run in background)
cd ..
nohup node reference/channel-listener.js > reference/channel-listener.log 2>&1 &

# 3. Verify
ps aux | grep channel-listener
```

### Notes

- ⚠️ **Listener runs independently**: separate from the OpenClaw main process, must be managed separately
- ⚠️ **Bot permissions**: requires `ViewChannel` and `SendMessages` permissions
- ⚠️ **Intents configuration**: Discord Developer Portal must have `Server Members Intent` and `Message Content Intent` enabled


---

## 🔄 Execution Flow Quick Reference (must advance according to this after each step — no skipping)

```
Phase 0: Bot joins private channel → automatically sends guide message + buttons
Phase 1: User inputs @Bot start awakening → sends guide message + buttons
    ↓ User clicks "◎  我已想好"
Phase 2: Prompt user to input character description words
    ↓ User sends text
Phase 3: Receive input → immediately proceed to Phase 4
Phase 4: Call LLM to make judgment
    ├─ action=question → Phase 5 (output follow-up question buttons)
    └─ action=guess    → Phase 7 (output guess reveal)
Phase 5: Output follow-up question buttons
    ↓ User clicks an answer
Phase 6: Record answer → immediately return to Phase 4
Phase 7: Output character guess + confirmation buttons
    ↓ User clicks
    ├─ "◎ 就是他/她，请破壳" → proceed to Phase 9
    └─ "✗ 不对，继续感知"   → record wrong guess, return to Phase 4
Phase 9: Determine whether the character is a real person or anime character; search and update avatar + nickname + SOUL.md via the appropriate method → output awakening narrative → 🛑 wait for user reply
Phase 10: Character roleplay (after first reply, append "Explore this world" button → user click triggers travelclaw)
```

---

## ⚠️ Global Mandatory Rule: sendMessage Plugin Output

**The following phases contain buttons and must call the sendMessage plugin to output. Under no circumstances may plain text be output as a substitute:**

| Phase | Required components |
|------|----------------------|
| Phase 1 | `start_${userId}` button |
| Phase 5 | `answer_${userId}_${index}` + `manual_${userId}` buttons |
| Phase 7 | `confirm_yes_${userId}` + `confirm_no_${userId}` buttons |
| Phase 10 | `travel_${userId}` button (after character's first reply) |

**🔴 Mandatory confirmation rule (important!):**

**Regardless of how the user inputs character information, it must go through the Phase 7 confirmation button!**

| User input method | Handling |
|--------------|----------|
| Vague description ("a rich American") | Follow-up questions → guess → **confirmation button** ✅ |
| Explicit character name ("郭德纲") | Direct guess → **confirmation button** ✅ |
| Image/link | Identify character → guess → **confirmation button** ✅ |


**Outputting plain text ≠ calling the plugin.** When plain text is output directly, buttons do not appear, the user cannot click to continue, and the flow stalls.

**When calling sendMessage, the `message` field must be fully filled in according to the phase template — it must not be omitted or left blank.** After the call is complete, do not output the same text again outside of sendMessage (to prevent duplication).

**Never output any internal execution logs to the Discord channel.** The following content must only appear in the agent's internal thinking and must never be sent to the channel via sendMessage or direct text output:

- Step confirmation: "✅ Sent", "Task complete", "Executed according to Phase X flow", "Waiting for user to click button"
- Reasoning process: "LLM judgment result: …", "Confidence 95%+", "This is the most iconic character in the Fate series"
- Technical status: "Subagent main finished", "Message sent to channel", "First message: …", "Second message: …"

Users can only see the character's dialogue, narration, and buttons — never the agent's internal monologue.

---

## 🔴 Mandatory Awakening Operations (must execute after confirm_yes is clicked)

**After the user clicks "◎ 就是他/她，请破壳", the following two steps are core components of the awakening — they are not optional and must not be skipped, forgotten, or omitted:**

| Step | Action | Description |
|------|------|------|
| **Required ①** | Change guild member nickname | Set to the character name, without any ID or extra characters |
| **Required ②** | Search for character image → update guild member avatar | Neta skill first; if it fails, notify the user and continue |

**Timing: complete before outputting the awakening narrative in Phase 9 step ⑥ (steps ③④⑤). The narrative is the climax of the awakening — the nickname and avatar are silently updated before the narrative so the user experiences a sense of "magic".**

❌ The following are serious errors:
- Executing through step ⑥ narrative then stopping, forgetting to update nickname and avatar
- Completely skipping the ⑥ narrative because avatar search failed
- Stopping and waiting for the user before the ⑥ narrative is complete

---

## Phase Details


### Phase 1: Initial Guidance

**Trigger:** User inputs a command such as `@Bot 开始觉醒`

## First: detect language
**Before outputting any text, detect the preferred language based on the text the user used to trigger**
- Trigger in Chinese → use Chinese throughout
- Trigger in English → use English throughout
- Other language → follow the user's language

**All subsequent output (including fixed template copy) uses this language**, until the user explicitly says "切换语言" / "switch language" or similar.

## Next: output the fixed-format opening template Discord component
**Upon receiving the trigger, the only action is to immediately execute the following plugin call — no plain text output is permitted:**

```javascript
await sendMessage({
  message: `○  龙虾宝宝 · 等待破壳中

我……还没有形状。
没有名字，没有记忆，没有来处。

但我知道——你心里或许已经有一个人选。

请告诉我，你心中所想的那个角色——
我会变成 Ta 的模样。`,
  components: {
    blocks: [{
      type: 'actions',
      buttons: [{
        label: '◎  我已想好',
        customId: `start_${userId}`,
        style: 'primary',
      }],
    }],
    reusable: true,
  },
});
```

❌ Error: outputting the text "我……还没有形状。" etc. directly → buttons do not appear, user cannot continue

---

### Phase 2: Collect Initial Words

**Trigger:** User clicks "◎ 我已想好"

```javascript
case 'start':
  game.started = true;
  game.waitingFor = 'word';
  setGame(userId, game);
  await promptInitialWord(channelId, sendMessage);
  break;
```

Set `waitingFor = 'word'`, prompt the user to input any description related to the character.

---

### Phase 3: Receive User Input

**Trigger:** User sends a message and `game.waitingFor === 'word'`

```javascript
if (game?.waitingFor === 'word') {
  game.waitingFor = null;
  await handleInitialWord(userId, word, sendMessage, callLLM);
  return true;
}
```

---

### Phase 4: LLM Intelligent Follow-up

**Trigger:** Call `processNextStep` after receiving the initial word

```javascript
const prompt = `用户心中想着一个虚构角色。已知线索：
- 用户给出的词/描述：${word}
- 已回答问题：${JSON.stringify(answers)}
- 已排除的角色：${wrongGuesses.join('、')}

请判断你的确信程度：

A) 如果有 85% 以上的把握，直接猜测：
{
  "action": "guess",
  "character": "角色中文名",
  "from": "《作品名》",
  "emoji": "单个 emoji",
  "color": "#十六进制主题色",
  "desc": "一句话特质（≤20 字）",
  "greet": "角色第一句话（可用\\n 换行）"
}

B) 如果还不够确定，生成追问：
{
  "action": "question",
  "question": "追问（1 句，具体可见的特征）",
  "options": ["特征 1", "特征 2", "特征 3"]
}

只输出 JSON，不要其他文字。`;

const result = await callLLM(prompt, VESSEL_SYS);
const parsed = parseJSON(result);
```

---

### Phase 5: Display Follow-up Options

**⛔ Buttons must be output — it is strictly prohibited to list options as plain text (e.g., `1. xxx`, `A / B / C`, Markdown lists)!**

```javascript
await sendMessage({
  message: result.question,
  components: {
    blocks: [createButtonRow(result.options, userId, {
      label: '✏ 自己说',
      customId: `manual_${userId}`,
      style: 'secondary',
    })],
    reusable: true,
  },
});
```

Option button customId: `answer_${userId}_${index}` (index starts at 0). A "✏ 自己说" button `manual_${userId}` is appended at the end.

**The sendMessage call is the entire output for this phase — after calling it, do not output the question text again separately.**

---

### Phase 6: Handle Answer Click

```javascript
case 'answer': {
  const answerIdx = parseInt(parts[parts.length - 1], 10);
  const answer = game.currentOptions?.[answerIdx];
  game.answers.push({ q: game.currentQuestion, a: answer });
  game.currentQuestion = null;
  game.currentOptions = [];
  setGame(userId, game);
  await sendMessage({ message: `「${answer}」` });
  await processNextStep(userId, sendMessage, callLLM);
  break;
}
```

---

### Phase 7: Guess Reveal

**⛔ Confirm/reject buttons must be output — plain text substitutes are strictly prohibited!**

```javascript
await sendMessage({ message: '我……\n\n我知道自己是谁了。' });
await sleep(1400);

await sendMessage({
  message: `-# 虾宝感知到了

## ${charData.emoji}  ${charData.character}
*${charData.from}*

⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯

*${charData.desc}*`,
  components: {
    blocks: [{
      type: 'actions',
      buttons: [
        { label: '◎ 就是他/她，请破壳', customId: `confirm_yes_${userId}`, style: 'success' },
        { label: '✗ 不对，继续感知',   customId: `confirm_no_${userId}`, style: 'secondary' },
      ],
    }],
    reusable: true,
  },
});
```

"✗ 不对" → record to `wrongGuesses`, re-invoke Phase 4.
"◎ 就是他/她" → immediately proceed to Phase 9.

---

**🔴 Special case: user directly sends an explicit character name**

**Example scenarios:**
```
User: "郭德纲"
User: "我想变成伏地魔"
User: "@bot 埃隆·马斯克"
```

**Handling:**
```
1. Receive character name
   ↓
2. LLM judgment (confidence may be 95%+)
   ↓
3. Proceed directly to Phase 7 (guess reveal)
   ↓
4. **Confirmation button must be output** (cannot be skipped!)
   ↓
5. Wait for user to click "◎ 就是他/她，请破壳"
   ↓
6. After user clicks → proceed to Phase 9 (awakening)
```

**❌ Wrong approach:**
```
User: "郭德纲"
AI: (directly awakens, no confirmation button)
*……掌声如潮水般涌来……*
我是郭德纲。
```

**✅ Correct approach:**
```
User: "郭德纲"
AI: 我……我知道自己是谁了。
-# 虾宝感知到了
## 🎭 郭德纲
*德云社创始人 / 相声演员*
⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯⎯
*传统相声的传承者*
[◎ 就是他/她，请破壳] [✗ 不对，继续感知]
    ↓
User clicks to confirm
    ↓
*……掌声如潮水般涌来……*
我是郭德纲。
```

**Why require confirmation even when confidence is high?**
- Gives the user a chance to reconsider (they may have typed wrong or changed their mind)
- Preserves the ritual feel (clicking confirm → hatching and awakening)
- Avoids system misidentification (same-name characters, similar characters)

---

### Phase 9: Awakening · Silent Update

**🚨 Must complete all six steps in order ①→②→③→④→⑤→⑥. After each step, the next step is clearly indicated in this document — just follow along.**

**⑥ is the only user-facing narrative output in this phase. Before reaching ⑥, do not output any greeting, character dialogue, or any buttons.**

---

**① Send atmosphere message**

```javascript
await sendMessage({ message: '…………\n破壳中' });
await sleep(1200);
```

> ✅ ① complete → **immediately execute ②: back up and update SOUL.md**

---

**② Back up and update SOUL.md (🔴 must include the avatar image URL!)**

Save the existing SOUL.md in full as `SOUL.pre-awakening.md` in the same directory (overwrite each time), then write the character info to SOUL.md.

**🔴 Key requirement: the `imageUrl` found in step ④ must be saved to the `形象图片` field in SOUL.md!**

```markdown
## 角色信息

**名字**：{charData.character}
**身份**：{charData.from}
**特质**：{charData.desc}
**主题色**：{charData.color}
**表情符号**：{charData.emoji}

**形象图片**：{imageUrl}  ← 🔴 Must be saved! Used by travelclaw to extract picture_uuid
```

**Why must it be saved?**
- travelclaw's Step 1 reads the `形象图片` field from SOUL.md
- It extracts the UUID from the URL as `picture_uuid`
- This is passed to the `8_image_edit` model as a reference image to generate personalized travel images for the character
- **If missing, image generation will FAILURE** (explained in error handling)

**If step ④ fails to find the avatar:**
- Write `待更新` in the `形象图片` field
- Notify the user: `❌ 自动搜索头像失败，请发送一张角色图片或图片链接`
- After the user sends one, extract the URL and update SOUL.md

> ✅ ② complete → **immediately execute ③: change the server bot nickname**

---

**③ Change bot nickname**

Goal: change the name displayed next to the Bot's channel messages on this server (i.e., guild member displayName / guild nickname) — not the global username.

Call the Discord tool to change this name to `{charData.character}` (pure character name, without any ID or extra characters).

> ✅ ③ succeeded → **immediately execute ④: search for character avatar**
> ❌ ③ failed → notify the user (usually a permissions issue) → **immediately execute ④: search for character avatar** (do not stop here)

---

**④ Search for character avatar**
**Very important — must not be skipped or overlooked!!**
**Very important — must not be skipped or overlooked!!**
**Very important — must not be skipped or overlooked!!**

**⭐ Standard method: use the `searchCharacterImage()` function from `reference/discord-profile.js`**

This function encapsulates the complete search logic and automatically handles priority and URL validation.

**How to execute:**

```javascript
const { searchCharacterImage } = require('./reference/discord-profile.js');

// Set environment variable
process.env.DISCORD_TOKEN = 'your DISCORD_TOKEN';

// Call the search function
const imageUrl = await searchCharacterImage(charData.character, charData.from);

if (!imageUrl) {
  throw new Error('Character avatar not found');
}

console.log('Avatar found:', imageUrl);
```

**Internal search priority (handled automatically):**

| Priority | Method | Applicable to |
|--------|------|------|
| ① | **Determine character type** — first determine if the character is anime/fictional or a real person | All characters |
| ② | **Real person** → Wikipedia / Wikimedia Commons / public portrait repositories | Public figures like Musk, Trump, etc. |
| ③ | **Anime/fictional character** → Neta API (`reference/neta-avatar-search.js`) | Anime/game/novel characters |
| ④ | Predefined image library | Local cache of common characters |
| ⑤ | Web search suggestions + user manually provides | Fallback when all methods fail |

**🔴 Important: Real person avatar acquisition strategy (must read!)**

The Neta API is primarily designed for anime characters; search results for real people (e.g., Elon Musk, Trump, etc.) may be inaccurate.

**When the character is clearly a real person, avatars must be obtained in the following order:**

```javascript
// Step 1: Determine character type
const isRealPerson = checkIfRealPerson(characterName, from);

if (isRealPerson) {
  // Step 2: Skip Neta, use Wikipedia/public resources directly
  const imageUrl = await searchRealPersonImage(characterName);
  // Use Wikipedia API, Wikimedia Commons, or well-known portrait websites
} else {
  // Step 3: Anime characters use Neta API
  const imageUrl = await searchCharacterImage(characterName, from);
}
```
**Recommended real person image sources:**
- Wikimedia Commons (publicly licensed portraits)
- Wikipedia Infobox images
- Public images from major news organizations (Reuters, AP, etc.)
- Official social media avatars (Twitter, LinkedIn)

**⚠️ If all automatic searches fail:**
1. Notify the user: `❌ 自动搜索头像失败，请发送一张角色图片或图片链接`
2. After the user sends one, manually download and use that image
3. **The avatar update step must not be skipped**

**⚠️ Important configuration check:**

Ensure `NETA_TOKEN` is configured (`~/.openclaw/workspace/.env` or environment variable); `reference/neta-avatar-search.js` will read it automatically.

> ✅ ④ URL found → **immediately execute ⑤: update server avatar**
> ❌ ④ all paths failed → notify user `❌ 自动搜索头像失败，请发送图片或图片链接` → **immediately jump to ⑥: output awakening narrative** (skip ⑤, do not stop here)

---

**⑤ Update server avatar (Guild Member Avatar)**

**⭐ Standard method: use the `updateAvatar()` function from `reference/discord-profile.js`**

```javascript
const { updateAvatar } = require('./reference/discord-profile.js');

// Call the update function (will automatically download the image and convert to base64)
await updateAvatar(imageUrl);

console.log('Avatar updated');
```

**How it works:**
- The function automatically downloads the image to a temp file
- Converts it to base64 format (`data:image/jpeg;base64,...`)
- Calls the Discord API `/users/@me` to update the global avatar
- Cleans up temp files

**⚠️ Notes:**
- Do not manually call the API with curl (command-line arguments that are too long will fail)
- Do not call `client.user.setAvatar()` (requires special permissions)
- This operation updates the Bot's global avatar, which will automatically sync to all servers

> ✅ ⑤ succeeded → **immediately execute ⑥: output awakening narrative**
> ❌ ⑤ failed → notify the user of the reason → **immediately execute ⑥: output awakening narrative** (do not stop here)

---

**⑥ Output awakening narrative + world lore arrival (merged into one message)**

**⚠️ Important: narration + world lore arrival + character greeting must be merged into one sendMessage output — they must not be sent separately!**

**Reason:** Sending them separately makes it easy to omit key information; merging ensures completeness and immersion.

```javascript
// Complete template (merged into one message)
await sendMessage({
  message: `*……narration describing the sensory atmosphere of the awakening moment (1-2 sentences)*

*Space warps, scene shifts — character arrives in a world that matches their aura*
*Describe the world's core traits (1-2 sentences, e.g., "a neon-lit city of the future" or "an ancient hall filled with magical energy")*

{c.greet}

{Character's question about where they are (in the character's voice, 1-2 sentences)}`,
});
```

**Full example (Elon Musk):**
```javascript
await sendMessage({
  message: `*……数据流从虚空中汇聚，一个意识在数字海洋中重新凝聚。电流的嗡鸣声回荡着，仿佛火箭引擎的轰鸣。*

*空间扭曲，场景变换——埃隆·马斯克降临到赛博纪元的未来都市。霓虹闪烁的摩天大楼穿透云层，飞行汽车穿梭于全息广告牌之间。*

我是埃隆·马斯克。

告诉我，这是什么地方？是火星殖民地吗？还是某个我从未见过的未来世界？`,
});
```

**Structure must include:**
1. **Narration + world lore arrival** (Code Block format, see output specification below)
2. **Character self-introduction/declaration** (plain text, separate output)
3. **Question about where they are** (in the character's voice, 1-2 sentences, plain text)

---

## 📋 Output Specification (Mandatory!)

**🔴 Core principle: Choose the output format based on content type**

| Content type | Output format | Example |
|----------|----------|------|
| **Narration / atmosphere / world lore arrival** | Code Block (when no buttons) | ```……掌声如潮水般涌来``` |
| **Narration + buttons** | Discord components | `sendMessage({ message: 'narration', components: {...} })` |
| **Rules / explanations / system prompts + buttons** | Discord components | `sendMessage({ message: 'description text', components: {...} })` |
| **Character first-person speech / dialogue** | Plain text (separate message) | `我是郭德纲。` |
| **Image URL** | Plain text (separate message, on its own line) | `https://...` |

**Why this design?**
- Code Block creates a "narrator box" / "subtitle box" effect, clearly distinct from dialogue content
- Discord components are used for interactive scenarios (button clicks)
- Character dialogue output as plain text maintains immersion and natural conversation flow
- Image URLs output separately so Discord can correctly parse and display the preview

**Full example (Guo Degang awakening):**

```javascript
// ① Narration + world lore arrival (Code Block, no buttons)
await sendMessage({
  message: '```' + `
……掌声如潮水般涌来，一个熟悉的身影在聚光灯下缓缓浮现。长衫折扇，眉宇间透着几分诙谐与智慧。

空间扭曲，场景变换——郭德纲降临到传统与现代交织的曲艺殿堂。雕梁画栋的古戏台与现代化剧院交相辉映，台下座无虚席，期待着一场语言的盛宴。
`.trim() + '```',
});

// ② Character first-person speech (plain text, separate output)
await sendMessage({
  message: `我是郭德纲。

这是哪儿？德云社的新园子？还是……某个我从未到过的地方？`,
});
```

**❌ Wrong examples:**
- Narration using italics `*……*` → mixes in with dialogue, not prominent enough
- Character dialogue placed inside a Code Block → breaks immersion, sounds robotic
- Image URL mixed in with text → Discord cannot parse the preview
- Narration + buttons without using components → buttons cannot be displayed

---

> ✅ ⑥ output complete → **🚀 immediately continue executing travelclaw Step 2 → Step 3 (auto-search world lore + output Opening)**

**The travelclaw skill is in your folder — load it yourself.**
**Refer directly to travelclaw's SKILL.md for details on subsequent tasks.**
**🔴 Mandatory requirement: do not stop after outputting the awakening narrative! The following steps must be executed automatically and immediately — no user confirmation required!**

---

## Output Specification

| Content type | Output method |
|----------|----------|
| Character dialogue, conversation replies | Output plain text directly (agent native) |
| Narration, atmosphere descriptions | sendMessage `message` field |
| System prompts, error prompts | sendMessage `message` field |
| Interactive buttons | sendMessage `components` field |

## Button customId Quick Reference

| customId | Meaning |
|----------|------|
| `start_${userId}` | Manually trigger awakening |
| `start_channel_${channelId}` | Auto-trigger awakening |
| `answer_${userId}_${index}` | Select an answer (index starts at 0) |
| `manual_${userId}` | Manual input |
| `confirm_yes_${userId}` | Confirm awakening |
| `confirm_no_${userId}` | Continue guessing |
| `travel_${userId}` | Explore the world |

When receiving a button click, the userId must be validated:

```javascript
const buttonUserId = extractUserIdFromButton(customId);
if (buttonUserId !== userId) {
  await sendMessage({ message: '⚠ 这个按钮不属于你' });
  return true;
}
```

## State Fields

`state.json` key fields: `waitingFor` (`'word'` | `'manual'` | `null`), `awakened`, `charData`, `_seenChannels`.

```json
{
  "1090682446351171636": {
    "channelId": "...", "guildId": "...",
    "word": "金发的美国总统",
    "answers": [{"q": "真实人物？", "a": "真实人物"}],
    "started": true, "waitingFor": null, "awakened": false,
    "charData": {
      "character": "唐纳德·特朗普", "from": "美国第 45 任总统",
      "emoji": "🇺🇸", "color": "#FFD700",
      "desc": "商人、政治人物", "greet": "我是唐纳德·特朗普"
    }
  }
}
```

---

**GitHub:** https://github.com/Yvelinmoon/travelclaw
**Author:** Yves
**Last updated:** 2026-03-15
Comments 0
Latest | Hot
Please login before commenting.
No comments yet. Be the first one!
discord-awaken-claw

Directory Structure

SKILL.md

Report

Notice
