OpenClaw 安装与配置实践
OpenClaw 是一个功能强大、易于扩展的 AI 助手开发平台。本文记录在 Linux 环境下安装 OpenClaw、调试 Web 管理面板及集成大模型的完整过程，包含常见问题的排查方案。
安装 OpenClaw
环境准备
推荐使用 pnpm 或 npm 进行全局安装。若使用一键安装脚本，需注意国内网络环境可能导致 GitHub 访问超时。
pnpm 安装
- 配置 pnpm：
pnpm setup
source ~/.bashrc
- 安装依赖并批准构建：
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 镜像仓库手动克隆后安装：
git clone https://gitcode.com/GitHub_Trending/cl/openclaw
cd openclaw
# 执行后续安装步骤
注意：部分库可能因网络问题无法自动下载，建议提前安装 Node.js 24 及 Python 3.11 以加速构建。
启动与控制板配置
启动服务
openclaw gateway --port 18789 --verbose
默认情况下，网关监听本地回环地址（loopback），仅允许本机访问。
开启局域网访问
如需远程访问，需修改绑定配置：
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>
解决 Origin 报错
若出现 origin not allowed 错误，需修改配置文件 .openclaw/openclaw.json，在 gateway.controlUi.allowedOrigins 中添加允许的域名：
"gateway":
