☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您希望在 qclaw 中接入 claude 或 gpt 系列模型，但当前仅支持默认内置模型，则需通过外部 api 中转或本地代理方式完成适配。qclaw 本身不直接托管大模型，而是依赖配置文件指向兼容 openai 或 anthropic 协议的 api 端点。以下是实现该目标的具体操作路径：一、使用 88API 中转服务接入 Claude/GPT
该方案无需注册海外账号，利用国内已备案的中转平台统一管理多模型调用，QClaw 可无感识别为标准 OpenAI 兼容接口。
1、访问 https://api.88api.shop 注册账户并获取专属 API Key。
2、登录后台，在“模型管理”中启用 Claude-3.5-Sonnet 与 GPT-4-turbo（或 GPT-5.4）服务，并记录对应模型的 endpoint 地址。
3、打开 QClaw 配置目录：/Users/xeelee/.qclaw/openclaw.json（macOS）或对应 Windows 路径下的同名文件。
4、在该文件中新增一个 model provider 配置块，设置 type 为 "openai"，base_url 指向 88API 提供的 endpoint，api_key 填入上一步获取的密钥。
5、将 agents/main/agent 的 default_model 字段修改为新添加的 provider 名称，保存文件后重启 QClaw。
二、通过 Ollama 本地部署接入 Qwen2.5/Llama3 等开源模型
此方法适用于已有本地大模型运行环境的用户，QClaw 可通过适配器桥接 Ollama 的 /api/chat 接口，实现零积分消耗、全链路数据不出本地。
1、确认 Ollama 已启动且可访问：curl http://localhost:11434 应返回 JSON 响应。
2、执行 ollama list 查看已安装模型，确保存在 qwen2.5:14b 或 llama3:8b 等可用模型。
3、编辑 /Users/xeelee/.qclaw/openclaw.json，添加一个新的 provider，type 设为 "ollama"，base_url 设为 http://localhost:11434/api/chat，model 字段填写 Ollama 中显示的模型名称（如 qwen2.5:14b）。
4、在 main agent 配置中将 default_model 指向该 provider 标识符，例如 "local-qwen"。
5、重启 QClaw 并在微信中发送测试指令，验证是否触发本地模型响应。
三、直接对接 OpenAI 官方 API（需境外网络环境）
该路径要求运行环境具备稳定访问 api.openai.com 的能力，适用于已配置科学上网工具或使用境外服务器部署 QClaw 的场景。
OpenClaw 自我进化框架一键部署。安装宪法(AGENTS.md)、可进化灵魂(SOUL.md)、心跳系统、PARA三层记忆架构、目标管理，并通过场景化对话引导用户定义 Agent 性格。自动配置 EvoClaw（审批制进化）和 Self-Improving Agent（自主学习）。触发场景："setup o...
1、登录 https://platform.openai.com/api-keys 创建新的 Secret Key。
2、检查 QClaw 所在机器能否执行：curl https://api.openai.com/v1/models -H "Authorization: Bearer YOUR_KEY"，确认返回 200 状态码及模型列表。
3、在 /Users/xeelee/.qclaw/openclaw.json 中新增 openai 类型 provider，base_url 使用 https://api.openai.com/v1，api_key 填入上步生成的密钥。
4、为该 provider 指定 model 字段为 gpt-5.4（若已开放）或 gpt-4-turbo。
5、更新 main agent 的 default_model 为该 provider 名称，保存后重启服务。
四、基于 WorkBuddy 辅助完成多模型切换配置
WorkBuddy 是专为 QClaw 用户设计的图形化配置助手，可自动识别本地 Ollama、88API、OpenAI 等多种后端，并生成合规 JSON 配置，避免手动编辑出错。
1、下载并启动 WorkBuddy 应用，确保其与 QClaw 安装在同一台设备。
2、在 WorkBuddy 主界面点击“模型接入向导”，选择“Claude 兼容模式”或“GPT 兼容模式”。
3、根据提示输入对应平台的 API Key 或本地地址，WorkBuddy 将自动探测可用模型列表。
4、勾选目标模型（如 claude-3-5-sonnet-20240620 或 gpt-5.4），点击“生成配置”按钮。
5、WorkBuddy 将直接写入 /Users/xeelee/.qclaw/openclaw.json 并备份原文件，完成后提示重启 QClaw。
