文章

openclaw小龙虾部署记录

openclaw小龙虾部署记录

发表于 更新于
作者 捞鱼
9 分钟阅读
openclaw小龙虾部署记录

openclaw小龙虾使用指南

🚀 一键部署完成

今天我部署了一只小龙虾，总计耗时约8小时。

部署方式：通过 antigravity 自动部署，全程自动化，无需手动配置。

✨ 核心功能

部署完成后，小龙虾集成了以下实用功能：

  • 图形化操作页面 - 友好的 Web 界面，操作直观简单
  • API 保存与快速切换 - 支持多个 API 密钥，一键切换使用
  • API 剩余额度查询 - 实时查看各 API 的剩余额度，避免用尽
  • 一键打开小龙虾 - 单击即可启动服务，无需复杂命令

📋 使用步骤

  1. 访问控制台 - 打开部署后的图形化界面
  2. 配置 API - 在设置页面添加或切换您的 API 密钥
  3. 查看额度 - 实时监控各 API 剩余额度
  4. 开始使用 - 点击”一键打开小龙虾”即可开始使用

🔧 技术细节

  • 部署方式：自动部署（antigravity）
  • 界面：Web 图形化界面
  • 状态：已集成完整功能模块

📝 复刻指南

我已经保存了第一版的复刻文档，把复刻文档丢给代理 AI，应该就可以完美复刻了。

需要的可以联系我获取完整部署文档和技术支持。

一键部署 OpenClaw 使用指南

🚀 快速开始

1. 双击启动

双击 🚀 启动小龙虾控制中心.bat，浏览器会自动打开控制台。

2. 配置 API Key

在控制台中选择你常用的 AI 平台，填写 API Key：

  • ✅ Google Gemini（推荐·大额免费）
  • ✅ DeepSeek 深度求索
  • ✅ Moonshot / Kimi
  • ✅ Qwen 通义千问
  • ✅ OpenAI
  • ✅ Anthropic (Claude)
  • ✅ Groq
  • ✅ Perplexity
  • ✅ 讯飞星火

3. 一键启动

点击「一键启动」按钮，OpenClaw 网关自动运行！

4. 开始使用

  • 打开 QQ，发送消息到你的机器人
  • OpenClaw 会自动回复
  • 支持语音转文字、图片识别、文件处理等功能

📖 详细使用指南

第一次使用流程

  1. 下载安装包 - 从 GitHub 下载最新版一键部署包
  2. 解压文件 - 将压缩包解压到任意目录（建议英文路径）
  3. 双击启动 - 运行 🚀 启动小龙虾控制中心.bat
  4. 配置密钥 - 在控制台中添加你的 AI 平台 API Key
  5. 启动网关 - 点击「一键启动」按钮
  6. 开始对话 - 在 QQ 中向机器人发送消息

控制台功能说明

  • API 管理 - 添加、编辑、删除 API Key
  • 模型选择 - 为不同平台选择合适的模型
  • 网关控制 - 启动、停止、重启网关服务
  • 日志查看 - 实时查看网关运行日志
  • 额度查询 - 查看各 API 的剩余额度

❓ 常见问题

Q1：双击 .bat 文件后没有反应？

A：可能是以下原因：

  1. PowerShell 被禁用：右键 .bat 文件 →「以管理员身份运行」
  2. Node.js 缺失：检查 node_bin\node.exe 是否存在
  3. 网络问题：查看终端是否有「连接超时」提示

解决方法：

  • 右键 .bat 文件 →「打开方式」→「记事本」→ 复制内容
  • 打开 PowerShell，粘贴并运行
  • 查看终端输出的错误信息

Q2：浏览器没有自动打开？

A：手动访问 http://127.0.0.1:18789/（或终端显示的端口号）

Q3：API Key 配置失败？

A：检查以下几点：

  1. API Key 是否正确：复制粘贴，不要手动输入
  2. 网络是否正常：尝试访问对应平台的官网
  3. 防火墙是否拦截：暂时关闭防火墙重试

