OpenClaw 是一个功能强大且易于扩展的 AI 助手开发平台，旨在将操作系统打造为 AI。本文档记录了 OpenClaw 的安装、Web 管理面板调试及大模型集成的实践过程。
安装 OpenClaw
npm 安装
npm i -g openclaw
安装后启动服务，若未找到 openclaw 命令，建议采用一键安装方式。
pnpm 安装
- 配置 pnpm：
pnpm setup
source ~/.bashrc
- 安装 OpenClaw：
pnpm add -g openclaw@latest pnpm approve-builds -g
- 初始化配置：
openclaw onboard --install-daemon
一键安装
国内用户建议使用国内镜像源加速：
curl -fsSL https://openclaw.ai/install.sh | bash -s -- --install-method git
若遇到 GitHub 连接超时，可尝试使用 GitCode 镜像仓库或升级 Node.js 版本。
注意： 若磁盘空间不足（如剩余空间小于 15G），可能导致安装失败，请确保系统有足够的存储空间。
启动控制板
基础配置
openclaw onboard
在配置过程中可选择启用 Hooks（如 boot-md, command-logger 等）。
局域网访问配置
默认网关绑定为 loopback，仅允许本地访问。如需开启局域网访问：
openclaw config set gateway.bind lan
修改配置文件 .openclaw/openclaw.json 中的 gateway.controlUi.allowedOrigins，添加对应 IP 地址：
{
"gateway": {
"port": 18789,
"mode": "local",
"bind": "lan",
"controlUi": {
"allowedOrigins": [
"http://localhost:18789",
"http://127.0.0.1:18789",
"http://your_server_ip:18789"
]
}
}
}
远程访问
由于安全限制，建议使用 SSH 隧道映射到本地访问：
ssh -N -L 18789:127.0.0.1:18789 user@server_ip
然后在浏览器打开 http://localhost:18789/#token=YOUR_TOKEN。
配对与批准
登录时若提示 pairing required，需执行以下操作：
openclaw devices list
openclaw devices approve <device_id>
常见故障排查
1. Origin not allowed
报错 origin not allowed 时，需在配置文件中添加允许的域名或 IP。
2. Control UI requires device identity
若提示需要设备身份，请使用 HTTPS 或 localhost secure context，或通过 SSH 转发解决。
3. Git 依赖错误
遇到 ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED 或 git fetch 失败时，检查网络环境，增加 onlyBuiltDependencies 白名单，或手动清理缓存：
pnpm store prune rm -rf node_modules
pnpm install
4. 推理模型 API 不可用
部分免费模型可能因 Token 长度限制或 API 状态问题无法使用。建议测试收费模型以获得更稳定的体验。
配置大模型
模型选择
经过测试，千帆大模型 ERNIE-Lite-Pro-128K 效果较好，支持长上下文。其他免费模型（如星河社区部署的 ERNIE-4.5-21B-A3B-Paddle）可能存在 Token 长度不足或 API 返回 403 的问题。
成本分析
OpenClaw 运行消耗较大，使用千帆最便宜模型单次对话约花费 0.02 元，复杂任务可能达到 1 元左右。建议根据实际需求选择包月方案。
国产替代方案
可尝试 WinClaw（官网：https://winclaw.cn/），目前提供每日千万免费 Token 额度，适合完成轻量级任务。
