clawbot补全延迟等问题源于自动保存与ai触发未协同，需依次配置实时保存监听、claude code流式补全钩子、本地ollama备用引擎、tree-sitter语法解析校准及增量缓存。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在使用ClawBot进行代码编写时发现补全响应延迟、无法自动触发或编辑后未保存即丢失上下文，则可能是由于代码自动保存机制与AI补全触发策略未协同配置。以下是解决此问题的步骤：
一、启用编辑器实时保存监听
ClawBot需通过文件系统事件感知代码变更，才能触发后续补全逻辑。该机制依赖底层inotify（Linux/macOS）或ReadDirectoryChangesW（Windows）监听当前工作目录中.py、.js等源码文件的写入动作。
1、打开ClawBot安装目录下的config/agents.json文件；
2、定位到"editor"节点，确认"autoSaveOnEdit"字段值为true；
3、检查"watchedExtensions"数组是否包含您正在使用的语言后缀，例如[".py", ".js", ".ts", ".rs"]；
4、若使用VS Code插件模式，还需在VS Code设置中启用"clawbot.editor.autoSave"并设为"afterDelay"。
二、配置Claude Code API流式补全钩子
自动保存仅是触发条件，真正执行补全需绑定至Claude Code模型的/v1/chat/completions端点，并启用stream: true与tools参数支持，使ClawBot能在保存瞬间提交带上下文窗口的补全请求。
1、进入~/.clawdbot/config.json，找到"models"节下的"claude-code"配置块；
2、确保"streaming"字段为true，且"maxTokens"不低于512；
3、在"tools"数组中添加类型为"code_completion"的工具定义，其中"triggerOnSave"设为true；
4、验证"contextWindow"值不小于8192字符，以覆盖当前文件+相邻函数的完整上下文。
三、部署本地Ollama模型作为备用补全引擎
当Claude Code API不可达或响应超时时，ClawBot可降级调用本地运行的轻量级代码模型（如codellama:7b或deepseek-coder:6.7b），避免补全链路中断。该方案绕过网络依赖，直接通过HTTP POST向http://localhost:11434/api/chat提交结构化提示。
1、在终端执行ollama run codellama:7b启动模型服务；
使用 @youdotcom-oss/teams-anthropic 将 Anthropic Claude 模型（Opus、Sonnet、Haiku）添加到 Microsoft Teams.ai 应用程序中。可选集成 You.com MCP 服务器以进行网页搜索和内容提取。
2、编辑config/models.json，新增"ollama-codellama"模型条目，指定"baseUrl"为"http://localhost:11434"；
3、在agents.defaults.fallbackModel中填入"ollama-codellama"；
4、重启ClawBot服务，观察日志中是否出现"Fallback model activated for completion"提示。
四、校准编辑器光标位置与补全范围映射
ClawBot需精确识别光标所在行、列及语法结构（如函数体、字符串字面量、注释区），否则可能返回无关补全。该能力由内置的Tree-sitter解析器驱动，必须加载对应语言的语法树查询规则。
1、确认~/.clawdbot/languages/目录下存在python.so、javascript.so等动态库文件；
2、在config/editor.json中检查"parser"字段是否指向正确路径，例如"/Users/xxx/.clawdbot/languages/python.so"；
3、手动触发一次补全（Ctrl+Space），查看控制台输出的"parsed scope: function_body"是否与实际光标位置一致；
4、若范围错误，在languages/queries/python/highlights.scm中调整(function_definition)捕获规则。
五、启用增量式补全文本缓存
为避免重复保存同一文件时反复请求AI，ClawBot支持基于文件哈希与光标偏移的本地缓存。当检测到相同内容片段已在.clawdbot/cache/completion/中存在有效记录，则直接复用历史补全结果，响应延迟趋近于0ms。
1、打开config/cache.json，将"completionCacheEnabled"设为true；
2、确认"cacheTTL"值大于300（单位：秒），防止缓存过早失效；
3、在"cachePath"字段中填写绝对路径，例如"/home/user/.clawdbot/cache/completion"；
4、执行clawdbot cache clean --stale命令清除陈旧缓存项，释放磁盘空间。