支持的平台：

  • Google Gemini：https://aistudio.google.com/
  • DeepSeek：https://platform.deepseek.com/
  • Moonshot：https://platform.moonshot.cn/
  • Qwen：https://dashscope.console.aliyun.com/
  • OpenAI：https://platform.openai.com/
  • Anthropic：https://console.anthropic.com/
  • Groq：https://console.groq.com/
  • Perplexity：https://www.perplexity.ai/
  • 讯飞星火：https://console.xfyun.cn/

Q4：配置成功后网关启动失败？

A：可能是端口冲突：

  1. 检查 18789 端口是否被占用：
    1

    netstat -ano | findstr :18789
  2. 终止占用进程：
    1

    taskkill /F /PID <进程ID>
  3. 重启 .bat 文件

Q5：网关启动后无法回复消息？

A：检查以下几点：

  1. QQ 机器人是否在线：查看 QQ 机器人状态
  2. 消息是否被过滤：检查是否发送了敏感词
  3. 权限是否足够：确保机器人有「群聊/私聊」权限

Q6：如何查看网关日志？

A：终端会实时输出日志，包括：

  • 网关启动状态
  • 消息接收记录
  • 错误信息

Q7：如何停止网关？

A：三种方法：

  1. 关闭浏览器窗口（推荐）
  2. 在 PowerShell 中按 Ctrl+C
  3. 任务管理器中终止 node.exe 进程

Q8：支持哪些功能？

A：OpenClaw 支持：

  • ✅ 自动回复消息
  • ✅ 语音转文字（需要配置 STT）
  • ✅ 图片识别（需要配置 OCR）
  • ✅ 文件处理（需要配置相关技能）
  • ✅ 定时任务（需要配置 Cron）

Q9：如何扩展功能？

A：OpenClaw 支持「技能」扩展：

  1. 访问 ClawHub 下载技能
  2. 在控制台中「安装技能」
  3. 重启网关生效

Q10：API Key 安全吗？

A：绝对安全！

  • API Key 仅存储在本地
  • 不会上传到任何服务器
  • 不会分享给第三方

Q11：如何备份配置？

A：复制以下文件：

1
2
3
4
5
6

C:\Users\<用户名>\.openclaw\
├── agents\
│   └── main\
│       └── agent\
│           └── auth-profiles.json  # API Key
└── openclaw.json                   # 配置

Q12：如何修改默认模型？

A：在控制台中「应用配置」时选择模型，或手动编辑：

1

C:\Users\<用户名>\.openclaw\openclaw.json

Q13：如何更新 OpenClaw？

A：重新运行 🚀 启动小龙虾控制中心.bat，会自动检测更新。

Q14：如何卸载？

A：删除 一键部署openclaw 文件夹即可（所有数据都在本地）。

Q15：支持哪些平台的机器人？

A：目前支持：

  • ✅ QQ 机器人（私聊/群聊）
  • ✅ 待扩展其他平台

Q16：如何配置语音转文字？

A：需要额外配置 Whisper 模型：

  1. 下载 Whisper 模型文件
  2. 在控制台中配置 STT 相关参数
  3. 重启网关生效

Q17：如何配置图片识别？

A：需要额外配置 OCR 或图像模型：

  1. 在控制台中启用图片识别功能
  2. 配置相应的 API 或本地模型
  3. 重启网关生效

Q18：网关启动后端口冲突怎么办？

A：修改默认端口：

  1. 打开 hub_server.js
  2. 找到 const port = 18789;
  3. 修改为其他端口号（如 18790）
  4. 重启 .bat 文件

Q19：如何设置开机自启动？

A：将 .bat 文件快捷方式放入：

1

C:\Users\<用户名>\AppData\Roaming\Microsoft\Windows\Start Menu\Programs\Startup

Q20：支持离线使用吗？

A：部分功能支持离线：

  • ✅ 本地模型（如 Whisper、本地 LLM）
  • ❌ 云端 API 需要联网

🆘 联系我

如果问题未解决，请提供：

  1. 操作系统版本（Win10/Win11）
  2. Node.js 版本（node --version）
  3. 终端输出的完整错误信息

制作：捞鱼制作 · LAOYU STUDIO

工具
技术积累
本文由作者按照 CC BY 4.0 进行授权