当前位置：首页 > news >正文

如何安装openClaw

news 2026/5/12 1:52:50

文档地址：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}}}
}