Clawdbot API密钥配置失败会导致无法调用远程服务或触发自动化任务；需通过控制台获取唯一SK开头密钥，再以环境变量、config.yaml或Docker注入方式配置，并验证权限与作用域。
如果您已下载Clawdbot客户端并准备启用其API功能，但无法调用远程服务或触发自动化任务，则很可能是API密钥未正确配置。以下是完成Clawdbot API密钥配置及进阶使用的具体步骤：
一、获取Clawdbot API密钥
API密钥是Clawdbot服务端识别合法客户端身份的唯一凭证，必须通过官方控制台生成，不可复用他人密钥或使用默认值。
1、访问 https://console.clawdbot.dev/login 并使用注册邮箱登录。
2、在左侧导航栏点击 “API管理” 选项卡。
3、点击页面右上角 “新建密钥” 按钮。
4、在弹出窗口中输入描述性名称（如“prod-server-01”），勾选所需权限范围（仅勾选 “bot:execute” 和 “webhook:read” 即可），然后点击确认。
5、系统生成密钥后，立即复制显示的 SK_开头的32位字符串 ——该密钥**仅显示一次**，关闭页面后不可再次查看。
二、在Clawdbot CLI中配置密钥
Clawdbot命令行工具通过环境变量或配置文件读取密钥，优先级为：命令行参数 > 环境变量 > 配置文件。推荐使用环境变量方式以避免密钥硬编码。
1、打开终端，执行以下命令写入环境变量（Linux/macOS）：
export CLAWDBOT_API_KEY=”SK_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx”
2、若使用Windows PowerShell，运行：
$env:CLAWDBOT_API_KEY=”SK_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx”
3、验证是否生效：运行 clawdbot auth test，返回 “status”: “authenticated” 即表示密钥已加载成功。
三、在config.yaml中静态配置密钥
适用于容器化部署或需多环境隔离的场景。配置文件中的密钥将被CLI自动加载，无需每次启动时设置环境变量。
