OpenClaw 跨平台安装指南
OpenClaw 是一个基于 Node.js 的本地 AI 网关工具，支持在 Windows 和 Linux 环境下部署。以下将分别介绍两种系统下的完整安装与配置流程，涵盖环境准备、依赖安装及大模型对接。
Ubuntu 环境安装教程
Linux 环境是运行此类服务的首选。如果你尚未搭建好基础系统，建议先完成操作系统安装后再继续以下步骤。
部署 Node.js 基础运行环境
OpenClaw 对 Node.js 版本有要求，推荐安装 Node.js 22.x 以保证最佳兼容性。
首先执行 NodeSource 官方脚本配置软件源：
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 需要连接大模型才能工作。启动初始化向导并安装守护进程：
openclaw onboard --install-daemon
屏幕会显示安全警告，确认是在受信任的个人机器或虚拟机中运行后，选择 Yes 继续。
进入向导模式，为简化配置，直接选择绿色的 QuickStart 模式。
接下来选择大模型供应商。考虑到国内网络环境，以 Kimi 为例，选中 Moonshot AI (Kimi K2.5) 并回车。
认证方式选择标准的 Kimi API key (.ai)，随后选择 Paste API key now 直接在终端粘贴之前申请好的密钥。
默认模型保持选中的 Keep current (moonshot/kimi-k2.5) 不动即可。
后续扩展功能配置可暂时跳过：
- Select channel: 选择 Skip for now
- Search provider: 可选择 Kimi (Moonshot) 启用联网搜索
- Configure skills now?: 选择 No
- Enable hooks?: 选择 Skip for now
配置完成后，终端会打印出 Control UI 的控制台网址及安全访问 Token。
启动网关服务并进入可视化界面
手动启动网关服务，指定监听端口为 18789：
openclaw gateway --port 18789
终端开始刷新日志即表示服务已绑定端口。在浏览器地址栏输入 http://127.0.0.1:18789/（服务器环境请替换为公网 IP），即可打开聊天页面与 AI 助手交互。
