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"


