OpenClaw logo 思婷便携龙虾
帮助中心 / 普通用户图文教程

这篇帮你做什么

不用命令行，也能把思婷便携龙虾跑起来。

本教程带你完成第一次使用思婷OpenClaw便携包：打开思婷龙虾控制面板、配置大模型、启动 Gateway、打开 Web UI， 再按需要接入微信、飞书、钉钉、企业微信等频道。

免安装 免部署 原生 OpenClaw 可放入 U盘
标注版截图：思婷龙虾控制面板首页，标注启动 Gateway 的位置
标注版截图：思婷龙虾控制面板首页。重点看“启动 Gateway”的位置。

购买前先确认

如果你还没购买，建议先确认这些边界：思婷OpenClaw便携包内含原生 OpenClaw； 它既支持下载解压后的电子授权，也支持放入 U盘或移动硬盘使用；当前教程按 Windows 优先编写。

更适合什么场景学习、演示、售前 PoC、模型评测、客户现场轻量验证和个人/小团队试用。
仍需要你准备什么大模型 API Key；接入飞书、钉钉、企业微信等频道时，还需要对应开放平台凭证。
授权怎么理解在线套餐写入官网账号；U盘序列号激活前必须登录账号，绑定后不可改绑。
安全注意什么不要外发完整 API Key、完整日志或支付信息；求助时优先发脱敏截图和日志导出文件。
购买前想看完整规则，请先读 购买前 FAQ；购买后要跑起来，继续看下面的第一次使用流程。

开始前准备

一份便携包文件下载后解压到本地磁盘、U盘或移动硬盘。不要只在压缩包里直接运行。
一台 Windows 电脑首次运行建议使用网络正常、权限完整的电脑，便于授权校验和模型测试。
一个大模型 API Key例如 DeepSeek、通义千问、Kimi、豆包、智谱、OpenAI、Claude 或 Gemini。
一个官网账号注册和登录使用邮箱 + 密码。激活 U盘序列号前必须先登录官网账号。
频道平台凭证如果要接入飞书、钉钉或企业微信，需要提前在对应开放平台创建应用。
保留日志遇到问题先导出日志，发给技术支持时不要提供完整 API Key。

第一次使用流程

建议先跑通一个大模型，再启动 Gateway 和 Web UI，最后接入聊天频道。

解压打开思婷龙虾控制面板配置模型测试连接启动 Gateway打开 Web UI
  1. 1

    把思婷OpenClaw便携包解压到一个完整目录。放入 U盘或移动硬盘也可以。

  2. 2

    打开思婷龙虾控制面板，等待自检完成。自检会检查 runtime、OpenClaw Core、数据目录和端口。

  3. 3

    进入“核心配置”，打开“大模型配置”。先选择一个你已经有 API Key 的模型平台。

  4. 4

    填写 API Key、模型版本和接口地址，点击“测试连接”。

  5. 5

    测试成功后设置为默认大模型，保存配置。

  6. 6

    回到思婷龙虾控制面板首页，点击“启动 Gateway”。状态变为运行中后，再点击“启动 Web UI”。

成功标志：大模型测试连接成功；Gateway 状态显示运行中；Web UI 能正常打开；日志里没有持续报错。

API Key 是什么？

API Key 可以理解为“大模型平台给你的调用钥匙”。思婷OpenClaw便携包负责启动和配置 OpenClaw， 但不自带大模型算力。你需要在模型平台官网开通服务，复制 API Key，再填到思婷龙虾控制面板里。

API Key模型平台发给你的调用凭证，通常是一长串字符。
Base URL模型接口地址。官方平台通常有默认值，第三方兼容平台需要填对方提供的地址。
模型版本决定使用哪个模型，例如 deepseek-chat、qwen-plus、gpt-4o-mini。
默认大模型Gateway 启动后默认调用的模型。第一次使用建议只设一个。
不要把完整 API Key 发给别人。截图时建议遮住 Key 中间部分。

大模型配置教程

入口：思婷龙虾控制面板首页 → 核心配置 → 大模型配置。

标注版截图：大模型配置页，标注测试连接位置
标注版截图：大模型配置页。重点看模型平台、API Key 和“测试连接”的位置。

通用步骤

  1. 选择模型平台。
  2. 填写 API Key。
  3. 确认 Base URL，官方平台一般保持默认。
  4. 选择模型版本。
  5. 点击“测试连接”。
  6. 成功后设置为默认大模型并保存。
国内模型推荐先试这些

DeepSeek：适合对话和推理，常见地址 https://api.deepseek.com/v1。

通义千问：适合阿里云百炼用户，常见地址 https://dashscope.aliyuncs.com/compatible-mode/v1。

Kimi：适合长文本，常见地址 https://api.moonshot.cn/v1。

豆包：适合火山方舟用户，常见地址 https://ark.cn-beijing.volces.com/api/v3。

智谱 GLM：适合国内通用场景，常见地址 https://open.bigmodel.cn/api/paas/v4。

海外模型和本地模型

OpenAI：常见地址 https://api.openai.com/v1，部分网络环境可能无法直接访问。

Claude：常见地址 https://api.anthropic.com，对账号和网络环境要求较高。

Gemini：常见地址 https://generativelanguage.googleapis.com，通常需要能访问 Google 服务。

Ollama：常见地址 http://localhost:11434，需要当前电脑单独安装并运行 Ollama。

成功标志：测试连接成功；首页显示已配置大模型；启动 Gateway 时不再提示“请先配置大模型”。

Gateway 和 Web UI 是什么？

