首次使用提示: 如果你还没有部署自己的 OpenClaw,建议先从 Tencent Cloud OpenClaw 开始,一键即可在几秒内完成部署。
👉 最全教程指南
本指南主要回答大家在使用过程中常问的高频问题,主要分为以下几类:
前置选购
部署安装
模型配置
通道配置
Skill 技能
对话调优
| 🎮 通用常见问题 | |
| 我不会安装,还会有线下装机活动或者分享交流会吗? | 一系列线下活动正在筹备中,欢迎关注【腾讯云服务器】公众号了解最新的产品动态。同时我们每周会有线上直播,手把手教大家如何上手安装,可以加入 OpenClaw 云端交流群;也可以加入 Lighthouse官方交流群。 |
| 🎨 前置选购 | |
| 我想安装小龙虾,需要有哪些费用产生? | 主要需要购买云服务器和大模型的资源。 轻量应用服务器Lighthouse 购买:👉点击这里 大模型资源可根据实际需求购买各厂商的模型,费用不等。 |
| 云服务器的配置那么多,我选择哪个? | 套餐类型:入门型(高性价比首选)、锐驰型、通用型。 套餐配置:推荐2核4G内存或更高配置的套餐,最低配置支持2核2G内存(适合简单体验)。 |
| 云服务器的海外和国内地域,我应该选哪个? | 请根据使用场景和模型来选择服务器地域。 1、接入聊天应用:接入QQ、企业微信通常选择国内地域,接入Discord、WhatsApp则通常选择海外地域。 2、考虑后续需要调用国内模型还是海外模型,如调用国内模型一般推荐国内地域的服务器。 3、后续希望让 OpenClaw 打通哪些网站的信息获取,如 Github、Notion 等国际化网站,推荐海外地域。 |
| 我的腾讯云账号一直注册不成功,可以找谁? | 购买前需要先完成腾讯云账号的实名认证,可查看详细文档,或在官网提工单找售后客服支持。 |
| 购买后我找不到 Lighthouse 的入口了,去哪里配置 OpenClaw? | 可以到 Lighthouse 控制台。 |
| 🤖 部署安装 | |
| 本地部署和云端部署有什么区别? | 本地部署和云端部署各有特性,对于想要快速上手体验的用户来说,我们更推荐云端部署,主要有以下特性: 1、秒级部署:提供稳定公网访问,服务持续运行,随时随地可用 2、随时在线:服务24小时稳定运行,支持多终端访问 3、安全隔离:提供独立云端环境,与本地电脑物理隔离,保障本地隐私安全,专业安全防护 |
| 我的电脑不是 Mac 系统,能部署安装吗? | 腾讯云 Lighthouse 部署 OpenClaw 是云端部署方案,对电脑性能、型号没有要求,都可以安装。 |
| 部署安装大概需要什么样的流程? | Lighthouse 提供 OpenClaw 应用模板和可视化配置面板,不需要操作任何命令行即可快速部署安装,步骤大概如下: 1、购买一台云服务器,选择 OpenClaw 应用模板 2、配置大模型 3、配置通道:选择 WhatsApp、Telegram、Discord、Slack、QQ、飞书、钉钉、企业微信。 |
| 教程太多了,我先看哪个? | 建议先看【一键妙级部署】教程,基本以下的教程足够使用: 📚 详细指南: 一键秒级部署: hhttps://www.tencentcloud.com/techpedia/139184 最全实践合辑:https://www.tencentcloud.com/techpedia/139189 |
| 为什么使用的时候我的面板能力跟宣传的不一样? | 请先确保 OpenClaw 使用的版本为最新,如您不是使用最新版本,在服务器的「应用管理」可点击“一键更新”。一键更新会导致“除QQ以外”其他通道(Channels)配置丢失,更新完成后需重新配置。模型(Models)、技能(Skills)和记忆不会丢失。 |
| ⚡️ 模型配置 | |
| 还推荐哪些性价比高的模型推荐? | 优先推家各家大模型厂商推出的 CodingPlan,性价比最高,不按 token 消耗收费,按调用次数收费。轻友团用户也给大家写了一份攻略:2026 大模型 API 免费额度汇总 |
| 还有哪些省 token 小妙招? | 在聊天软件里,还可以通过斜杠命令,快速"瘦身"会话。常用斜杠命令:/compact手动压缩,将旧内容总结成简短摘要/reset保留记忆,重置当前话题/new开启一段全新的对话更多小妙招可查看:降低 Token 消耗,立竿见影 |
| 如何获取大模型的 API Key? | 在 Lighthouse 模型配置面板中,选择腾讯云 CodingPlan、腾讯混元、腾讯云 DeepSeek,支持一键添加并应用;若选择其他大模型,需要到对应模型的官网获取,在配置面板中选择模型厂商的时候,也会有相关获取 API Key 的指引。 |
| 🔌 通道配置 | |
| 目前支持哪些聊天应用? | 腾讯云 Lighthouse 首发支持接入中国四大主流 IM 工具,QQ、飞书、钉钉、企业微信与海外四大主流 IM 工具,WhatsAPP、Telegram、 Discord、 Slack。 |
| 如何接入聊天应用? |
WhatsApp: https://www.tencentcloud.com/techpedia/139674 Telegram: https://www.tencentcloud.com/techpedia/139675 Discord: https://www.tencentcloud.com/techpedia/139676 Slack: https://www.tencentcloud.com/techpedia/139673 iMessage: https://www.tencentcloud.com/techpedia/142823 |
| 我看 QQ 宣传可以安装5个机器人,我怎么可以安装多个 QQ 机器人? | 目前一台云服务器支持一个机器人,多个机器人需要多台云服务器。 |
| QQ机器人回复:“该机器人去火星了,稍后再试吧” | 可能原因: 1、没有为OpenClaw添加QQ机器人的App ID和App Secret。 2、添加了错误的QQ机器人App ID和App Secret。 请参考教程对应步骤进行操作。如您使用的是最新配置面板,基本可避免此问题。 |
| 完成教程所有配置步骤后,与QQ机器人聊天,机器人不回复 | 可能原因: 模型配置有问题,导致QQ机器人不返回消息。 可以在轻量应用服务器Lighthouse产品控制台的应用管理页面中,配置模型API Key。详情可参考云上OpenClaw(原Clawdbot)一键秒级部署指南-配置模型API Key。 验证模型配置是否生效: 如果您担心模型配置未生效,可以登录轻量应用服务器并通过OpenClaw TUI工具进行验证。具体步骤可以参考教程“云上OpenClaw(原Clawdbot)一键秒级部署指南-使用TUI与OpenClaw进行交互”。 |
| 为什么我不能接入公司的企业微信? | 接入企业微信需要该企业微信公司主体的管理员,才有相关操作权限。 |
| 🧩 Skill 技能 | |
| Skill 技能是什么东西? | 如果把大模型比作"大脑",Skills 就是它的手脚。OpenClaw 最终可以做什么任务,很大程度取决于安装了哪些 Skill 技能。 |
| Lighthouse 默认有给 OpenClaw 安装了哪些技能? | tavily-search网络搜索summarize对 URL 或文件进行汇总agent-browser模拟浏览器行为find-skills发现并安装 Skillgithub与 GitHub 进行交互obsidian同步 Obsidiannotion管理页面、数据库和区块weather获取天气和天气预报tencentcloud-lighthouse-skill管理腾讯云 Lighthousetencent-docs腾讯文档操作能力若不使用相关技能,则不会消耗大模型 token。 |
| 如何安装 Skill? | 方式一:面板安装 在管理面板中浏览、搜索并一键安装 方式二:直接对话安装 在聊天中告诉 OpenClaw 你需要什么技能,它会自动搜索并安装 方式三:手动上传文件并安装 下载 Skill 对应的压缩文件,通过文件管理上传后,告诉 OpenClaw 安装这个技能 |
| 为什么我在配置面板中输入 Skill 名称,会报错? | 请先确认 Skill 名称输入正确。在 skillhub 上想使用某个 skill,点击大标题后,在大标题下方的一串英文小字,即为 skill 名称。如“小红书 - RedNote”的 skill 名称为 xhs。 |
| 💬 对话调优 | |
| 401 Unauthorized 鉴权失败 |
原因 1:大模型配置 API Key 本身有问题 • API Key 格式有误 👉 一般 key 格式为 sk-xxxx…xxxx,请检查复制错误(换行、多空格、截断等) • API Key 已过期/已失效/已删除 👉 请重新生成或确认 key 状态 • 未区分国内版/国际版 👉 同一厂商可能区分站点,需确认是否正确选择 原因 2:API Key 不适用于当前模型 • 不同平台/模型的 API Key 混用 👉 例如申请了 kimi 的 key,配置时选择了 minimax • 不同平台相同模型的 API Key 混用 👉 例如腾讯云 DeepSeek 的 key,无法用于深度求索 DeepSeek 的选项 • 不同订阅类型的 key 混用 👉 coding plan 一般是单独选项,不能用于非 coding plan 的选项 原因 3:大模型账号状态异常 • 账号被限制、冻结、停用 • 账号欠费或 API Key 限额耗尽 • 账号未完成认证或授权 |
| 403 Forbidden 权限不足:当前 API Key 无权限调用模型服务 |
• 检查该模型是否支持当前服务器地域。例如海外模型不能用于国内地域的服务器 • 检查账号内资源包是否耗尽 |
| 404 Not Found 调用姿势不对:API 路径或资源 ID 不存在 |
• 检查模型的 base_url 是否正确 • 检查模型 ID 是否正确 |
| 429/500 Insufficient Balance 多为大模型账号余额不足 |
• 检查 API Key 是否正确 • 检查账号是否欠费 |
| Rate_Limit 频率限制 多为模型调用频率限制 |
• 提升大模型账号限频 • 更换其他模型 |
| OpenClaw 不回复如何解? | TUI、日志齐上阵 — 六步排障流程 1、登录服务器:登录部署 OpenClaw 的服务器命令行 2、进入TUI:执行 openclaw tui 命令,进入交互式终端界面 3、多开会话看日志:新会话执行 openclaw logs --follow,查看实时日志流 4、发送消息观察:在聊天框与 TUI 分别发送消息,观察日志输出是否正常 5、定位异常信息:搜索 Failed、Error、Not Found 等关键字,锁定异常行 6、分析原因:结合异常信息分析可能原因,善用其他 AI 辅助判断 |