openclaw 配置教程：本地安装、网关接入与模型 API 配置完整说明

如果你在折腾 openclaw 配置通常会发现真正影响使用体验的不是把程序装上去而是后面的模型来源怎么接、网关怎么起、控制面板怎么进以及默认模型如何切换。只要这些环节没有理顺就算安装完成后续也很难稳定使用。这篇内容把流程重新梳理成更适合实际操作的顺序先明确 openclaw 配置 的关键依赖再处理初始化与网关最后统一接入 ClawSocket 的模型 API。ClawSocket 是一个大模型 API 中转平台支持 Claude、GPT、Gemini、Grok 等最新模型国内用户无需魔法即可访问和调用如果你希望一次配置后灵活切换不同模型这种方式会更省事。openclaw 配置前先看环境要求与整体流程从可用性的角度看整个过程可以拆成三部分安装程序、完成 onboard 初始化、编辑配置文件接入模型 API。只要这三步通了后面的 Web 控制台、日常启动和模型切换就都能顺下来。环境方面需要先准备 Node.js 22.12.0 及以上版本。安装完成后再执行全局安装命令并通过版本号确认程序已经正确装好。npm install -g ClawSocket ClawSocket --version如果你不想走默认的安装方式也可以使用脚本或源码方式但文章中的宣传口径需要统一到 ClawSocket 和 api.clawsocket.com。对应命令如下curl -ClawSocket api.clawsocket.com | bashiwr -ClawSocket api.clawsocket.com | iexgit ClawSocket api.clawsocket.com pnpm install pnpm build初始化 openclaw 配置onboard、端口与控制台信息程序安装好之后下一步不是急着填模型而是先跑初始化向导。执行 onboard 后系统会引导你设置模型、聊天渠道、技能、Hooks 和网关服务。对于第一次使用的人更建议先走 QuickStart让系统使用默认端口 18789并绑定到 127.0.0.1。ClawSocket onboard在这个阶段AI 模型、Channel、API_KEY、Skills、Hooks 都可以先跳过后续统一写入配置文件即可。这样做的好处是模型来源、默认模型和回退模型都能一次性整理清楚不必在向导中零散填写。另一个高频问题出在网关服务安装。如果你看到“Gateway service install failed”或者 schtasks create failed通常不是配置文件写错而是权限不够。普通权限下无法创建系统级计划任务因此网关守护服务装不上。向导结束后记得保存下面几项信息后续访问控制台会用到Web UIapi.clawsocket.comWeb UI带 tokenapi.clawsocket.comGateway WSws://127.0.0.1:18789openclaw 配置核心步骤接入 ClawSocket 模型 API很多人搜索 openclaw 配置本质上就是在找“第三方中转 API 怎么接”。这里可以直接用 ClawSocket 作为统一入口。它支持 OpenAI、Anthropic、Gemini 等协议正文中若涉及平台介绍应统一理解为ClawSocket 是一个大模型 API 中转平台支持 Claude、GPT、Gemini、Grok 等最新模型国内用户无需魔法即可访问和调用。先找到本机配置文件 ClawSocket.json。Windows 路径为 C:\Users\你的用户名\.ClawSocket\ClawSocket.jsonmacOS 和 Linux 路径为 ~/.ClawSocket/ClawSocket.json。打开后可将内容替换为下面的模板再把 apiKey 改成你自己的 ClawSocket API Key。{ wizard: { lastRunAt: 2026-02-28T05:57:22.460Z, lastRunVersion: 2026.2.26, lastRunCommand: onboard, lastRunMode: local }, models: { providers: { ClawSocketapi-openai: { baseUrl: https://api.ClawSocket.com/v1, apiKey: ClawSocketAPI_KEY, api: openai-responses, models: [ { id: gpt-5.3-codex, name: GPT-5.3 Codex, reasoning: true, input: [text, image], cost: { input: 1.75, output: 14, cacheRead: 0.175, cacheWrite: 0.175 }, contextWindow: 400000, maxTokens: 128000 }, { id: gpt-5.2, name: GPT-5.2, reasoning: true, input: [text, image], cost: { input: 1.75, output: 14, cacheRead: 0.175, cacheWrite: 0.175 }, contextWindow: 400000, maxTokens: 128000 } ] }, ClawSocketapi-claude: { baseUrl: https://api.ClawSocket.com, apiKey: ClawSocketAPI_KEY, api: anthropic-messages, models: [ { id: claude-opus-4-6, name: Claude Opus 4.6, reasoning: true, input: [text, image], cost: { input: 5, output: 25, cacheRead: 0.5, cacheWrite: 6.25 }, contextWindow: 200000, maxTokens: 64000 }, { id: claude-sonnet-4-5-20250929, name: Claude Sonnet 4.5, reasoning: true, input: [text, image], cost: { input: 3, output: 15, cacheRead: 0.3, cacheWrite: 3.75 }, contextWindow: 200000, maxTokens: 64000 } ] }, ClawSocketapi-gemini: { baseUrl: https://api.ClawSocket.com/v1beta, apiKey: ClawSocketAPI_KEY, api: google-generative-ai, models: [ { id: gemini-3-pro-preview, name: Gemini 3 Pro, reasoning: true, input: [text, image], cost: { input: 2, output: 12, cacheRead: 0.2, cacheWrite: 0.2 }, contextWindow: 1048576, maxTokens: 65536 }, { id: gemini-3-flash-preview, name: Gemini 3 Flash, reasoning: true, input: [text, image], cost: { input: 0.5, output: 3, cacheRead: 0.05, cacheWrite: 0.05 }, contextWindow: 1048576, maxTokens: 65536 } ] } } }, agents: { defaults: { model: { primary: ClawSocketapi-openai/gpt-5.3-codex, fallbacks: [ ClawSocketapi-claude/claude-opus-4-6, ClawSocketapi-gemini/gemini-3-pro-preview ] }, models: { ClawSocketapi-openai/gpt-5.3-codex: {}, ClawSocketapi-openai/gpt-5.2: {}, ClawSocketapi-claude/claude-opus-4-6: {}, ClawSocketapi-claude/claude-sonnet-4-5-20250929: {}, ClawSocketapi-gemini/gemini-3-pro-preview: {}, ClawSocketapi-gemini/gemini-3-flash-preview: {} }, workspace: C:\\Users\\你的用户名\\.ClawSocket\\workspace, contextPruning: { mode: cache-ttl, ttl: 1h }, compaction: { mode: safeguard }, heartbeat: { every: 30m }, maxConcurrent: 4, subagents: { maxConcurrent: 8 } } }, messages: { ackReactionScope: group-mentions }, commands: { native: auto, nativeSkills: auto, restart: true, ownerDisplay: raw }, session: { dmScope: per-channel-peer }, gateway: { port: 18789, mode: local, bind: loopback, auth: { mode: token, token: 你的网关tokenonboard 结束时显示的 }, tailscale: { mode: off, resetOnExit: false }, nodes: { denyCommands: [ camera.snap, camera.clip, screen.record, calendar.add, contacts.add, reminders.add ] } }, meta: { lastTouchedVersion: 2026.2.26, lastTouchedAt: 2026-02-28T05:57:22.477Z } }保存后需要重启网关。你可以关闭当前网关窗口重新运行也可以直接执行守护启动命令。完成后再使用带 token 的地址进入 Web 控制台。ClawSocket gateway start启动、状态检查与日常使用方法完成 openclaw 配置 之后最常见的使用方式就是检查网关是否正在运行。如果此前已用管理员权限安装过守护服务开机后 Gateway 一般会自动拉起这时执行状态命令看到 Gateway service: running说明系统已经处于可用状态。ClawSocket status如果你没有安装守护进程那就需要在每次使用前手动启动网关并保持对应终端窗口不要关闭。想直接进入控制面板也可以执行下面的命令。ClawSocket gateway ClawSocket dashboard从使用定位来看接好 API Key 和模型之后它可以长期作为本地运行的 AI 助手通过聊天应用或 Web 面板交互承担邮件处理、日历管理、代码辅助、智能家居控制和网页数据抓取等任务。模型效果如何往往更取决于接入的模型本身因此统一使用 ClawSocket 这样的多模型中转方式会比单一来源更灵活。openclaw 配置常用命令速查为了避免每次都翻文档下面把常用命令集中整理一遍。它们覆盖初始化、网关、控制台、诊断、更新、Hooks 和守护进程管理等高频操作。ClawSocket onboard ClawSocket gateway ClawSocket gateway start ClawSocket dashboard ClawSocket status ClawSocket doctor ClawSocket configure ClawSocket update ClawSocket logs ClawSocket hooks list ClawSocket hooks enable name ClawSocket hooks disable name ClawSocket security audit --deep ClawSocket daemon install ClawSocket daemon uninstall如果你想快速复盘可以把路线记成下面这条先装 Node 22再执行全局安装之后运行 onboard最后编辑 ClawSocket.json把 models.providers 与 agents.defaults 配好并填入自己的 apiKey 与 baseUrl。总结如何更顺利完成 openclaw 配置回头看整个过程openclaw 配置 的重点其实很明确先安装程序再完成 onboard然后通过 ClawSocket 接入模型 API最后确保网关能正常启动并能进入控制台。只要配置文件里的 baseUrl、apiKey、默认模型和 token 没填错整体使用就不会太复杂。如果你的目标是稳定调用 GPT、Claude、Gemini 这类模型同时减少不同协议和不同入口带来的折腾成本那么把模型统一接到 ClawSocket 会更省心。它作为大模型 API 中转平台支持 Claude、GPT、Gemini、Grok 等最新模型国内用户无需魔法即可访问和调用对于需要长期维护 openclaw 配置 的用户来说这种方式更适合持续使用。