常见命令与报错处理
这一页用于快速查找 Cline 常用检查方式，以及接入 Xikapi 时常见问题的排查方法。
常用命令
| 目标 | 命令 |
|---|---|
| 查看版本 | cline version |
| 查看帮助 | cline --help |
| 进入认证流程 | cline auth |
| 直接执行任务 | cline "任务描述" |
CLI 参数可能随版本变化。涉及自动批准、headless、CI 的场景，先运行：
bash
cline --help确认当前版本参数含义。
Invalid API Key
检查：
- API Key 是否复制完整。
- API Key 是否属于 Xikapi。
- Cline 中选择的是
OpenAI Compatible，不是普通OpenAI。 - Base URL 是否为
https://xikapi.com/v1。
Model Not Found
常见原因：
- 模型没有在 Xikapi 后台启用。
- Model ID 拼写错误。
- 把 OpenClaw 的
xikapi/模型名写法误填进了 Cline。 - 当前 API Key 所在分组没有该模型权限。
404 或连接失败
优先检查 Base URL：
text
https://xikapi.com/v1不要填写：
text
https://xikapi.com/v1/chat/completions如果 Base URL 正确，再检查本机网络、代理、防火墙和 Xikapi 服务状态。
回复慢或成本高
- 换用更快或更便宜的模型。
- 把任务拆小，不要一次性让它读整个仓库。
- 明确指定相关文件或目录。
- 先让它列计划，再决定是否继续。
- 避免在大项目中反复上传超大上下文。
一直要求确认
这是正常行为。编辑器里的 Cline 会让你确认文件修改和命令执行。新手建议保留确认流程；熟悉后再针对低风险命令开启 Auto Approve。
CLI 用户要反过来注意：直接执行任务或 headless 场景可能更自动化。自动化前先确认当前版本的 cline --help 输出，并只在低风险任务中使用自动批准参数。