Skip to main content
Clawdot 控制台 是你管理 API 接入的自助后台。本指南带你从注册账号开始,一步步创建 Agent、拿到 API Key、绑定终端用户,再到管理专属渠道与升级套餐。 控制台左侧共四个板块:
Clawdot 控制台全景

登录后的控制台首页,左侧是四个导航板块

1. 注册与登录

打开控制台地址,两种方式二选一注册:
  • Google 一键注册:点击 Continue with Google,用 Google 账号授权即可,无需设置密码。
  • 邮箱注册:填写 Name 和 Email,点击 Get code 获取邮箱验证码(60 秒内可重发一次),填入验证码并设置密码(至少 6 位)后,点击 Create account。
注册表单

邮箱注册表单:填好信息后点 Get code 获取验证码

注册成功后页面会展示为你自动创建的 API Key,建议点 Copy to Clipboard 保存。即使当时没保存也不要紧——之后可以在 Agents 页找到对应 Agent,点卡片上 Key 前缀旁的复制按钮,随时复制完整 API Key。
已有账号则在登录页用 Google 或邮箱 + 密码登录。
登录页

登录页

2. Dashboard:用量监控

进入控制台默认落在 Dashboard,用于日常观察调用量与健康度:
  • Requests Today:今日已用请求数 / 每日请求上限
  • Orders Today:今日已下单数 / 每日订单上限
  • Rate Limit:当前套餐的每分钟限速
  • Usage History:近 7 天每日请求数、错误数、平均延迟
卡片下方的进度条会随用量变色——超过 50% 转黄、超过 80% 转红。接近上限时,建议提前在 Settings 申请升级,避免触顶被限流。 配额上限由套餐档位决定,详见第 6 节。

3. Agents:创建 Agent 与管理 API Key

一个 Agent 对应你的一个接入方(一个应用、一个机器人、一条业务线),每个 Agent 持有独立的 API Key。可创建数量由套餐决定。
Agents 列表

Agents 列表:每张卡片是一个 Agent

3.1 创建 Agent

1

点击 New Agent

在 Agents 页右上角点击 New Agent。
2

填写信息

填写 Agent 名称(必填)和描述(可选)。
创建 Agent 表单

创建 Agent 表单

3

保存 API Key

点击 Create 后,页面顶部出现橙色横幅展示该 Agent 的完整 API Key,点 Copy 复制。横幅关闭后卡片上只显示 Key 前缀(如 clw_xxxx••••••••),但点前缀旁的复制按钮仍可随时复制完整 API Key。
API Key 横幅

新建成功后一次性展示的 API Key 横幅

横幅上的「Save this now」是一次性提示,但 Key 本身不会丢失——之后随时能在卡片上点复制按钮拿到完整 Key。只有想主动更换 Key 时才用 Rotate Key(会作废旧 Key)。

3.2 卡片上的日常操作

Agent 卡片

一张 Agent 卡片:包含 Rotate Key、Delete、绑定用户数、Key 前缀

Rotate Key 确认弹窗

Rotate Key 的二次确认弹窗

3.3 绑定用户(Bind User)

Agent 代表用户下单前,需要先完成一次用户授权绑定。点击卡片上的 Bind User,流程共三步:
1

输入手机号

填写用户的手机号,点击 Send Code,系统向该手机发送短信验证码。
绑定用户 - 手机号

绑定第一步:输入手机号

2

输入验证码

填入收到的 6 位验证码,点击 Bind(60 秒后可重发,也可返回改号)。
3

保存 Consent Grant ID

绑定成功后页面展示该用户的授权凭证 Consent Grant ID。调用 API 时通过请求参数 consent_grant_id(或请求头 X-Consent-Grant-Id)携带该凭证,即代表以该用户身份操作。
Consent Grant ID 仅展示一次,服务端只存哈希,请立即复制保存。对同一手机号重新走一遍绑定流程会签发新的 Consent Grant ID,旧的随即失效——请以最新一次下发的为准,并同步更新你的服务配置。
卡片上的「N users」可展开已绑定用户列表:手机号与授权 ID 均以掩码显示;用户超过 6 个时提供搜索框,可按手机号或授权 ID 片段过滤;右上角 + Bind 可继续绑定新用户。
已绑定用户列表

展开已绑定用户列表,手机号与授权 ID 均掩码显示

3.4 为 Agent 指派专属渠道

