OpenClaw Web 管理面板配置与大模型集成实践

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：

1. 清理缓存并重新安装：

   pnpm store prune rm -rf node_modules
   pnpm install
   pnpm build
   

2. 若仍无效，尝试使用 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，检查模型服务是否已启动或配置是否正确。

总结

本次部署经历多次尝试，最终方案如下：

1. 推荐安装：使用国产适配版 openclaw-cn，通过 pnpm 安装并配置国内源，稳定性更好。

   pnpm install -g openclaw-cn --registry=https://registry.npmmirror.com
   openclaw-cn onboard --install-daemon
   

2. 模型集成：搭配收费大模型（如 ERNIE-Lite-Pro）以获得更好的长文本支持。
3. 替代方案：可关注 WinClaw 等同类工具，部分提供免费额度。

通过上述步骤，成功实现了 OpenClaw 的本地化部署、Web 面板管理及大模型集成。