如何安装openClaw

文档地址：https://docs.openclaw.ai/zh-CN

这里我是用源码安装方式来进行的，首先需要安装nodejs 版本大于等于 22

环境：linux,安装好nodejs并且配置好镜像,安装的服务器要求：2核4G 最低配置，配置过低会导致安装失败，可是适当的配置swap分区保证安装成功

npm install -g pnpm
git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install
pnpm ui:build # 首次运行时自动安装 UI 依赖
pnpm build

pnpm openclaw onboard --install-daemon

安装的时候遇到的问题：

#1、配置 GitHub SSH 密钥
ssh-keygen -t ed25519 -C "your_email@example.com"
#打开 https://github.com/settings/keys 然后配置密钥
#2、 pnpm install -bash: pnpm: 未找到命令 的问题
npm install -g pnpm
ln -sf /www/server/nodejs/v24.11.1/bin/pnpm /usr/local/bin/pnpm
pnpm --version
#3、pnpm install 的时候会报错：@rolldown/binding-linux-x64-gnu 模块没有正确安装

rm -rf node_modules pnpm-lock.yaml

pnpm store prune

pnpm install
#意思就是重新删除然后安装，如果还是安装失败，

# 手动安装 rolldown 的 Linux 绑定
pnpm add @rolldown/binding-linux-x64-gnu@1.0.0-rc.8 --save-dev

安装成功之后，执行命令：

pnpm openclaw onboard --install-daemon

会进入引导：

可以按照截图中的配置来，模型这里我选择的是千问，可自行选择其他模型，消息聊天渠道，我选择的是飞书，需要去飞书开放平台（https://open.feishu.cn/）创建一个机器人回复应用，

分别点击创建应用和发布即可，

打开飞书，向已经创建的自动回复机器人发送消息，会收到返回的配对码：

#服务器端：
pnpm openclaw pairing list feishu
pnpm openclaw pairing approve feishu X379S5M8
#将配对码输入执行

openClaw启动之后访问，web访pnpm openclaw dashboard

#显示的带令牌的完整地址（通常类似 http://127.0.0.1:18789/?token=你的令牌
#可能会打开不成功，因为Gateway没有在运行状态
pnpm openclaw gateway status
pnpm openclaw gateway start #启动
#可能还会遇到gateway没有安装的情况，这时候还需要安装gateway
pnpm openclaw gateway install
#安装gateway 报错：
#请以 root 用户身份执行以下步骤：使用 cat 命令直接创建服务定义文件。将下面的命令完整地复制并粘贴到你的终端中执行：
cat > /etc/systemd/system/openclaw-gateway.service << 'EOF'
[Unit]
Description=OpenClaw Gateway
After=network.target

[Service]
Type=simple
User=root
WorkingDirectory=/www/wwwroot/openclaw
Environment="PATH=/www/server/nodejs/v24.11.1/bin:/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin"
Environment="NODE_OPTIONS=--max-old-space-size=4096"
ExecStart=/www/server/nodejs/v24.11.1/bin/node /www/wwwroot/openclaw/scripts/run-node.mjs gateway --port 18789
Restart=always
RestartSec=10

[Install]
WantedBy=multi-user.target
EOF

#执行完成之后启动：
systemctl daemon-reload
systemctl start openclaw-gateway.service
systemctl status openclaw-gateway.service
systemctl enable openclaw-gateway.service
ss -tlnp | grep 18789  #监听端口知否启动成功

#启动成功之后，我在个人电脑中，打开终端cmd， 输入命令连接：
ssh -N -L 18789:127.0.0.1:18789 root@<你的服务器IP>
#输入服务器的密码之后，访问：http://127.0.0.1:18789/?token=你的令牌 即可，这时候有可能还是访问不了，这是因为服务器禁止端口转发的功能，我们需要开启端口转发的功能

vi /etc/ssh/sshd_config

#找到 AllowTcpForwarding 改为 yes

systemctl restart sshd  #重启ssh服务