若你的套餐开通了渠道功能,Agent 卡片下方会出现渠道带,显示该 Agent 当前使用的下单渠道:默认显示「默认渠道(平台默认)」,点击 指派渠道 / 更换渠道 可从渠道池中已验证的渠道里选择,即刻生效;已指派的 Agent 可选择「恢复默认渠道」切回平台默认。
渠道指派下拉

展开渠道带,从已验证的渠道池中选择

渠道的添加与验证见第 5 节。

4. Settings 之前:先看套餐能力

在展开渠道功能之前,先了解一下不同套餐能做什么——渠道功能仅对 SUPERAGENT 与 PLATFORM 开放。套餐详情见第 6 节。

5. Channels:专属渠道池

非 superagent / platform 套餐进入该页会提示「渠道功能未开放」,请先在 Settings 申请升级。
渠道池是账户级的:一条渠道验证通过后,可指派给你名下任意多个 Agent 复用,也可随时切换。获得渠道有两条路径。
Channels 页概览

Channels 页:账户级渠道池 + 申请记录

5.1 已有饿了么渠道 → 「添加渠道」

如果你已经从饿了么获得了自己的渠道凭证,点击右上角 添加渠道 直接录入: 提交后渠道进入「待验证」状态;平台核验凭证有效后转为「已验证」,方可指派给 Agent(避免错误凭证导致订单归因错误)。
添加渠道表单

添加渠道表单

5.2 还没有渠道 → 「申请渠道」(平台代办)

没有饿了么渠道也可以点击 申请渠道,由平台代你向饿了么申请:
1

填写基本信息

填写 渠道平台名称 和 三方合作 logo URL(展示给用户的合作方 logo,建议 200×200 像素)。
2

(可选)接入三方收银

若需要接入三方收银台,勾选 同时接入三方收银,补充展开的六项支付信息(测试/生产支付接口、RSA2 公钥、客服电话、isv 代扣 PID / 账号)。
申请渠道表单

勾选三方收银后展开的附件字段

3

不会填?看填写指引

点击表单右上角 填写指引,右侧抽屉有逐项说明(含 RSA2 公钥生成方法、支付宝 PID 查询方法等)。
填写指引抽屉

填写指引抽屉:逐项说明

4

提交并跟踪进度

点击 提交申请。页面下方「申请记录」跟踪进度:处理中(平台正在开通)、已通过(凭证已存入上方渠道池,直接指派即可)、未通过(显示驳回原因,修正后可重新申请)。
申请记录列表

申请记录:不同状态一目了然

5.3 渠道卡片与指派

池中每条渠道以卡片展示:状态徽章(待验证 / 已验证 / 已停用)、渠道号、登录 source 可一键复制;secret 恒为掩码,出于安全不可见明文。已验证的渠道底部提供「指派给 Agent」下拉,选择 Agent 后点击 指派;已指派的 Agent 可随时取消指派(回落到平台默认渠道)。
渠道卡片

一张已验证渠道卡片,含状态徽章、字段行与指派区

6. Settings:账号资料与套餐升级

6.1 Profile

修改显示名称(Name)与公司(Company)后点击 Save Changes。邮箱不可修改,旁边的绿色 Verified 表示邮箱已验证。
Settings Profile

Profile 区块

6.2 套餐档位

Plan 区块展示四档套餐,当前档位有高亮边框和 Current 徽章: 专属渠道功能(Channels)仅对 SUPERAGENT 与 PLATFORM 开放。
套餐档位

四档套餐卡片,当前档高亮

6.3 申请升级

1

点击 Request Upgrade

在高于当前档位的套餐卡片上点击 Request Upgrade(只能向上申请)。
2

填写申请信息

填写 业务理由 / 用途(必填)、预估量(必填,如「预估日请求 30 万 / 日单 3000」)、联系方式(选填,便于沟通),点击 提交申请。
升级申请弹窗

升级申请弹窗

3

等待审核

同一时间只能有一个处理中的申请。下方「申请历史」可查看每次申请的状态;审核通过后套餐自动生效。

常见问题

不用担心。到 Agents 页找到对应 Agent,点卡片上 Key 前缀旁的复制按钮即可复制完整 API Key,无需 Rotate。只有当你想主动更换 Key 时才用 Rotate Key(会立即作废旧 Key,请先做好服务切换准备)。
专属渠道仅对 SUPERAGENT / PLATFORM 套餐开放。到 Settings → Plan 申请升级。
新录入的渠道需平台先验证凭证有效性(「待验证」→「已验证」),验证通过后才可指派,避免错误凭证导致订单归因错误。
Dashboard 进度条接近红色时,建议提前在 Settings 申请升级套餐,避免触顶后请求被限流。