本地部署OpenClaw安装配置使用【测试成功】

# centos8、ubuntu22等系统用高版本的wget https://nodejs.org/dist/v24.13.0/node-v24.13.0-linux-x64.tar.xz# 解压缩tar -xf node-v24.13.0-linux-x64.tar.xz# 把这个解压缩的文件放到用户目录/usr/localmv node-v24.13.0-linux-x64 /usr/local/node# 配置软连接方便进行全局调用sudo ln -s /usr/local/node/bin/node /usr/bin/nodesudo ln -s /usr/local/node/bin/npm /usr/bin/npm

# 执行安装npm install -g openclaw@latest# 配置软连接sudo ln -s /usr/local/node/bin/openclaw /usr/bin/openclaw# 查看是否安装成功openclaw --help

curl -fsSL https://openclaw.ai/install.sh | bash

###这样会输出安装的所有日志，方便查看到底哪里报错curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh \  | CLAWDBOT_NPM_LOGLEVEL=verbose bash -s -- --verbose###可以将报错信息丢给大模型去分析常见原因：Git Key 问题（高频）典型特征：日志中出现：git@github.comPermission denied (publickey)npm ERR! code 128根本原因：npm 表面失败，但根因在 git clone 私有仓库Git SSH Key 没配置 / 配错了四、解决步骤1. 检查 SSH Key 配置# 查看现有 SSH Keyls -la ~/.ssh# 测试 GitHub 连接ssh -T git@github.com2. 生成或配置 SSH Key如果没有 SSH Key：# 生成新的 SSH Keyssh-keygen -t ed25519 -C "your_email@example.com"# 将公钥添加到 GitHubcat ~/.ssh/id_ed25519.pub3. 将公钥添加到 GitHub复制公钥内容登录 GitHub → Settings → SSH and GPG keys → New SSH key粘贴公钥并保存五、其他常见问题1. 网络问题# 配置 npm 镜像（如果在中国大陆）npm config set registry https://registry.npmmirror.com2. Node 版本不兼容# 检查 Node 版本node -v# 推荐使用 nvm 管理 Node 版本nvm install 24nvm use 24

openclaw onboard --install-daemon

