OpenClaw 跨平台安装指南
OpenClaw 支持在 Linux 和 Windows 环境下本地部署大模型网关。以下指南将演示从环境准备到服务启动的完整流程，涵盖 Node.js 基础配置、全局包安装及交互式向导设置。
一、Ubuntu 环境安装教程
在 Linux 环境中，命令行操作更为高效。确保已安装 Ubuntu 系统后，即可开始配置。
第一步：部署 Node.js 基础运行环境
OpenClaw 依赖 Node.js 运行环境，建议安装 Node.js 22.x 版本以保证最佳兼容性。
首先执行官方安装脚本配置软件源：
curl -fsSL https://deb.nodesource.com/setup_22.x | bash -
等待脚本执行完毕并看到成功提示后，使用 apt 包管理器安装 Node.js：
apt-get install -y nodejs
安装完成后验证环境：
node -v
若终端显示类似 v22.22.1 的版本号，说明环境配置成功。
第二步：全局安装 OpenClaw
将 OpenClaw 安装到全局环境，以便在任何目录下调用。
npm install -g openclaw@latest
当终端提示 added xxx packages 时，表示依赖包下载完成。检查版本信息确认程序可用：
openclaw --version
第三步：初始化向导与大模型配置
安装完成后需连接大模型服务。官方提供交互式配置向导。
启动初始化向导并安装守护进程：
openclaw onboard --install-daemon
屏幕会显示安全警告，确认是在个人机器或虚拟机中运行后，选择 Yes 继续。
选择向导模式，推荐直接选择绿色的 QuickStart 快速模式。
接下来选择大模型供应商。针对国内网络环境，以 Kimi 为例，选中 Moonshot AI (Kimi K2.5) 并回车。
认证方式选择第一项标准的 Kimi API key (.ai)。
系统询问如何提供秘钥，选择 Paste API key now，直接在终端粘贴之前申请好的 API Key 并回车。
默认模型保持选中的 Keep current (moonshot/kimi-k2.5) 不动。
后续扩展功能配置可暂时略过：
- 渠道选择 Skip for now。
- 搜索引擎服务选择 Kimi (Moonshot) 以启用联网搜索能力。
- 技能配置选择 No。
- 钩子功能选择 Skip for now。
配置完成后，终端会打印出 Control UI 的控制台网址及安全访问 Token。
第四步：启动网关服务并进入可视化界面
配置完成后手动启动网关服务，指定监听端口为 18789：
openclaw gateway --port 18789
终端将刷新日志，表明网关已成功绑定端口。在浏览器地址栏输入 http://127.0.0.1:18789/（服务器环境请替换为公网 IP），即可打开聊天页面与 AI 助手交互。
