ARTICLE DETAIL

资讯详情

深耕郑州网站建设与运营推广的一线实战洞察。

OpenClaw 一键初始化脚本:安装后一条命令就上线

OpenClaw 一键初始化脚本:安装后一条命令就上线 github项目地址scripts/init-openclaw.sh at main · xztjhs/scripts · GitHub# OpenClaw 一键初始化脚本从零到上线就一条命令## 背景OpenClaw 是一个开源的 AI Agent 框架部署在自己的服务器上通过 Gateway 提供服务。但每次新装一台机器都要手动跑十来条 openclaw config set还要处理 TLS 证书、认证 token、可信 IP 白名单……繁琐且容易出错。于是写了个 bash 脚本 init-openclaw.sh一条命令完成全部初始化配置。---## 脚本做了什么按顺序完成 4 件事### 1. 交互式输入服务器 IP脚本启动后提示输入服务器 IP强制校验格式IPv4 四段式。留空直接终止不给默认值——防止误配到错误地址。请输入服务器 IP: 192.168.254.196✅ 服务器 IP: 192.168.254.196### 2. Token 自动管理认证 token 的处理逻辑- ~/.openclaw/tokens **存在** → 读取首行校验是否为 48 位十六进制字符串openssl rand -hex 24 的标准输出格式。格式不对直接终止提示人工检查。- ~/.openclaw/tokens **不存在** → 自动生成新 token写入文件权限设为 600。- 文件存在但**内容为空** → 同上生成新 token 并写入。这个 token 会同时设置到 gateway.auth.token 和 gateway.remote.token客户端连接时用同一个。### 3. TLS 证书利旧或新建检查 ~/.openclaw/tls/server.crt 和 ~/.openclaw/tls/server.key- **都存在** → 直接利旧跳过生成步骤- **任一不存在** → 用 openssl req -x509 生成自签证书SAN 包含 127.0.0.1 和输入的服务器 IP有效期 365 天### 4. 执行 OpenClaw 配置按顺序执行以下配置项IP 和 token 全程通过变量替换| 配置项 | 值 ||---|---|| gateway.mode | local || gateway.bind | lan || gateway.auth.token | 从 tokens 文件读取或自动生成 || gateway.remote.token | 同上 || gateway.tls.enabled | true || gateway.tls.autoGenerate | false || gateway.tls.certPath | ~/.openclaw/tls/server.crt || gateway.tls.keyPath | ~/.openclaw/tls/server.key || gateway.controlUi.allowedOrigins | localhost、127.0.0.1、输入IP 三者 的 https://*:18789 || gateway.trustedProxies | [127.0.0.1, ::1] |---## 使用方法### 前置条件- 已安装 openclaw CLI 并在 PATH 中- 已安装 openssl- 对 ~/.openclaw/ 目录有读写权限### 运行bashbash init-openclaw.sh### 典型输出请输入服务器 IP: 192.168.254.196✅ 服务器 IP: 192.168.254.196✅ tokens 文件不存在已生成新 token 并写入 /home/user/.openclaw/tokens✅ TLS 证书已生成 开始配置 OpenClaw ✅ gateway.mode local✅ gateway.bind lan✅ gateway.auth.token ***✅ gateway.remote.token ***✅ gateway.tls.enabled true✅ gateway.tls.autoGenerate false✅ gateway.tls.certPath /home/user/.openclaw/tls/server.crt✅ gateway.tls.keyPath /home/user/.openclaw/tls/server.key✅ gateway.controlUi.allowedOrigins [localhost, 127.0.0.1, 192.168.254.196]✅ gateway.trustedProxies [127.0.0.1, ::1] 配置完成 服务器 IP: 192.168.254.196Token 文件: /home/user/.openclaw/tokensTLS 证书: /home/user/.openclaw/tls/server.crtTLS 私钥: /home/user/.openclaw/tls/server.key⚠️ 记得重启 gateway 使配置生效: openclaw gateway restart最后重启 Gateway 即可bashopenclaw gateway restart---## 安全设计说明- **Token 文件权限 600**只有文件所有者可读写防止其他用户窃取- **Token 格式校验**48 位十六进制防止误写入随意内容导致认证异常- **TLS 证书利旧**已有证书不会被覆盖方便迁移和批量部署- **set -euo pipefail**脚本遇到任何错误立即停止不会带着错误继续往下跑---## 完整脚本bash#!/usr/bin/env bashset -euo pipefail# # OpenClaw 初始化脚本# 用法: bash init-openclaw.sh# # ---------- 1. 输入服务器 IP ----------read -rp 请输入服务器 IP: SERVER_IPif [[ -z $SERVER_IP ]]; thenecho ❌ 未输入服务器 IP脚本终止exit 1fi# 简单校验 IP 格式if ! [[ $SERVER_IP ~ ^[0-9]{1,3}(\.[0-9]{1,3}){3}$ ]]; thenecho ❌ IP 格式不合法: $SERVER_IPexit 1fiecho ✅ 服务器 IP: $SERVER_IP# ---------- 2. Token 处理 ----------TOKENS_FILE$HOME/.openclaw/tokensif [[ -f $TOKENS_FILE ]]; then# 读取文件内容取第一行非空AUTH_TOKEN$(grep -m1 -v ^$ $TOKENS_FILE | tr -d [:space:])if [[ -z $AUTH_TOKEN ]]; thenAUTH_TOKEN$(openssl rand -hex 24)echo $AUTH_TOKEN $TOKENS_FILEchmod 600 $TOKENS_FILEecho ✅ tokens 文件为空已生成新 token 并写入elif [[ ! $AUTH_TOKEN ~ ^[0-9a-f]{48}$ ]]; thenecho ❌ $TOKENS_FILE 首行内容不符合 token 格式期望 48 位十六进制字符串echo ❌ 请检查 $TOKENS_FILE 内容exit 1elseecho ✅ 从 $TOKENS_FILE 读取已有 tokenfielseAUTH_TOKEN$(openssl rand -hex 24)mkdir -p $HOME/.openclawecho $AUTH_TOKEN $TOKENS_FILEchmod 600 $TOKENS_FILEecho ✅ tokens 文件不存在已生成新 token 并写入 $TOKENS_FILEfi# ---------- 3. TLS 证书处理 ----------TLS_DIR$HOME/.openclaw/tlsCERT_FILE$TLS_DIR/server.crtKEY_FILE$TLS_DIR/server.keyif [[ -f $CERT_FILE -f $KEY_FILE ]]; thenecho ✅ TLS 证书已存在利旧: $CERT_FILE / $KEY_FILEelseecho ⚠️ TLS 证书不存在重新生成...mkdir -p $TLS_DIRopenssl req -x509 \-newkey rsa:2048 \-keyout $KEY_FILE \-out $CERT_FILE \-days 365 \-nodes \-subj /CNopenclaw \-addext subjectAltNameIP:127.0.0.1,IP:${SERVER_IP}echo ✅ TLS 证书已生成fi# ---------- 4. 执行 OpenClaw 配置 ----------echo echo 开始配置 OpenClaw openclaw config set gateway.mode localecho ✅ gateway.mode localopenclaw config set gateway.bind lanecho ✅ gateway.bind lanopenclaw config set gateway.auth.token $AUTH_TOKENecho ✅ gateway.auth.token ***openclaw config set gateway.remote.token $AUTH_TOKENecho ✅ gateway.remote.token ***openclaw config set gateway.tls.enabled trueecho ✅ gateway.tls.enabled trueopenclaw config set gateway.tls.autoGenerate falseecho ✅ gateway.tls.autoGenerate falseopenclaw config set gateway.tls.certPath $CERT_FILEecho ✅ gateway.tls.certPath $CERT_FILEopenclaw config set gateway.tls.keyPath $KEY_FILEecho ✅ gateway.tls.keyPath $KEY_FILEopenclaw config set gateway.controlUi.allowedOrigins \[\https://localhost:18789\, \https://127.0.0.1:18789\, \https://${SERVER_IP}:18789\] \--jsonecho ✅ gateway.controlUi.allowedOrigins [localhost, 127.0.0.1, ${SERVER_IP}]openclaw config set gateway.trustedProxies [127.0.0.1, ::1]echo ✅ gateway.trustedProxies [127.0.0.1, ::1]echo echo 配置完成 echo 服务器 IP: $SERVER_IPecho Token 文件: $TOKENS_FILEecho TLS 证书: $CERT_FILEecho TLS 私钥: $KEY_FILEecho echo ⚠️ 记得重启 gateway 使配置生效: openclaw gateway restart---## 小结脚本本身不复杂但解决了几个实际痛点- **重复配置**10 条命令缩成一次交互- **Token 管理**不再硬编码自动生成 持久化 格式校验- **证书管理**利旧优先避免覆盖已有证书- **安全**set -euo pipefail 文件权限控制适合在多机部署或重装场景下复用。有问题欢迎留言交流。bash脚本具体内容#!/usr/bin/env bashset -euo pipefail# # OpenClaw 初始化脚本# 用法: bash init-openclaw.sh# # ---------- 1. 输入服务器 IP ----------read -rp 请输入服务器 IP: SERVER_IPif [[ -z $SERVER_IP ]]; thenecho ❌ 未输入服务器 IP脚本终止exit 1fi# 简单校验 IP 格式if ! [[ $SERVER_IP ~ ^[0-9]{1,3}(\.[0-9]{1,3}){3}$ ]]; thenecho ❌ IP 格式不合法: $SERVER_IPexit 1fiecho ✅ 服务器 IP: $SERVER_IP# ---------- 2. Token 处理 ----------TOKENS_FILE$HOME/.openclaw/tokensif [[ -f $TOKENS_FILE ]]; then# 读取文件内容取第一行非空AUTH_TOKEN$(grep -m1 -v ^$ $TOKENS_FILE | tr -d [:space:])if [[ -z $AUTH_TOKEN ]]; thenAUTH_TOKEN$(openssl rand -hex 24)echo $AUTH_TOKEN $TOKENS_FILEchmod 600 $TOKENS_FILEecho ✅ tokens 文件为空已生成新 token 并写入elif [[ ! $AUTH_TOKEN ~ ^[0-9a-f]{48}$ ]]; thenecho ❌ $TOKENS_FILE 首行内容不符合 token 格式期望 48 位十六进制字符串echo ❌ 请检查 $TOKENS_FILE 内容exit 1elseecho ✅ 从 $TOKENS_FILE 读取已有 tokenfielseAUTH_TOKEN$(openssl rand -hex 24)mkdir -p $HOME/.openclawecho $AUTH_TOKEN $TOKENS_FILEchmod 600 $TOKENS_FILEecho ✅ tokens 文件不存在已生成新 token 并写入 $TOKENS_FILEfi# ---------- 3. TLS 证书处理 ----------TLS_DIR$HOME/.openclaw/tlsCERT_FILE$TLS_DIR/server.crtKEY_FILE$TLS_DIR/server.keyif [[ -f $CERT_FILE -f $KEY_FILE ]]; thenecho ✅ TLS 证书已存在利旧: $CERT_FILE / $KEY_FILEelseecho ⚠️ TLS 证书不存在重新生成...mkdir -p $TLS_DIRopenssl req -x509 \-newkey rsa:2048 \-keyout $KEY_FILE \-out $CERT_FILE \-days 365 \-nodes \-subj /CNopenclaw \-addext subjectAltNameIP:127.0.0.1,IP:${SERVER_IP}echo ✅ TLS 证书已生成fi# ---------- 4. 执行 OpenClaw 配置 ----------echo echo 开始配置 OpenClaw openclaw config set gateway.mode localecho ✅ gateway.mode localopenclaw config set gateway.bind lanecho ✅ gateway.bind lanopenclaw config set gateway.auth.token $AUTH_TOKENecho ✅ gateway.auth.token ***openclaw config set gateway.remote.token $AUTH_TOKENecho ✅ gateway.remote.token ***openclaw config set gateway.tls.enabled trueecho ✅ gateway.tls.enabled trueopenclaw config set gateway.tls.autoGenerate falseecho ✅ gateway.tls.autoGenerate falseopenclaw config set gateway.tls.certPath $CERT_FILEecho ✅ gateway.tls.certPath $CERT_FILEopenclaw config set gateway.tls.keyPath $KEY_FILEecho ✅ gateway.tls.keyPath $KEY_FILEopenclaw config set gateway.controlUi.allowedOrigins \[\https://localhost:18789\, \https://127.0.0.1:18789\, \https://${SERVER_IP}:18789\] \--jsonecho ✅ gateway.controlUi.allowedOrigins [localhost, 127.0.0.1, ${SERVER_IP}]openclaw config set gateway.trustedProxies [127.0.0.1, ::1]echo ✅ gateway.trustedProxies [127.0.0.1, ::1]echo echo 配置完成 echo 服务器 IP: $SERVER_IPecho Token 文件: $TOKENS_FILEecho TLS 证书: $CERT_FILEecho TLS 私钥: $KEY_FILEecho echo ⚠️ 记得重启 gateway 使配置生效: openclaw gateway restart
返回列表