# 放行TCP端口sudo ufw allow 18789/tcp# 查看规则sudo ufw status numbered

  "gateway": {    "mode": "local",    "auth": {      "mode": "token",      "token": "***********"    },    "port": 18789,    "bind": "loopback",  // 改为lan    "tailscale": {      "mode": "off",      "resetOnExit": false    }  },

openclaw gateway restart

 "gateway": {    "port": 18789,    "mode": "local",    "bind": "lan",    // 加入下面这行配置    "controlUi": {      "allowInsecureAuth": true    },    "auth": {      "mode": "token",      "token": "*************************************"    },    "tailscale": {      "mode": "off",      "resetOnExit": false    },    "http": {      "endpoints": {        "responses": {          "enabled": true        }      }    }  }

openclaw config set 'models.providers.mass' --json '{  "baseUrl": "https://api.modelarts-maas.com/openai/v1",  "apiKey": "api值",  "api": "openai-completions",  "models": [    { "id": "DeepSeek-V3", "name": "DeepSeek-V3" },    { "id": "deepseek-r1-250528", "name": "deepseek-r1-250528" }  ]}'设置 models.mode 为 mergeopenclaw config set models.mode merge设置默认模型（以deepseek-chat为例）openclaw models set mass/DeepSeek-V3openclaw gateway restart

{"agents": { "defaults": {   "model": { "primary": "bailian/qwen3-max-2026-01-23" },   "models": {     "bailian/qwen3-max-2026-01-23": { "alias": "通义千问 Max Thinking 版" }   } }},"models": { "mode": "merge", "providers": {   "bailian": {     "baseUrl": "https://dashscope.aliyuncs.com/compatible-mode/v1",     "apiKey": "${DASHSCOPE_API_KEY}",     "api": "openai-completions",     "models": [       {         "id": "qwen3-max-2026-01-23",         "name": "通义千问 Max Thinking 版",         "reasoning": false,         "input": ["text"],         "cost": { "input": 0.0025, "output": 0.01, "cacheRead": 0, "cacheWrite": 0 },         "contextWindow": 262144,         "maxTokens": 65536       }     ]   } }}}

我要远程登录一台Linux机器，我要使用SSH密钥验证的方式，请生成一对密钥对，并提供给我公钥

sudo apt install nginxsudo vim /etc/nginx/nginx.conf 注释掉如下行 #include /etc/nginx/sites-enabled/*;上传SSL证书至/etc/nginx/ssl/cd /etc/nginx/conf.d/sudo vim openclaw_nginx_reverse_proxy.conf添加如下行server {     # 将原有 listen 80 修改为 listen 80 改为 listen 443 ssl    listen 443 ssl;    # 原有 server_name，可继续新增更多当前证书支持的域名    server_name openclaw.openjarvis.net;    # ======================= 证书配置开始 =======================    # 指定证书文件（中间证书可以拼接至该pem文件中），请将 /etc/ssl/cert/ssl.pem 替换为您实际使用的证书文件的绝对路径    ssl_certificate /etc/nginx/ssl/openclaw.openjarvis.net.pem;    # 指定私钥文档，请将 /etc/ssl/cert/ssl.key 替换为您实际使用的私钥文件的绝对路径    ssl_certificate_key /etc/nginx/ssl/openclaw.openjarvis.net.key;    # 配置 SSL 会话缓存，提高性能    ssl_session_cache shared:SSL:1m;    # 设置 SSL 会话超时时间    ssl_session_timeout 5m;    # 自定义设置使用的TLS协议的类型以及加密套件（以下为配置示例，请您自行评估是否需要配置）    ssl_ciphers ECDHE-RSA-AES128-GCM-SHA256:ECDHE:ECDH:AES:HIGH:!NULL:!aNULL:!MD5:!ADH:!RC4;    # 指定允许的 TLS 协议版本，TLS协议版本越高，HTTPS通信的安全性越高，但是相较于低版本TLS协议，高版本TLS协议对浏览器的兼容性较差    ssl_protocols TLSv1.2 TLSv1.3;    # 优先使用服务端指定的加密套件    ssl_prefer_server_ciphers on;    # ======================= 证书配置结束 =======================    # 其它配置    location / {        proxy_pass http://127.0.0.1:18789;        # WebSocket升级头        proxy_http_version 1.1;        proxy_set_header Upgrade $http_upgrade;        proxy_set_header Connection 'upgrade';        # 客户端真实信息        proxy_set_header Host $host;        proxy_set_header X-Real-IP $remote_addr;        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;        proxy_set_header X-Forwarded-Proto $scheme;        # 缓冲区设置        proxy_buffering off;        # 超时设置        proxy_read_timeout 86400s;        proxy_send_timeout 86400s;        proxy_connect_timeout 30s;    }}

git clone https://github.com/soimy/openclaw-channel-dingtalk.gitcd openclaw-channel-dingtalkopenclaw plugins install -l .

openclaw gateway restart

version: '3.8'services:  openclaw:    image: 1186258278/openclaw-zh:latest    container_name: openclaw    ports:      - "18789:18789"    volumes:      - openclaw-data:/root/.openclaw    restart: unless-stopped    command: openclaw gateway run    # 新增优化配置    environment:      - TZ=Asia/Shanghai  # 统一时区，避免日志时间错乱      - NODE_ENV=production    logging:  # 日志配置（限制日志大小，避免占满磁盘）      driver: "json-file"      options:        max-size: "100m"  # 单个日志文件最大100M        max-file: "3"     # 最多保留3个日志文件    privileged: false     # 非特权模式（提升安全性）    mem_limit: 1G         # 限制容器内存使用（避免占用过多资源）volumes:  openclaw-data:    driver: local ###先执行初始化基础数据的命令//1. 手动初始化docker-compose run --rm openclaw openclaw setupdocker-compose run --rm openclaw openclaw config set gateway.mode local//2. 配置绑定和认证docker-compose run --rm openclaw openclaw config set gateway.bind landocker-compose run --rm openclaw openclaw config set gateway.auth.token YOUR_TOKEN//3. 设置模型配置,newapiapp是自定义的供应商名称，配置相应的apikey、baseurl、默认Id，可以设置多个docker-compose run --rm openclaw openclaw config set models.providers.newapiapp '{  "api": "openai-completions",  "apiKey": "sk-xxxx",  "baseUrl": "https://api.openai.com/v1",  "models": [    {      "id": "modelscope-k2.5",      "name": "modelscope-k2.5"    }  ]}'//设置默认主模型，后面的对话就可以默认使用对应供应商的模型了docker-compose run --rm openclaw openclaw config set agents.defaults.model.primary "newapiapp/modelscope-k2.5"//4. 允许不完全访问，可以通过ip、域名反代等远程访问docker-compose run --rm openclaw openclaw config set gateway.controlUi.allowInsecureAuth true###配置初始化完成后，可以启动服务，执行如下命令docker-compose up -d

# HTTP 80端口：强制跳转到HTTPSserver {    listen 80;    listen [::]:80;  # 兼容IPv6（可选，建议加）    server_name your-domain.com;  # 替换为你的实际域名（如openclaw.example.com）    # 强制HTTPS跳转（保留原请求路径和参数）    return 301 https://$server_name$request_uri;}# HTTPS 443端口：代理到openclaw容器（18789端口）server {    listen 443 ssl http2;    listen [::]:443 ssl http2;  # 兼容IPv6    server_name your-domain.com;  # 必须和证书域名一致    # SSL证书路径（certbot自动生成，无需手动改）    ssl_certificate /etc/letsencrypt/live/your-domain.com/fullchain.pem;    ssl_certificate_key /etc/letsencrypt/live/your-domain.com/privkey.pem;    # 可选：SSL安全配置（提升HTTPS安全性，建议添加）    ssl_protocols TLSv1.2 TLSv1.3;  # 禁用低版本TLS    ssl_prefer_server_ciphers on;    ssl_ciphers ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-ECDSA-AES256-GCM-SHA384:ECDHE-RSA-AES256-GCM-SHA384;    ssl_session_cache shared:SSL:10m;    ssl_session_timeout 10m;    # 反向代理到openclaw容器（localhost:18789）    location / {        proxy_pass http://localhost:18789;        proxy_http_version 1.1;        # WebSocket兼容（openclaw若用WebSocket，这两行必须加）        proxy_set_header Upgrade $http_upgrade;        proxy_set_header Connection "upgrade";        # 传递客户端真实IP/域名/协议        proxy_set_header Host $host;        proxy_set_header X-Real-IP $remote_addr;        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;        proxy_set_header X-Forwarded-Proto $scheme;        # 禁用缓存（适配动态服务）        proxy_cache_bypass $http_upgrade;        proxy_connect_timeout 30s;  # 连接超时（可选优化）        proxy_send_timeout 30s;        proxy_read_timeout 30s;    }}完整实操步骤（从安装证书到验证生效）前置条件域名 your-domain.com 已解析到宿主机公网 IP（必须！否则 certbot 无法验证）；宿主机 80/443 端口已开放（防火墙 / 安全组需放行）；Nginx 已安装并运行（systemctl status nginx 确认 active）。步骤 1：安装 Certbot（获取 Let's Encrypt 证书）bash运行# 更新apt源（避免安装失败）sudo apt update# 安装certbot和Nginx插件（自动配置Nginx）sudo apt install -y certbot python3-certbot-nginx步骤 2：获取 SSL 证书（自动配置 Nginx）bash运行# 替换为你的实际域名（如openclaw.example.com）sudo certbot --nginx -d your-domain.com执行后按提示操作：输入邮箱 → 同意条款 → 是否共享邮箱（选 N） → 选择是否自动跳转 HTTPS（选 2，强制跳转）；成功后，certbot 会自动修改 Nginx 配置，无需手动改ssl_certificate路径。步骤 3：验证证书配置bash运行# 检查Nginx配置语法（避免格式错误）sudo nginx -t# 重载Nginx配置（无需重启，平滑生效）sudo systemctl reload nginx# 验证HTTPS是否生效curl -I https://your-domain.com# 输出包含「Server: nginx」「Strict-Transport-Security」即为成功步骤 4：配置证书自动续期（Let's Encrypt 证书 90 天过期）bash运行# 测试自动续期（仅测试，不实际续期）sudo certbot renew --dry-run# 添加定时任务（每天自动检查续期）sudo crontab -e# 粘贴以下内容（每天凌晨3点检查，证书快过期则自动续期）0 3 * * * /usr/bin/certbot renew --quiet && systemctl reload nginx

版权声明：本文内容转载自自稀土CSDN博客:qq_31292011，遵循CC 4.0 BY-SA版权协议上原文接及本声明。本作品采用知识共享署名-非商业性使用-禁止演绎 2.5 中国大陆许可协议进行可。原文链接：https://blog.csdn.net/qq_31292011/article/details/157899970如有涉及到侵权，请联系，将立即予以删除处理。在此特别鸣谢原作者的创作。此篇文章的所有版权归原作者所有，与本公众号无关，商业转载建议请联系原作者，非商业转载请注明出处