Polo龙虾图标 Polo龙虾使用教程

Windows USB 便携版 · 官方图文手册

从解压启动,到完成第一个 AI 任务

Polo龙虾是一套本地优先的桌面 Agent。按本页顺序操作,可以完成模型连接、AI 对话、图片生成、能力扩展和自动化任务。

桌面端 2026.7.28 OpenClaw v2026.7.1-2 更新于 2026-09-16
Polo龙虾桌面端首页,左侧包含任务、专家套件、技能、MCP 和图片任务入口
当前桌面端首页:中间输入任务,底部选择项目目录、Agent 和模型;左侧进入各项功能。
01

解压完整目录并启动

便携版不是安装程序。程序、运行环境和用户数据都放在同一个可迁移目录中。

  1. 完整解压 ZIP。先把压缩包解压到本地磁盘或 U 盘,不要直接在压缩软件里双击运行。
  2. 双击 START-PORTABLE.cmd。也可以双击 Polo龙虾.exe;启动器会显式启用便携模式,更容易排查问题。
  3. 等待首次初始化。第一次启动需要展开运行环境并启动 AI 引擎,通常比后续启动慢。窗口出现后不要立刻重复双击。
Polo龙虾.exe桌面端主程序
START-PORTABLE.cmd推荐的便携启动入口
resources / locales程序运行文件,不要单独移动或删除
LobsterAI-Data聊天、配置、技能、任务结果和日志
不要只复制 EXE 迁移或分享便携包时,应复制整个目录。只复制 Polo龙虾.exe 会导致双击无反应、白屏或 AI 引擎缺失。
02

配置 cloud-gpt.cn 令牌

当前聊天、AI 处理模型和图片模型都从所选提供商获取。配置 GPT Cloud 后,侧栏会同步显示令牌余额。

  1. 点击左下角“设置”,进入“自定义模型”。
  2. 在模型提供商列表选择 GPT Cloud,粘贴你的 sk- 令牌。
  3. 确认 API Base URL 为 https://cloud-gpt.cn/v1,打开右上角启用开关。
  4. 点击“测试连接”。连接成功并出现可用模型列表后,点击右下角“保存”。
https://cloud-gpt.cn/v1
Polo龙虾自定义模型设置,GPT Cloud 已启用,API Key 已隐藏,Base URL 为 cloud-gpt.cn/v1
设置 → 自定义模型 → GPT Cloud。令牌输入框默认以圆点隐藏,截图不会显示完整密钥。
API Key在令牌中心获取,以 sk- 开头。不要发送给他人,也不要把完整值放进截图。
API Base URL使用 https://cloud-gpt.cn/v1,末尾保留 /v1。
可用模型列表连接成功后由远端接口拉取。模型变化时点击测试连接或重新打开设置刷新。
提供商开关必须处于“已开启”,否则聊天和 AI 处理模型不会使用这个提供商。
验证是否生效 保存后回到首页:模型下拉框能看到 GPT Cloud 模型,左下角出现“当前令牌余额”,即表示连接成功。
03

开始第一个 AI 对话

Polo龙虾的任务会在你指定的项目目录中工作。提交前先确认目录、Agent 和模型。

1. 选择目录

点击输入框下方的文件夹名称,选择本次任务可以读写的项目目录。

2. 选择 Agent

普通任务使用“主 Agent”;有专门角色时再切换其他 Agent。

3. 选择模型

点击右下角模型名称,按速度、能力和成本选择当前模型。

  1. 在中间输入框直接描述结果,例如“读取这个目录的 Excel,汇总成一份周报”。
  2. 需要附件时点击左下角的 +;需要套件能力时点击旁边的能力入口。
  3. 点击右侧发送按钮。执行过程中如需文件或系统权限,按提示确认。
  4. 要开始另一个独立任务,点击左侧“新建任务”;历史任务可从“搜索任务”找到。
Polo龙虾新建任务首页,任务输入框下方可选项目目录和 Agent,右侧可选模型
输入框下方从左到右是项目目录和 Agent;输入框右下角是模型选择与发送按钮。
提示词不需要写成固定格式 说清“要处理什么、最终交付什么、保存到哪里”即可。复杂任务可以附上源文件,Agent 会分步执行并展示进度。
04

图片任务:描述、参考图和异步生成

点击左侧“图片任务”。每次提交都会成为独立任务组,可以同时处理多个任务。

  1. 写图片描述。可直接写“一套”“多张”或明确数量,AI 处理模型会把需求拆成连续任务。
  2. 添加参考图片。可点击或拖入,最多 9 张,每张不超过 20 MB;支持 PNG、JPG、WEBP、GIF、BMP、AVIF。
  3. 选择两类模型。AI 处理模型负责理解和拆分,推荐 gpt-5.5;图片模型负责生成,默认 gpt-image-2。
  4. 设置输出。按用途选择尺寸、质量和 PNG/JPEG/WEBP 格式,然后点击“生成图片”。
  5. 在右侧查看。任务会立即出现在生成记录中,不会阻塞左侧表单;可继续提交新任务。
AI 处理中 排队中 逐张生成 已完成
Polo龙虾图片任务页面,左侧填写描述与参数,右侧显示完成的图片任务组
左侧配置任务,右侧显示 AI 理解结果、生成进度、图片预览和“打开目录”。任务结果会自动保存。
任务目录LobsterAI-Data/image-tasks/groups/任务ID/,参考图在 references,生成图在 outputs。
多图查看任务组封面显示第一张图片,可用左右切换按钮查看组内其他结果。
停止任务停止尚未完成的生成项,已成功生成并保存的图片不受影响。
删除任务删除任务记录和对应任务目录。重要图片请先点击“打开目录”另行保存。
分页每页可选 5、10 或 20 条,默认 5 条。
05

