OpenClaw AI 助手平台部署与配置指南
OpenClaw 是一个功能强大且易于扩展的 AI 助手开发平台，旨在将操作系统打造为 AI。本文记录了在 Linux 环境下安装、配置及集成大模型的实践过程，重点解决安装坑点、Web 面板访问及远程调试问题。
安装 OpenClaw
环境准备
建议在 Linux 系统上操作。若使用 systemd 服务，需确保服务能自动启动，否则需手动执行 openclaw gateway 命令。
安装方式
1. pnpm 安装
先配置 pnpm 环境：
pnpm setup
source ~/.bashrc
安装 OpenClaw 及相关构建依赖：
pnpm add -g openclaw@latest pnpm approve-builds -g
*注：approve-builds 用于批准 node-llama-cpp, sharp 等包的构建脚本，耗时约 5 分钟。
2. 一键安装
国内网络可能较慢或受 GitHub 影响，可使用官方脚本：
curl -fsSL https://openclaw.ai/install.sh | bash -s -- --install-method git
若遇到 SSL 连接超时，可尝试使用 GitCode 镜像仓库克隆后安装：
git clone https://gitcode.com/GitHub_Trending/cl/openclaw
cd openclaw
curl -fsSL https://openclaw.ai/install.sh | bash -s -- --install-method git
注意：建议安装在用户根目录下。
加速安装
为提高速度，可提前安装 Python 3.11 和 Node.js 24：
sudo apt install python3.11
npm install -g n
启动与控制板配置
初始化配置
运行 onboard 命令进行初始化：
openclaw onboard --install-daemon
根据提示选择 Hooks（如 boot-md, session-memory 等）。
启动网关
openclaw gateway --port 18789 --verbose
默认监听本地回环地址 127.0.0.1:18789。
局域网访问与远程连接
默认配置下无法从外部访问。如需开启局域网访问：
openclaw config set gateway.bind lan
若需从其他机器访问，建议使用 SSH 隧道映射：
ssh -N -L 18789:127.0.0.1:18789 user@server_ip
然后在本地浏览器打开 http://localhost:18789/。
设备配对
登录时若报错 pairing required，需进行设备配对：
openclaw devices list
openclaw devices approve <device_id>
配置大模型
模型选择
免费模型通常 token 长度有限（如 4k），难以满足需求。测试了千帆大模型 ERNIE-Lite-Pro-128K，效果良好。
成本说明
OpenClaw 消耗较大，使用千帆最便宜模型，单次对话（如查询天气、系统信息）约花费 0.02 元。复杂任务费用更高，建议包月使用。
常见问题与排查
npm 版本更新提示
npm notice To update run: npm install -g [email protected]
直接升级即可：
npm install -g [email protected]
Git 权限错误
安装时报错 Permission denied (publickey) 可能是 GitHub 网络波动导致。升级 npm 后重试通常可解决。
构建失败
若遇到 Build failed with 1 error 或 Cannot resolve entry module：
- 清理缓存并重新安装：
pnpm store prune rm -rf node_modules pnpm install pnpm build - 若仍无效，尝试使用 sudo 全局安装：
sudo npm i -g openclaw
磁盘空间不足
安装过程中若报错 Updating repository failed，检查磁盘空间。例如 / 分区满时需扩容。
浏览器 Origin 错误
若报错 origin not allowed，修改配置文件 .openclaw/openclaw.json，在 gateway.controlUi.allowedOrigins 中添加允许的地址：
"allowedOrigins": [
"http://localhost:18789",
"http://127.0.0.1:18789",
"http://192.168.1.12:18789"
]
若出现 control ui requires device identity，请继续使用 SSH 转发至 localhost 访问。
推理模型 API 错误
若报错 Inference Serverless API for this model not found，检查模型服务是否已启动或配置是否正确。
总结
本次部署经历多次尝试，最终方案如下：
- 推荐安装：使用国产适配版
openclaw-cn，通过 pnpm 安装并配置国内源，稳定性更好。pnpm install -g openclaw-cn --registry=https://registry.npmmirror.com openclaw-cn onboard --install-daemon - 模型集成：搭配收费大模型（如 ERNIE-Lite-Pro）以获得更好的长文本支持。
- 替代方案：可关注 WinClaw 等同类工具，部分提供免费额度。
通过上述步骤，成功实现了 OpenClaw 的本地化部署、Web 面板管理及大模型集成。