OpenClaw中部署Upstage Solar模型有四种方法:一、通过内置API网关配置;二、使用Custom LLM Adapter JSON文件集成;三、在Ollama中桥接代理;四、通过ClawHub技能插件动态加载。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

如果您尝试在OpenClaw中调用Upstage Solar模型,但无法正常加载或响应,则可能是由于模型未正确注册、API端点配置错误或认证凭据缺失。以下是部署Upstage Solar模型的多种可行方法:
一、通过OpenClaw内置API网关配置Solar模型
该方法利用OpenClaw的远程模型适配器机制,将Solar作为标准OpenAI兼容接口接入,无需本地运行模型实例。
1、访问Upstage官方平台(https://upstage.ai/)注册账号并登录。
2、进入API Keys管理页面,点击【Create API Key】生成新密钥,复制完整密钥字符串。
3、在终端中执行配置命令:openclaw config set model.provider solar。
4、执行命令设置API密钥:openclaw config set model.api_key <your_upstage_api_key>,注意替换尖括号内为实际密钥。
5、指定API基础地址:openclaw config set model.base_url https://api.upstage.ai/v1/solar。
6、保存并验证配置:openclaw config validate,输出“Solar configuration OK”即表示成功。
二、使用OpenClaw的Custom LLM Adapter方式集成
该方法适用于需要自定义请求头、重试策略或添加代理转发的进阶场景,通过JSON配置文件声明Solar模型行为。
1、在OpenClaw工作目录下创建文件:~/.openclaw/config/custom-solar.json。
2、写入以下内容(确保格式为UTF-8无BOM):
{ "name": "solar-1-mini", "type": "openai-compatible", "base_url": "https://api.upstage.ai/v1/solar", "api_key_env": "UPSTAGE_API_KEY", "model": "solar-1-mini", "headers": { "Authorization": "Bearer {{api_key}}" } }。
3、在系统环境变量中设置密钥:export UPSTAGE_API_KEY=sk-xxx(Linux/macOS)或 set UPSTAGE_API_KEY=sk-xxx(Windows CMD)。
4、重启OpenClaw服务:openclaw restart。
5、在聊天界面输入指令:/model list,确认solar-1-mini出现在可用模型列表中。
三、在Ollama环境中桥接Solar(仅限本地代理模式)
该方法不直接运行Solar,而是通过Ollama的proxy功能将请求转发至Upstage API,使OpenClaw感知为本地Ollama模型,适合已部署Ollama且需统一模型调用入口的用户。
1、确保Ollama已运行,执行命令创建代理模型定义文件:touch ~/.ollama/modelfiles/Modelfile-solar。
2、向该文件写入以下内容:
FROM upstage/solar-1-mini\nPARAMETER proxy_url https://api.upstage.ai/v1/solar\nPARAMETER api_key_env UPSTAGE_API_KEY。
3、构建代理模型:ollama create solar-1-mini -f ~/.ollama/modelfiles/Modelfile-solar。
4、在OpenClaw配置中选择模型提供者为ollama,模型名称填入solar-1-mini。
5、启动OpenClaw时确保环境变量UPSTAGE_API_KEY已生效,且Ollama服务处于运行状态。
四、通过ClawHub技能插件动态加载Solar适配器
该方法依赖社区维护的Solar专用技能包,可实现模型切换、上下文缓存与错误自动重试等增强能力,适用于需要高可用性的生产环境。
1、在终端中执行插件安装命令:openclaw plugin install @clawhub/solar-adapter。
2、安装完成后执行初始化:openclaw solar init。
3、按提示输入Upstage API密钥,并选择默认模型版本(如solar-1-mini或solar-pro)。
4、启用插件:openclaw plugin enable @clawhub/solar-adapter。
5、在OpenClaw Web UI的模型选择下拉菜单中,出现[ClawHub] Solar Adapter选项,选中后即可使用。


















