OpenClaw是一个自托管的个人AI助手网关，能将多个聊天应用统一接入AI模型。本教程旨在解决其安装配置过程中的常见问题，帮助用户快速搭建起一个完全由自己掌控的AI网关，实现数据隐私和高效使用的平衡。
智能速览
OpenClaw是一个自托管的AI网关，支持多种聊天应用接入。
安装前需准备Node.js 22及以上版本，推荐在macOS或Linux系统上运行。
通过官方脚本可一键完成基础安装，过程约需15分钟。
配置自定义模型后，需手动调整上下文窗口和最大Tokens参数以避免调用失败。
可通过Web控制台或终端命令行对网关进行全面管理和状态检查。
精华内容
想要打造一个完全由自己掌控的AI助手吗？OpenClaw提供了这样一个机会，但安装配置过程常让人望而却步。下面将带你一步步完成整个部署，从环境准备到解决关键配置问题。
环境准备
部署OpenClaw前，请确保系统满足基本要求。操作系统方面，推荐使用macOS或Linux，Windows系统（非WSL2）运行极其不稳定。核心依赖是Node.js，版本必须大于或等于22.0，可在终端通过`node --version`命令检查。如果使用macOS且未安装Homebrew，需先执行安装命令：`/bin/bash -c “$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)”`。
一键部署
OpenClaw提供了官方推荐的自动化安装脚本。在终端中执行`curl -fsSL https://openclaw.ai/install.sh | bash`即可启动安装流程。安装程序会自动检测并安装Node.js、Git等依赖。过程中会出现多次安全确认提示，均需选择“Yes”并回车，包括创建网关、生成Token、设置目录权限等。安装成功后，终端会显示本地访问地址，默认为http://127.0.0.1:18789。
配置模型
安装完成后，需运行`openclaw onboard`命令进行模型配置。在引导流程中选择“QuickStart”，然后配置自定义提供商。输入API的Base URL和对应的API Key。关键一步是，配置完成后必须手动调整模型的参数，否则可能因上下文过小而调用失败。执行以下命令，并将`custom-claude-chiddns-com`替换为实际的端点ID：
`openclaw config set ‘models.providers.custom-claude-chiddns-com.models[0].contextWindow’ 400000`
`openclaw config set ‘models.providers.custom-claude-chiddns-com.models[0].maxTokens’ 128000`
这能将上下文窗口设置为40万，最大Tokens设置为12.8万，确保复杂任务的正常运行。
验证排错
配置完成后，可以通过多种方式验证安装。执行`openclaw gateway status`查看网关运行状态，或使用`openclaw doctor`进行全面诊断。在桌面环境中，可通过`openclaw dashboard`命令或直接在浏览器访问http://127.0.0.1:18789打开Web控制台。若遇`EADDRINUSE`错误，说明端口被占用，可使用`openclaw gateway --port 18790`更换端口。升级后功能异常，可尝试强制重装元数据：`openclaw gateway install --force`。
