clawdbot激活失败需按五步排查：一核对版本/架构/初始化；二用clawdbot activate注入激活码并校验；三隔离环境可离线导入license.lic；四超设备数需revoke释放绑定；五检查目录权限、node.js版本及错误日志。
如果您已获得Clawdbot激活码，但无法完成授权验证或系统提示未激活，则可能是由于激活码未正确输入、环境未满足前置条件或授权服务未正常连接。以下是完成Clawdbot激活授权与安装激活全过程的操作步骤：
一、确认激活码适用版本与环境匹配
Clawdbot的激活码具有绑定属性，仅适用于特定部署形态（如Clawdbot Pro、Clawdbot Enterprise或ClawdHub订阅版），且需与安装时所选后端模型、运行平台（Linux/macOS/WSL2）及架构（ARM64/AMD64）一致。使用前必须核对激活码发放渠道标注的适用范围。
1、打开终端，执行clawdbot --version确认当前安装版本号，比对激活码邮件或购买凭证中注明的版本标识。
2、运行uname -m检查系统架构，确保与激活码支持的架构一致（例如：aarch64对应ARM64，x86_64对应AMD64）。
3、若为Clawdbot Pro用户，需确认已通过clawdbot onboard完成基础初始化，否则激活命令将被拒绝。
二、通过命令行注入激活码完成授权
Clawdbot采用离线签名+在线校验混合机制，激活码需通过clawdbot activate命令注入本地授权文件，并触发一次联网校验（仅首次激活必需）。该过程不上传模型密钥或用户数据。
1、在终端中执行：clawdbot activate --token <strong><font color="green">your_activation_token_here</font></strong>，将your_activation_token_here替换为实际激活码（注意保留前后空格，不可含换行或不可见字符）。
2、系统将自动创建~/.clawdbot/license.lic并尝试连接ClawdHub授权服务器。若网络受限，可添加--offline参数跳过实时校验，但部分Pro功能将受限。
3、执行clawdbot license status验证状态，输出中status: active且expires_at字段显示有效截止时间，即表示激活成功。
三、手动导入License文件方式（适用于隔离网络环境）
当目标设备完全断网或企业防火墙拦截授权请求时，可采用离线License文件导入方式。该方式依赖预先生成的加密许可文件，需与激活码一一对应。
1、访问ClawdHub官方授权门户（需登录购买账户），在“My Licenses”页选择对应激活码，点击“Generate Offline License”，下载生成的license.lic文件。
2、将该文件通过U盘或内网传输至目标设备，存放至用户主目录下的.clawdbot/路径（若路径不存在，请先执行mkdir -p ~/.clawdbot）。
3、运行clawdbot license import ~/.clawdbot/license.lic，系统将校验签名并写入本地授权数据库。
4、再次执行clawdbot license status，确认mode字段显示offline且状态为active。
四、重置授权并重新绑定新设备
Clawdbot默认允许单激活码绑定至最多3台设备。若更换硬件、重装系统或触发设备指纹变更，需主动释放旧设备授权，否则新设备激活将失败。
1、在任一已激活设备上运行：clawdbot license revoke --all，此操作将解除该账号下所有设备的绑定。
2、若仅需释放某一台设备，先执行clawdbot license list获取设备ID列表，再运行clawdbot license revoke --device-id <strong><font color="green">device_id_from_list</font></strong>。
3、完成释放后，立即在新设备上执行步骤二中的激活命令，避免因并发请求导致临时锁限。
五、排查常见激活失败原因
激活失败通常由环境配置冲突或权限异常引发，而非激活码本身错误。系统日志会明确指向具体环节，无需重复输入激活码。
1、检查~/.clawdbot/目录权限是否为当前用户可读写，执行ls -ld ~/.clawdbot，若属主非当前用户，运行sudo chown -R $USER:$USER ~/.clawdbot修复。
2、确认Node.js版本为22.x或更高，运行node -v验证；若版本不符，激活进程将中断并报错ERR_UNSUPPORTED_NODE_VERSION。
3、查看详细错误日志：clawdbot log tail --level error --limit 20，重点关注含activation、license或signature关键词的条目。
