对接腾讯元宝免费版API时，不少开发者在Base URL和API Key的填写环节容易出错。填错可能导致连接被拒，甚至返回401错误，且日志信息不够明确——其实只要掌握两个关键要点，就能一次性成功配置。

确认元宝免费版API的正确Base URL

腾讯元宝已明确提供OpenAI兼容接口，免费版Base URL固定为：https://api.hunyuan.cloud.tencent.com/v1。请注意末尾的/v1不可省略，也不能替换为dashscope、deepseek等其他厂商的路径。粘贴时，容易误带入多余空格、中文标点，或浏览器自动补全导致“https://”前缀重复（例如变成“https://https://…”），这会使OpenClaw初始化时直接报错退出。解决办法很简单：手动清除多余字符后再按回车确认。

获取并填写合法的API Key

获取API Key有两种常用途径：

方法一：登录腾讯云控制台，进入「混元大模型」服务页面，在左侧导航栏找到「API密钥管理」，点击「创建API密钥」，勾选「混元模型调用权限」，创建完成后立即复制密钥字符串。

方法二：如果之前已创建过密钥，可在同一页面找到状态为「启用」的密钥行，点击右侧「查看」，完整复制密钥值（注意应包含sk-前缀的64位字符）。

这里有一个关键点：密钥必须处于启用状态，且权限需包含hunyuan:InvokeModel。如果密钥被停用或权限不完整，OpenClaw会提示“Unauthorized”，此时只能返回控制台重新启用或编辑权限。

在OpenClaw中输入配置信息

操作步骤其实非常直观：

首先，启动OpenClaw，等待初始化完成后出现“Select Provider”选项，使用方向键选中「Custom Provider」并回车。

接着，光标停留在「API Base URL」输入框，将确认好的Base URL粘贴进去，回车确认。

然后，光标跳转到「API Key」输入框，粘贴从控制台复制的完整密钥，回车确认。

最后，系统会自动检测连通性。如果显示“✅ Connection successful”，说明配置已生效；如果显示“❌ Failed to connect”，别着急——请检查密钥是否复制完整、Base URL有无多余空格，以及网络能否直接连接腾讯云域名。完成这几项排查，问题基本就能解决。