专家套件、技能和 MCP

三者都用于扩展 Agent,但层级不同:套件是场景能力包,技能是单项工作方法,MCP 是外部工具连接。

专家套件按办公文档、内容创作、在线研究、电脑操作等场景组合多个技能。进入“市场”点击安装,安装后在输入框能力入口使用。
技能提供文档、表格、演示文稿、网页搜索等具体能力。可在市场安装,也可从 ZIP、文件夹、GitHub 或 ClawHub 导入。
MCP把 Agent 接到浏览器、数据、企业服务或开发工具。优先从市场安装;自定义配置需要确认来源可信。
Polo龙虾专家套件市场,显示办公文档、在线研究、内容创作等套件
专家套件 → 市场。点击“安装”,完成后切到“已安装”查看并使用。
Polo龙虾技能页,显示已安装技能和启用开关
技能页:开关控制是否启用;右上角可添加或更新。
Polo龙虾 MCP 页面,包含已安装、市场和自定义标签
MCP 页:从市场安装,或在“自定义”中导入配置。
第三方扩展需要确认安全性 安装第三方技能或 MCP 前检查来源和权限。安全扫描提示文件、网络、命令或凭证访问风险时,应确认用途后再决定是否启用。
06

让任务按计划自动执行

定时任务适合早报、周报、项目巡检和固定提醒。可以从模板开始,也可以从空白创建。

  1. 点击左侧“定时任务”,选择模板或右上角“新建”。
  2. 填写任务标题、执行时间、任务指令、工作目录和模型。
  3. 启用任务并保存。可在“历史”标签查看每次运行结果。
  4. 需要提前验证时,打开任务详情并点击“立即运行”。
Polo龙虾定时任务页面,展示科技早报、每日工作收尾、会议准备等模板
内置模板已填好常见时间和任务框架,使用前补充自己的目录、模型和具体要求。
保持应用可运行 定时任务由本机 AI 引擎执行。到点时 Polo龙虾需要处于运行或托盘状态;长任务建议在设置中开启“防止休眠”。
07

查看余额和 Token 使用记录

配置 GPT Cloud 令牌后,左下角会显示当前余额。更换令牌并保存后,余额也会自动切换。

  1. 在左下角“当前令牌余额”卡片查看剩余额度。
  2. 点击卡片底部“使用记录”进入明细页。
  3. 明细包含时间、模型、费用、输入、输出、耗时和状态;右上角可刷新。
  4. 使用右侧“每页”选项和底部分页按钮浏览历史记录。
Polo龙虾 Token 使用记录页,显示总额度、剩余额度、已用额度和分页明细
完整令牌不会展示;页面只显示脱敏后的开头和结尾。费用按站点当前额度换算规则显示。

需要在浏览器管理令牌、充值或查询账户时,打开 令牌余额中心。

08

迁移、升级和备份

USB 便携版的关键是应用目录旁的 LobsterAI-Data。保留它,就能保留主要配置和本地数据。

整包迁移完全退出 Polo龙虾后,复制整个便携目录到新电脑或 U 盘,再运行 START-PORTABLE.cmd。
升级版本先备份旧目录。把旧版 LobsterAI-Data 放到新版程序同级目录,再启动新版完成迁移。
日常备份退出应用后复制 LobsterAI-Data;也可使用设置中的数据备份功能生成迁移包。
项目文件用户选择的外部项目目录不一定在 LobsterAI-Data 内,需要单独备份。
复制前先退出应用 运行中直接复制可能遗漏 SQLite 临时文件或正在写入的任务结果。确认窗口和系统托盘中的 Polo龙虾都已退出后再迁移。
09

常见问题排查

先定位是程序启动、网络令牌、模型服务还是扩展安装问题,再做对应处理。

双击没有反应、白屏或提示运行环境缺失
  1. 确认压缩包已完整解压,不是在压缩软件预览中运行。
  2. 使用 START-PORTABLE.cmd 启动,并等待首次初始化。
  3. 确认 resources、locales、portable.flag 和 LobsterAI-Data 与 EXE 同级。
  4. 把整个目录加入安全软件允许列表;若文件曾被隔离,重新解压完整包。
模型列表加载失败或发送任务失败

回到设置 → 自定义模型 → GPT Cloud,检查令牌、Base URL 和启用开关,然后点“测试连接”。代理环境下可在设置 → 通用开启“使用系统代理”,保存后重试。

图片模型能看到,但生成一直失败

先查看余额是否充足,再检查参考图格式和大小。点击图片任务右上角刷新模型;失败任务可直接重试。若远端返回具体错误,以右侧任务卡片中的错误信息为准。

专家套件或技能安装失败

确认网络可访问扩展源、便携目录有写入权限,并检查安全软件是否拦截下载或解压。不要把程序放在只读目录;重启应用后再安装。仍失败时保留错误截图和 LobsterAI-Data/logs。

余额没有跟着新令牌变化

在 GPT Cloud 设置中粘贴新令牌并点击“保存”,然后回到首页等待自动刷新;也可以进入“使用记录”点击右上角刷新。只修改输入框但没有保存不会切换。

删除图片任务后,为什么本地文件也没了

当前版本删除任务会同时清理对应任务组目录。需要长期保留的成品,请先点击“打开目录”,复制到项目目录或其他备份位置。

仍然无法解决?

提供桌面端版本、错误截图、操作步骤和日志时间点,能更快定位问题。请勿发送完整 API Key。

请通过原购买渠道反馈