Gateway 是 OpenClaw 的本地服务入口。模型调用、频道消息和 Web UI 都依赖它正常运行。 Web UI 是浏览器里的 OpenClaw 操作界面。

  1. 先保存大模型配置。
  2. 回到思婷龙虾控制面板首页。
  3. 点击“启动 Gateway”。
  4. 状态变为运行中后，点击“启动 Web UI”。
标注版截图：思婷龙虾控制面板首页，标注启动 Web UI 的位置
标注版截图：Gateway 运行后，在控制面板首页点击“启动 Web UI”。

频道接入教程

入口：思婷龙虾控制面板首页 → 接入频道。接入频道后，OpenClaw 可以在聊天平台里收消息和回复消息。

思婷龙虾控制面板的频道配置页
真实截图：频道配置页。重点看微信、飞书、钉钉、企业微信等频道入口，以及凭证输入区、测试/保存按钮。

通用步骤

  1. 选择频道平台。
  2. 按平台要求填写凭证或执行登录动作。
  3. 点击测试、安装插件或扫码登录。
  4. 保存配置。
  5. 重启 Gateway。
  6. 在聊天平台发一条测试消息。
微信

通常通过 OpenClaw 微信插件安装和扫码登录，不需要像企业应用那样手动填写 App ID / App Secret。

个人微信有平台风控风险。二维码不出现、登录失败或掉线时，优先查看微信插件日志。

飞书

通常需要在飞书开放平台创建应用，准备 App ID 和 App Secret。应用需要安装到企业或完成发布后才能正常收发消息。

钉钉

通常需要在钉钉开放平台创建企业内部应用机器人，准备 Client ID/AppKey 和 Client Secret/AppSecret。Stream 模式更适合便携包。

企业微信

优先使用 Bot WebSocket 方向时，一般准备 Bot ID 和 Secret。高级 Webhook/Agent 模式可能需要 CorpID、AgentID、应用 Secret、Token 和 EncodingAESKey。

Telegram / Discord / Slack

Telegram 需要 Bot Token；Discord 需要 Bot Token 并开启消息内容权限；Slack 通常需要 Bot Token 和 App Token，并开启 Socket Mode。

成功标志：频道日志显示已加载；聊天平台发送测试消息后，OpenClaw 能正常回复。

Skill 配置是什么？

Skill 可以理解为 OpenClaw 的能力扩展。某些频道插件、自动化工具或后续模板能力，会通过 Skill 或插件体系接入。 普通用户只需要关注是否已安装、是否启用、是否需要更新。

  • 如果页面提示插件未安装，先点击安装。
  • 如果页面提示有新版本，优先更新后再测试。
  • 安装或更新后，通常需要重启 Gateway。

角色/性格设定

入口：核心配置 → 角色/性格设定。这里控制 AI 助手“是谁、怎么说话、遵守什么规则”。

IDENTITY.md身份设定，例如助手名字、定位、服务对象和边界。
SOUL.md性格设定，例如语气、原则、固定回复方式和禁忌。
清除记忆清理会话记忆，不等于删除模型配置和频道配置。
恢复出厂设置会清理配置、角色设定、会话记忆和缓存。操作前请确认。
修改角色规则后，如果频道回复没有变化，建议重启 Gateway。

日志查看和导出

日志是排查问题的第一入口。启动 Gateway、加载频道、调用模型、授权校验失败，通常都会在日志里留下提示。

标注版截图：运行日志页，标注导出日志按钮
标注版截图：运行日志页。遇到问题时优先点击“导出日志”，再发给客服或技术支持。
  • 导出日志：把当前运行日志保存为文件，方便发给技术支持。
  • 清空日志：只清空显示区域，不代表问题已经解决。
  • 收起/展开：Gateway 运行时可以减少日志区域占屏。

授权中心

入口：思婷龙虾控制面板首页 → 授权中心。首次使用可体验 3 天。继续使用需要购买套餐，或使用有效 U盘序列号激活。

在线套餐

月卡 ¥29 / 30 天；季卡 ¥59 / 90 天；年卡 ¥99 / 365 天；终身 ¥299 / 永久授权。

高等级套餐不可降级。终身套餐不可复购。

查看套餐

U盘序列号激活

序列号按终身授权处理。激活前必须先登录官网账号。

  1. 登录官网账号。
  2. 进入授权中心。
  3. 输入 U盘序列号。
  4. 确认绑定账号无误后激活。
标注版截图：授权中心页，标注授权状态和操作入口
标注版截图：授权中心。重点看账号状态、当前套餐、联网校验和激活入口。
重要规则：一个序列号只能绑定一个账号；一个账号只能绑定一个序列号；序列号绑定后不可改绑； 已购买终身套餐不能再用序列号激活；已用序列号激活不能再购买套餐。

故障排查

Gateway 启动失败

先看日志。常见原因包括端口占用、模型未配置、文件缺失、权限不足或频道配置异常。

模型测试失败

检查 API Key 是否完整、账号是否有余额、模型服务是否开通、Base URL 是否正确、网络是否能访问平台。

频道不回复

确认频道配置已保存、Gateway 已重启、默认大模型可用。再查看频道日志和模型调用日志。

授权激活失败

确认已登录账号、序列号未被绑定、当前账号没有终身套餐或其他序列号绑定，并检查网络连接。

下一步

第一次跑通后，可以继续做三件事：接入你的主要聊天频道；调整角色/性格设定；保存一次正常运行日志，方便后续排查对比。

思婷龙虾控制面板的帮助中心页
真实截图：帮助中心。启动器内置帮助入口会继续指向官网稳定页面 /help。
返回文档总览 查看常见问题