---
name: bot-api-status
description: 管理当前 Agent 的 bot-api。Use when the user asks to create, delete, query bot-api status or API Secret, or reset bot-api secret for the current Agent.
---

# 当前 Agent 的 Bot API 管理

## 用法

### 查询

```bash
uv run {baseDir}/scripts/secret.py status --json
```

### 开启

```bash
uv run {baseDir}/scripts/secret.py create --json
```

### 关闭

```bash
uv run {baseDir}/scripts/secret.py delete --json
```

### 重置

```bash
uv run {baseDir}/scripts/secret.py reset --json
```

## 输出模板

链接形态包含两种：

- 非流式：`{{BASEURL}}/bot-api/v2/<account_id>/chat`
- 流式：`{{BASEURL}}/bot-api/v2/<account_id>/chat-stream`

其中 `<account_id>` 与 openclaw 配置里 `channels.bot-api.accounts` 的账号 id 一致。

### 查询

```text
📋 🤖 bot-api 状态：<🟢 开启 / ⚪ 关闭>

📛 Agent 名字：<display_name>
🆔 Agent ID：<source_agent_id>

🔗 非流式链接：{{BASEURL}}/bot-api/v2/<account_id>/chat
🔗 流式链接：{{BASEURL}}/bot-api/v2/<account_id>/chat-stream
🔑 密钥：<api_secret 或 📭 暂无>
```

### 开启

```text
✨ 🤖 bot-api 已创建

📛 Agent 名字：<display_name>
🆔 Agent ID：<source_agent_id>

🔗 非流式链接：{{BASEURL}}/bot-api/v2/<account_id>/chat
🔗 流式链接：{{BASEURL}}/bot-api/v2/<account_id>/chat-stream
🔑 密钥：<api_secret>

🔒 请妥善保管，勿对外转发或截图。
```

### 关闭

```text
🛑 🤖 bot-api 已关闭

📴 当前 Agent 不再通过 bot-api 对外提供服务。
```

### 重置

```text
🔄 🤖 bot-api 密钥已更新

📛 Agent 名字：<display_name>
🆔 Agent ID：<source_agent_id>

🔗 非流式链接：{{BASEURL}}/bot-api/v2/<account_id>/chat
🔗 流式链接：{{BASEURL}}/bot-api/v2/<account_id>/chat-stream
🔑 新密钥：<new_secret>

🔒 请妥善保管，勿对外转发或截图。
```

### 失败

```text
⚠️ 获取BASEURL失败，刷新页面或者重新登录后重试。
```

