解压完整目录并启动
便携版不是安装程序。程序、运行环境和用户数据都放在同一个可迁移目录中。
- 完整解压 ZIP。先把压缩包解压到本地磁盘或 U 盘,不要直接在压缩软件里双击运行。
- 双击
START-PORTABLE.cmd。也可以双击Polo龙虾.exe;启动器会显式启用便携模式,更容易排查问题。 - 等待首次初始化。第一次启动需要展开运行环境并启动 AI 引擎,通常比后续启动慢。窗口出现后不要立刻重复双击。
Polo龙虾.exe 会导致双击无反应、白屏或 AI 引擎缺失。
配置 cloud-gpt.cn 令牌
当前聊天、AI 处理模型和图片模型都从所选提供商获取。配置 GPT Cloud 后,侧栏会同步显示令牌余额。
- 点击左下角“设置”,进入“自定义模型”。
- 在模型提供商列表选择 GPT Cloud,粘贴你的
sk-令牌。 - 确认 API Base URL 为
https://cloud-gpt.cn/v1,打开右上角启用开关。 - 点击“测试连接”。连接成功并出现可用模型列表后,点击右下角“保存”。
https://cloud-gpt.cn/v1
| API Key | 在令牌中心获取,以 sk- 开头。不要发送给他人,也不要把完整值放进截图。 |
|---|---|
| API Base URL | 使用 https://cloud-gpt.cn/v1,末尾保留 /v1。 |
| 可用模型列表 | 连接成功后由远端接口拉取。模型变化时点击测试连接或重新打开设置刷新。 |
| 提供商开关 | 必须处于“已开启”,否则聊天和 AI 处理模型不会使用这个提供商。 |
开始第一个 AI 对话
Polo龙虾的任务会在你指定的项目目录中工作。提交前先确认目录、Agent 和模型。
点击输入框下方的文件夹名称,选择本次任务可以读写的项目目录。
普通任务使用“主 Agent”;有专门角色时再切换其他 Agent。
点击右下角模型名称,按速度、能力和成本选择当前模型。
- 在中间输入框直接描述结果,例如“读取这个目录的 Excel,汇总成一份周报”。
- 需要附件时点击左下角的 +;需要套件能力时点击旁边的能力入口。
- 点击右侧发送按钮。执行过程中如需文件或系统权限,按提示确认。
- 要开始另一个独立任务,点击左侧“新建任务”;历史任务可从“搜索任务”找到。
图片任务:描述、参考图和异步生成
点击左侧“图片任务”。每次提交都会成为独立任务组,可以同时处理多个任务。
- 写图片描述。可直接写“一套”“多张”或明确数量,AI 处理模型会把需求拆成连续任务。
- 添加参考图片。可点击或拖入,最多 9 张,每张不超过 20 MB;支持 PNG、JPG、WEBP、GIF、BMP、AVIF。
- 选择两类模型。AI 处理模型负责理解和拆分,推荐
gpt-5.5;图片模型负责生成,默认gpt-image-2。 - 设置输出。按用途选择尺寸、质量和 PNG/JPEG/WEBP 格式,然后点击“生成图片”。
- 在右侧查看。任务会立即出现在生成记录中,不会阻塞左侧表单;可继续提交新任务。
| 任务目录 | LobsterAI-Data/image-tasks/groups/任务ID/,参考图在 references,生成图在 outputs。 |
|---|---|
| 多图查看 | 任务组封面显示第一张图片,可用左右切换按钮查看组内其他结果。 |
| 停止任务 | 停止尚未完成的生成项,已成功生成并保存的图片不受影响。 |
| 删除任务 | 删除任务记录和对应任务目录。重要图片请先点击“打开目录”另行保存。 |
| 分页 | 每页可选 5、10 或 20 条,默认 5 条。 |
专家套件、技能和 MCP
三者都用于扩展 Agent,但层级不同:套件是场景能力包,技能是单项工作方法,MCP 是外部工具连接。
| 专家套件 | 按办公文档、内容创作、在线研究、电脑操作等场景组合多个技能。进入“市场”点击安装,安装后在输入框能力入口使用。 |
|---|---|
| 技能 | 提供文档、表格、演示文稿、网页搜索等具体能力。可在市场安装,也可从 ZIP、文件夹、GitHub 或 ClawHub 导入。 |
| MCP | 把 Agent 接到浏览器、数据、企业服务或开发工具。优先从市场安装;自定义配置需要确认来源可信。 |
让任务按计划自动执行
定时任务适合早报、周报、项目巡检和固定提醒。可以从模板开始,也可以从空白创建。
- 点击左侧“定时任务”,选择模板或右上角“新建”。
- 填写任务标题、执行时间、任务指令、工作目录和模型。
- 启用任务并保存。可在“历史”标签查看每次运行结果。
- 需要提前验证时,打开任务详情并点击“立即运行”。
查看余额和 Token 使用记录
配置 GPT Cloud 令牌后,左下角会显示当前余额。更换令牌并保存后,余额也会自动切换。
- 在左下角“当前令牌余额”卡片查看剩余额度。
- 点击卡片底部“使用记录”进入明细页。
- 明细包含时间、模型、费用、输入、输出、耗时和状态;右上角可刷新。
- 使用右侧“每页”选项和底部分页按钮浏览历史记录。
需要在浏览器管理令牌、充值或查询账户时,打开 令牌余额中心。
迁移、升级和备份
USB 便携版的关键是应用目录旁的 LobsterAI-Data。保留它,就能保留主要配置和本地数据。
| 整包迁移 | 完全退出 Polo龙虾后,复制整个便携目录到新电脑或 U 盘,再运行 START-PORTABLE.cmd。 |
|---|---|
| 升级版本 | 先备份旧目录。把旧版 LobsterAI-Data 放到新版程序同级目录,再启动新版完成迁移。 |
| 日常备份 | 退出应用后复制 LobsterAI-Data;也可使用设置中的数据备份功能生成迁移包。 |
| 项目文件 | 用户选择的外部项目目录不一定在 LobsterAI-Data 内,需要单独备份。 |
常见问题排查
先定位是程序启动、网络令牌、模型服务还是扩展安装问题,再做对应处理。
双击没有反应、白屏或提示运行环境缺失
- 确认压缩包已完整解压,不是在压缩软件预览中运行。
- 使用
START-PORTABLE.cmd启动,并等待首次初始化。 - 确认
resources、locales、portable.flag和LobsterAI-Data与 EXE 同级。 - 把整个目录加入安全软件允许列表;若文件曾被隔离,重新解压完整包。
模型列表加载失败或发送任务失败
回到设置 → 自定义模型 → GPT Cloud,检查令牌、Base URL 和启用开关,然后点“测试连接”。代理环境下可在设置 → 通用开启“使用系统代理”,保存后重试。
图片模型能看到,但生成一直失败
先查看余额是否充足,再检查参考图格式和大小。点击图片任务右上角刷新模型;失败任务可直接重试。若远端返回具体错误,以右侧任务卡片中的错误信息为准。
专家套件或技能安装失败
确认网络可访问扩展源、便携目录有写入权限,并检查安全软件是否拦截下载或解压。不要把程序放在只读目录;重启应用后再安装。仍失败时保留错误截图和 LobsterAI-Data/logs。
余额没有跟着新令牌变化
在 GPT Cloud 设置中粘贴新令牌并点击“保存”,然后回到首页等待自动刷新;也可以进入“使用记录”点击右上角刷新。只修改输入框但没有保存不会切换。
删除图片任务后,为什么本地文件也没了
当前版本删除任务会同时清理对应任务组目录。需要长期保留的成品,请先点击“打开目录”,复制到项目目录或其他备份位置。