核心用法
Rei 技能为 Clawdbot 提供 Qwen3 Coder 模型的接入能力，通过 OpenAI 兼容端点 coder.reilabs.org 实现无缝集成。支持三种配置方式：
1. 一键脚本部署：执行 ./skills/rei/scripts/setup.sh YOUR_REI_API_KEY 自动完成提供商注册、模型白名单添加及网关重启
2. 对话式配置：直接向 Agent 发送 "Set up Rei with API key: YOUR_KEY"，由 Agent 读取技能并执行脚本
3. 手动 JSON 配置：在 ~/.clawdbot/clawdbot.json 中精确配置 providers、headers 及模型别名
模型切换支持 /model rei 指令、专用切换脚本或自然语言指令（"Switch to Rei"）。若配置异常，可通过 ./skills/rei/scripts/revert.sh 一键回滚备份。
显著优点
- 零摩擦集成：脚本化部署将传统手动配置的 10+ 步骤压缩为单次命令执行
- 故障自愈：内置 revert 机制与备份恢复，降低试错成本
- 多交互范式：覆盖命令行、结构化对话、手动编辑三种用户习惯
- 错误预判：针对 403 错误的 User-Agent 头强制要求已在脚本中自动化处理
潜在局限
- 密钥管理风险：API key 以明文形式传入脚本参数，可能暴露于 shell history 或进程列表
- 单点依赖：端点
coder.reilabs.org若不可用则全服务中断，无备用节点配置 - 配置耦合：JSON 配置需精确匹配嵌套结构，手动编辑易因括号层级错误导致解析失败
- 权限盲区：未说明 Rei API key 的权限范围（如速率限制、可用模型版本），用户难以预判配额消耗
适合人群
- 追求「配置即运行」的效率型开发者
- 需要临时切换至 Qwen3 Coder 进行代码补全/生成任务的 Clawdbot 用户
- 遭遇 403 错误需快速排查 headers 配置的技术支持场景
常规风险
| 风险类型 | 描述 | 缓解建议 |
|---------|------|---------|
| 密钥泄露 | 脚本参数明文传输 | 优先使用对话式配置，或在脚本执行后立即清理 shell history |
| 配置回滚失败 | revert.sh 依赖备份文件完整性 | 重大变更前手动备份 `clawdbot.json` |
| 端点不可用 | reilabs.org 服务状态不受本地控制 | 生产环境建议配置 fallback 模型 |
| 版本漂移 | Qwen3 Coder 模型迭代可能未同步更新 | 关注 `contextWindow` 与 `maxTokens` 参数变更公告 |