#验证修改
sshd -T | grep allowtcpforwarding

openClaw配置文件 /root/.openclaw/openclaw.json ：

{
  "meta": {
    "lastTouchedVersion": "2026.3.8",
    "lastTouchedAt": "2026-03-09T10:14:26.344Z"
  },
  "wizard": {
    "lastRunAt": "2026-03-09T10:14:26.319Z",
    "lastRunVersion": "2026.3.8",
    "lastRunCommand": "onboard",
    "lastRunMode": "local"
  },
  "auth": {
    "profiles": {}
  },
  "models": {
    "providers": {
      "bailian": {
        "baseUrl": "https://dashscope.aliyuncs.com/compatible-mode/v1",
        "apiKey": "sk-7e你自己的appkey",
        "auth": "api-key",
        "api": "openai-completions",
        "authHeader": true,
        "models": [
          {
            "id": "qwen3.5-plus",
            "name": "Qwen 3.5 Plus",
            "reasoning": false,
            "input": ["text"],
            "cost": {
              "input": 0,
              "output": 0,
              "cacheRead": 0,
              "cacheWrite": 0
            },
            "contextWindow": 128000,
            "maxTokens": 8192
          },
          {
            "id": "qwen-vl-plus",
            "name": "Qwen Vision Plus",
            "reasoning": false,
            "input": ["text", "image"],
            "cost": {
              "input": 0,
              "output": 0,
              "cacheRead": 0,
              "cacheWrite": 0
            },
            "contextWindow": 128000,
            "maxTokens": 8192
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "bailian/qwen3.5-plus"
      },
      "models": {},
      "workspace": "/root/.openclaw/workspace",
      "compaction": {
        "mode": "safeguard"
      },
      "maxConcurrent": 4,
      "subagents": {
        "maxConcurrent": 8
      }
    }
  },
  "tools": {
    "profile": "coding"
  },
  "messages": {
    "ackReactionScope": "group-mentions"
  },
  "commands": {
    "native": "auto",
    "nativeSkills": "auto",
    "restart": true,
    "ownerDisplay": "raw"
  },
  "session": {
    "dmScope": "per-channel-peer"
  },
  "hooks": {
    "internal": {
      "enabled": true,
      "entries": {
        "session-memory": {
          "enabled": true
        }
      }
    }
  },
  "channels": {
    "feishu": {
      "enabled": true,
      "appId": "cli_a924c25328f89bb6",
      "appSecret": "HJY2caOxMRdqWjwxI3G2XbihGcjpS0UU",
      "connectionMode": "websocket",
      "domain": "feishu",
      "dmPolicy": "pairing",
      "groupPolicy": "allowlist",
      "groupAllowFrom": ["oc_a063948f39e99b1a1ee2aed68b55fea6"]
    }
  },
  "gateway": {
    "port": 18789,
    "mode": "local",
    "bind": "loopback",
    "auth": {
      "mode": "token",
      "token": "39f70b03c09d667b0dd70a6227dffce41f33338085f3c519"
    },
    "tailscale": {
      "mode": "off",
      "resetOnExit": false
    },
    "nodes": {
      "denyCommands": [
        "camera.snap",
        "camera.clip",
        "screen.record",
        "contacts.add",
        "calendar.add",
        "reminders.add",
        "sms.send"
      ]
    }
  },
  "plugins": {
    "load": {
      "paths": ["/www/wwwroot/openclaw/extensions/feishu"]
    },
    "entries": {
      "bailian-auth": {
        "enabled": true
      },
      "feishu": {
        "enabled": true
      }
    }
  }
}

我这里改为了阿里千问的 qwen3.5-plus 其实区别不大，开通地址：https://bailian.console.aliyun.com/cn-beijing/?tab=model#/model-usage/free-quota 主要是有免费额度，至此安装完成。

posted @ 2026-03-09 19:44 来碗酒喝阅读(5) 评论(0) 收藏举报

刷新页面返回顶部

来碗酒喝

如何安装openClaw

公告