OpenClaw 是一个功能强大且易于扩展的 AI 助手开发平台,旨在将操作系统打造为 AI 助手。本文记录了在 Linux 环境下的安装部署过程,涵盖 npm/pnpm 安装方式、Web 管理面板配置及远程访问设置。
安装 OpenClaw
依赖准备
确保系统已安装 Node.js 和构建工具。若使用 pnpm,需先配置:
pnpm setup
source ~/.bashrc
建议升级 Node.js 至最新版本以提升兼容性。
安装方式
1. npm 全局安装
npm i -g openclaw
若启动失败提示找不到命令,可尝试一键安装脚本。
2. pnpm 安装
pnpm add -g openclaw@latest pnpm approve-builds -g
执行 approve-builds 以允许 node-llama-cpp、sharp 等模块编译。
3. 一键安装(推荐)
curl -fsSL https://openclaw.ai/install.sh | bash -s -- --install-method git
若 GitHub 连接不稳定,可使用国内镜像源或提前克隆仓库:
git clone https://gitcode.com/GitHub_Trending/cl/openclaw
cd openclaw
curl -fsSL https://openclaw.ai/install.sh | bash -s -- --install-method git
注意:安装路径建议为用户根目录。
启动与配置
初始化配置
openclaw onboard --install-daemon
根据提示选择 Hooks(如 boot-md, command-logger 等)。
启动服务
openclaw gateway --port 18789 --verbose
默认监听本地回环地址 127.0.0.1:18789。
局域网访问配置
若需从局域网其他设备访问,修改网关绑定配置:
openclaw config set gateway.bind lan
编辑配置文件 .openclaw/openclaw.json,在 gateway.controlUi.allowedOrigins 中添加允许的来源:
{
"gateway": {
"controlUi": {
"allowedOrigins":


