记录了在 Linux 环境下部署 OpenClaw AI 助手平台的实践过程。主要解决了安装过程中的依赖问题、Web 管理面板无法访问及远程连接故障。通过 pnpm 和一键脚本安装，配置了网关绑定与 SSH 隧道实现局域网访问。集成了千帆大模型 ERNIE-Lite-Pro-128K，并分析了使用成本。总结了常见报错如 Git 权限、磁盘空间不足及构建失败的解决方案，最终推荐国产适配版本 openclaw-cn 以获得更稳定的体验。
OpenClaw 是一个功能强大且易于扩展的 AI 助手开发平台，旨在将操作系统打造为 AI。本文记录了在 Linux 环境下安装、配置及集成大模型的实践过程，重点解决安装坑点、Web 面板访问及远程调试问题。
建议在 Linux 系统上操作。若使用 systemd 服务，需确保服务能自动启动，否则需手动执行 openclaw gateway 命令。
先配置 pnpm 环境：
pnpm setup
source ~/.bashrc
安装 OpenClaw 及相关构建依赖：
pnpm add -g openclaw@latest pnpm approve-builds -g
*注：approve-builds 用于批准 node-llama-cpp, sharp 等包的构建脚本，耗时约 5 分钟。
国内网络可能较慢或受 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 notice To update run: npm install -g [email protected]
直接升级即可：
npm install -g [email protected]
安装时报错 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 npm i -g openclaw
安装过程中若报错 Updating repository failed，检查磁盘空间。例如 / 分区满时需扩容。
若报错 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 访问。
若报错 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
通过上述步骤，成功实现了 OpenClaw 的本地化部署、Web 面板管理及大模型集成。
微信公众号「极客日志」，在微信中扫描左侧二维码关注。展示文案：极客日志 zeeklog
生成新的随机RSA私钥和公钥pem证书。 在线工具，RSA密钥对生成器在线工具，online
基于 Mermaid.js 实时预览流程图、时序图等图表，支持源码编辑与即时渲染。 在线工具，Mermaid 预览与可视化编辑在线工具，online
查找任何按下的键的javascript键代码、代码、位置和修饰符。 在线工具，Keycode 信息在线工具，online
JavaScript 字符串转义/反转义；Java 风格 \uXXXX（Native2Ascii）编码与解码。 在线工具，Escape 与 Native 编解码在线工具，online
使用 Prettier 在浏览器内格式化 JavaScript 或 HTML 片段。 在线工具，JavaScript / HTML 格式化在线工具，online
Terser 压缩、变量名混淆，或 javascript-obfuscator 高强度混淆（体积会增大）。 在线工具，JavaScript 压缩与混淆在线工具，online