Quick start
先记住这 5 个入口
点击卡片可以复制地址。打不开时，先确认龙虾启动器和网关没有关闭。
正确顺序：先跑通最短链路
新手不要一上来就扫码微信或配置 QQ。先把 API 和网页聊天跑通，这样后面通道不回消息时，才知道问题在 QQ/微信，而不是 key 或模型。
API 配置页照这样填
打开 http://127.0.0.1:18788/，页面标题是“API 配置”。从上往下填，保存后即时生效。
https://cloud-gpt.cn/v1，一定要带 /v1。sk- 令牌，右侧“显示”可以检查有没有多复制空格。gpt-5.5；如果通道限制，再切 gpt-5.4。OpenAI Completions，Claude 专用上游才选 Anthropic。
Agent 配置里的默认模型
同一页下面还有“Agent 配置”。这里决定龙虾默认用哪个模型工作，要和上面的 API 模型保持一致。
gpt-5.5。如果页面要求“提供商ID/模型ID”格式，就用配置中心自动生成的值，不要手动乱改前缀。
- 默认模型和 API 配置里的模型保持一致。
- 工作目录一般保持默认，不懂不要改。
- 修改后点击“保存 Agent 配置”。
先用网页聊天验证
网页聊天是最短链路，能最快判断 API、key、模型是否正常。网页能回复，再去配置 QQ、微信和技能。
- 打开控制台：
http://127.0.0.1:18788/console.html。 - 点击“加载聊天”或“新窗口打开”。
- 也可以直接打开：
http://127.0.0.1:18789/#token=uclaw。 - 第一次发送：
你好，回复一句话测试。
网页能聊后，再接 QQ / 微信
打开 http://127.0.0.1:18788/advanced.html，这里就是通道中心。通道配置不影响 API 本身，所以一定放在网页聊天成功之后。
QQ Bot
- 提示插件未安装时，先点“一键安装 QQ Bot 插件”。
- 启用 QQ 通道。
- 去 QQ 开放平台创建机器人，复制 App ID 和 Client Secret。
- 保存 QQ 配置，然后重启网关。
微信
- 提示插件未安装时，先点“一键安装微信插件”。
- 启用微信通道。
- 私聊策略新手保持
pairing（推荐）。 - 保存微信配置，再点网页扫码登录。
技能中心怎么用
打开 http://127.0.0.1:18788/skills.html。常用技能适合新手，在线搜索适合需要扩展功能时再用。
data/workspace/skills，清理数据后可能要重装。部分技能需要本机执行权限。给客户使用时，建议控制台里的本机执行权限先保持默认策略。
常见报错快速判断
API Key 不对、复制多了空格、令牌被禁用。重新粘贴 key 后保存。
key 有效但额度不够，先去余额查询或充值，再刷新配置中心。
模型名称填错，先用 gpt-5.5 或 gpt-5.4 测试。
API 没问题，去通道中心刷新状态、重启网关、检查扫码或机器人参数。
FAQ
新手最常问的问题
为什么一定要先测网页聊天？
网页聊天只经过 API 和网关，链路最短。网页能回复，说明 key、模型、接口地址已经通了；网页不通时不要先排查 QQ/微信。
接口地址到底填 cloud-gpt.cn 还是 /v1？
配置中心的 Base URL 建议填 https://cloud-gpt.cn/v1。只填域名容易导致请求路径不对。
微信和 QQ 哪个更适合新手？
微信扫码更直观；QQ 需要 QQ 开放平台机器人参数，更适合已经会配置机器人的用户。
技能安装后在哪里？
一般在 data/workspace/skills。恢复出厂、清理数据或换新包后，技能可能需要重新安装。
售后怎么联系？
微信：w1833147162；闲鱼店铺：polo。