OpenClaw Windows 原生安装部署与API聚合中转获取Claude apikey接入配置教程

OpenClaw Windows 原生安装部署与uiuiAPI聚合中转获取Claude apikey接入配置教程OpenClaw前身为 Clawdbot / MoltBot是一个开源的本地优先 AI Agent 网关可以将大语言模型连接到你的本地系统和消息平台Telegram、WhatsApp、Discord、飞书、企业微信 等实现 24/7 全天候的个人 AI 助手。这篇教程将带你完成从底层环境搭建、大语言模型 API 接入到最终将其作为自动化机器人部署到飞书工作台的全流程自定义 Base URL API Key获取Claude apikey接入 Claude 模型。一、安装前准备1.1 系统要求Windows 10 / Windows 11Node.js 22 LTSGit至少 2GB 可用磁盘空间uiuiAPI获取APIKey1.2 安装 Node.js访问 [Node.js 官网]https://nodejs.org下载 Node.js 22 LTS 的 Windows 安装包.msi。运行安装程序勾选 “Automatically install the necessary tools”。安装完成后关闭并重新打开 PowerShell验证安装node--version# 应显示 v22.x.xnpm--version# 应显示版本号提示如果提示node不是可识别的命令手动将C:\Program Files\nodejs\添加到系统 PATH 环境变量或者重启电脑。1.3 安装 Git在 PowerShell 中运行以下命令winget install Git.Git(或从 [Git 官网]https://git-scm.com下载安装操作在官网根据电脑架构如 Windows x64下载安装包普通用户无需纠结高级设置保持默认选项完成安装。安装时选择 “Use Git from the command line and also from 3rd-party software”。)安装后关闭并重新打开 PowerShell验证git--version二、Windows 原生 PowerShell 安装 OpenClaw2.1 配置 PowerShell 环境以管理员身份打开 PowerShell右键开始菜单 → Windows PowerShell (管理员)依次执行以下命令# 允许脚本执行Set-ExecutionPolicy-ExecutionPolicy RemoteSigned-Scope CurrentUser# 修改 npm 全局安装目录避免权限冲突npm configsetprefixC:\npmnpm configsetcacheC:\npm-cache# 将新目录添加到用户 PATH[Environment]::SetEnvironmentVariable(Path,$env:Path;C:\npm,User)执行完成后关闭 PowerShell 并重新打开一个新窗口让 PATH 生效。2.2 安装 OpenClaw有两种方式推荐先试方式一方式一一键安装脚本iwr-useb https://openclaw.ai/install.ps1|iex方式二手动 npm 安装如果一键脚本报错npm install-g openclaw常见报错处理node.exe 应用程序错误临时关闭 Windows Defender 实时保护再重试。spawn git ENOENTGit 未安装或 PowerShell 未重启先装 Git 再重开窗口。权限错误以管理员身份运行 PowerShell。2.3 运行引导向导引导向导会依次询问你以下内容安全确认用方向键选择 “Yes”确认你理解 OpenClaw 有系统访问权限。安装模式选择 “QuickStart” 快速完成基础配置。选择 LLM 提供商这里先随便选一个或跳过也可以先选No先跳过。我们后面手动配置uiuiAPI的apikey服务。配置消息平台可选Telegram / WhatsApp / Discord / 钉钉 / 飞书 / 企业微信QQ 等 可以之后再配。Shell 补全可选建议选 Yes加速命令输入。包管理器选择 npm。后续选项一路选 “No/Default” 即可。提示如果引导过程中就想配置 API可以暂时跳过 LLM 选择等安装完成后手动编辑配置文件见下一章这样更灵活。2.4 验证安装在浏览器中访问http://127.0.0.1:18789/。如果显示 “unauthorized”在命令行运行openclaw dashboard命令会打印一个带?token...的链接用那个链接打开即可。注意如果 Gateway 安装为后台服务失败需要管理员权限可以用前台模式手动启动openclaw gateway --port 18789三、配置uiuiAPI代理获取Claude APIkey 调用大模型服务使用uiuiAPI代理API Proxy / Relay接入 Claude你需要两样东西Base URLuiuiAPI服务提供的 API 地址API KeyuiuiAPI服务给你的密钥3.1 确认你的中转服务信息信息项示例值说明Base URLhttps://sg.uiuiapi.com代理服务 API 地址API Keysk-xxxxxxxxxxxxxxxx中转服务给你的密钥支持的模型claude-sonnet-4-5-20250929GPT-5、Gemini-3-Pro等可在UIUIAPI模型广场支持哪些关键点uiuiAPI聚合服务兼容Anthropic 原生格式anthropic-messages和 OpenAI 兼容格式openai-completions。3.2 编辑 OpenClaw 配置文件OpenClaw 的配置文件默认位于C:\Users\你的用户名\.openclaw\openclaw.json。用记事本、VS Code 或任何文本编辑器打开它。3.3 配置方案 AuiuiAPI服务兼容 Anthropic 原生格式推荐如果支持 Anthropic 原生 API/v1/messages端点使用anthropic-messages格式。这是推荐方案可使用 Claude 全部高级功能。在openclaw.json中添加或修改为以下内容{api:anthropic-messages,baseUrl:https://sg.uiuiapi.com,apiKey:sk-xxxxxxxxxxxxxxxx,headers:{anthropic-version:2023-06-01,anthropic-beta:},models:[{id:claude-sonnet-4-5-20250929}]}注意事项**baseUrl不要在末尾加/v1**。OpenClaw 使用此格式时会自动拼接/v1/messages。如果 URL 已包含/v1最终会变成/v1/v1/messages导致 404 错误。api: anthropic-messages必须设置否则默认走 OpenAI 兼容模式。headers中的anthropic-version一般需设置为2023-06-01。模型id需与中转服务实际支持的模型一致。如果中转服务在 thinking/reasoning 功能上不兼容可在 headers 中将anthropic-beta设为空字符串来禁用。3.4 配置方案 BuiuiAPI服务兼容 OpenAI 格式如果提供的是 OpenAI 兼容接口/v1/chat/completions端点使用以下配置{api:openai-completions,baseUrl:https://sg.uiuiapi.com/v1,apiKey:sk-xxxxxxxxxxxxxxxx,models:[{id:claude-sonnet-4-5-20250929}]}注意事项**baseUrl需要在末尾加/v1**这是 OpenAI 兼容协议的标准路径。此模式下Claude 的部分原生高级功能如 Prompt Caching、Extended Thinking可能不可用。3.5 两种格式对比速查对比项anthropic-messages推荐openai-completionsapi 字段anthropic-messagesopenai-completionsbaseUrl 末尾不加/v1要加/v1Prompt Caching支持不支持Extended Thinking支持不支持Tool Calling 稳定性更好原生格式可能有兼容问题适用场景中转支持 Anthropic 原生 API中转只提供 OpenAI 兼容接口建议如果同时支持两种格式优先选anthropic-messages。3.6 重启 Gateway 使配置生效修改配置文件后必须重启 Gatewayopenclaw gateway restart(如果是前台模式运行先CtrlC关闭然后再重新启动)3.7 验证连接打开 Dashboard 控制面板http://127.0.0.1:18789/发送一条测试消息看是否能收到回复。如果遇到问题请查看日志openclaw logs--follow四、完整配置文件示例下面是一个完整的openclaw.json配置示例结合了保留内置配置、主备模型以及高级参数设置{mode:merge,primary:claude-sonnet-4-5-20250929,fallbacks:[claude-opus-4-6],providers:{my-proxy:{api:anthropic-messages,baseUrl:https://sg.uiuiapi.com,apiKey:sk-xxxxxxxxxxxxxxxx,headers:{anthropic-version:2023-06-01,anthropic-beta:},models:[{id:claude-sonnet-4-5-20250929,contextWindow:200000,maxTokens:8192,reasoning:true},{id:claude-opus-4-6,contextWindow:200000,maxTokens:4096}]}}}字段说明mode: merge保留 OpenClaw 内置的其他 provider 配置只合并你新增的。primary默认使用的主力模型。fallbacks主力模型不可用时的备用模型。reasoning: true告诉 OpenClaw 该模型支持推理/思考能力。contextWindow模型的上下文窗口大小token 数。maxTokens单次回复最大 token 数。anthropic-beta: 设为空字符串可禁用 beta 功能避免某些中转服务不支持导致的报错。五、进阶配置5.1 多 Agent 使用不同模型为不同任务分配不同模型平衡费用和性能。例如复杂任务用 Opus日常聊天用 Sonnet。这通常可以在 Dashboard 界面中针对不同的 Agent 单独指定。5.2 切换默认模型如果想在命令行快速切换主力模型可以使用openclaw modelssetmodel_id5.3 配置消息平台可选安装完成后可以随时添加消息平台在终端输入以下命令并按提示操作openclaw configure一、飞书工作台深度接入为例1. 创建飞书应用登录飞书开放平台进入“开发者后台”点击创建企业自建应用填写机器人的名称与描述。2. 开通基础权限在应用设置中添加机器人能力。进入“权限管理”搜索栏输入IM:勾选开通所有与消息相关的权限。随后点击“创建版本”并确认发布版本号可设为 1.0.0。3. 唤醒配置终端回到 PowerShell 终端输入openclaw配置命令重新进入设置界面。选择配置通讯渠道并添加飞书系统会自动通过 npm 安装飞书插件。4. 绑定飞书凭证将飞书开发者后台提供的App Secret和App ID复制并依次粘贴到 PowerShell 终端中。5. 设置通信协议通信方式选择配置最简单的WebSocket模式。根据你的实际需求设置私聊和群聊的访问权限例如选择Open允许团队所有人使用。6. 配置事件回调返回飞书开发者后台在“事件与回调”模块中将订阅方式切换为长链接并搜索添加接收消息事件。7. 补充权限并生效再次进入飞书“权限管理”补充开通获取机器人基本信息等权限。最后务必再次发布一个新版本使所有配置正式生效。二、测试与能力进阶1. 最终联调测试打开飞书 APP 或桌面端在消息列表中搜索并打开你刚刚创建的机器人应用。尝试私聊发送消息或将其拉入群聊中它进行提问确认回复延迟和逻辑是否正常。2. 扩展自动化技能基础对话跑通后你可以回到 OpenClaw 的配置界面为它安装更多自动化Skills例如 AI 绘图、自动搜集资料等。强烈建议仅安装官方或来源可靠的技能插件以保障你的 API 额度与数据安全。六、常用命令速查命令作用openclaw gateway status检查网关运行状态openclaw gateway restart重启网关openclaw gateway --port 18789前台模式启动网关openclaw dashboard打开控制面板openclaw models list查看所有已配置的模型openclaw models set model切换默认模型openclaw doctor自动诊断和修复问题openclaw doctor --fix自动修复发现的问题openclaw gateway logs查看网关后台日志openclaw logs --follow实时追踪日志排错必备openclaw status --all查看完整诊断报告openclaw configure重新配置频道等选项openclaw --version查看当前版本七、常见问题排查Q1修改了配置但没生效最常见的原因是已有会话缓存了旧配置。解决方法重启 Gatewayopenclaw gateway restart在新的聊天频道中测试不要在旧会话中测试。Q2请求返回 404 错误检查baseUrl配置如果api是anthropic-messagesbaseUrl不要加/v1。如果api是openai-completionsbaseUrl要加/v1。Q3报错 “invalid beta flag” 或 “ValidationException”某些中转服务不支持 Anthropic 的 beta 功能。请在配置的headers中显式禁用它headers:{anthropic-beta:}Q4Gateway 无响应或端口占用尝试重启电脑或者使用openclaw doctor检查端口冲突问题。Q5PowerShell 安装时 node.exe 报错右键下载的文件 → 属性 → 勾选解除锁定 → 应用。临时关闭 Windows Defender 实时保护。以管理员身份运行 PowerShell。Q6npm 安装报错 “spawn git ENOENT”Git 没有安装。先按 1.3 节安装 Git然后关闭并重新打开 PowerShell 再重试。Q7如何查看具体的 API 请求错误实时查看日志openclaw logs --follow发送一条消息后观察日志中的错误信息通常会显示 HTTP 状态码和错误详情。八、安全注意事项API Key 安全openclaw.json中的 API Key 是明文存储的。注意文件权限不要分享或提交到 Git 等代码库。绑定地址Gateway 绑定到 localhost。确保配置中绑定地址是127.0.0.1默认已是**不要改成0.0.0.0**暴露到公网。操作确认建议在配置中加入exec: { ask: on }让 OpenClaw 执行系统命令前征求您的同意。运行环境不要在存有高度敏感数据的主力设备上盲目运行未知指令建议使用虚拟机或专用设备跑 Agent。社区 Skills 审查已有恶意 Skills 的报告安装社区 Skills 前请务必先审查其代码行为。