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

发布时间:2026/10/3 6:46:06

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
延伸阅读

更多相关文章

2026/9/26 23:56:35

WorkBuddy AI智能体:从意图理解到任务自动化的桌面效率革命

1. 从“工具”到“同事”:WorkBuddy AI 桌面智能体的本质跃迁 最近几个月,我的工作流里多了一个“新同事”。它不占工位,不领薪水,但能帮我处理邮件、整理数据、生成周报,甚至在我开会时自动记录要点。这个“同事”就是…

2026/10/3 6:45:13

C++冒泡排序详解:原理、边界与优化

排序这玩意儿,是算法里的“基本功”,而冒泡排序,又是基本功里的“入门拳”。哪怕你用的是C、Java还是Python,思路这东西是相通的。我见过不少人觉得冒泡排序太简单,不屑于深挖,结果面试或者做复杂算法优化的…

2026/10/3 6:45:13

RH134存储管理实战:磁盘分区、文件系统挂载与swap配置

RH134 教材走到第 7 章,终于开始碰真正意义上的“存储管理”了。这一章对准备 RHCSA 考试的人来说属于必拿分项,操作直白、逻辑清晰,但在日常运维里也是翻车重灾区——分区删错、挂载写坏 fstab 导致开机进不去、swap 忘了配导致内存吃紧&…

2026/10/3 6:45:13

双极步进电机驱动方案:DRV8818PWPR与R7KA8T2LFLCAC实战

双极步进电机在工业和机器人场景里的地位,这几年其实一直在悄悄上升。伺服系统精度高、响应快,但成本和调试复杂度摆在那里;而步进电机结构简单、定位保持力强、开环控制就能跑出不错的重复精度,在3D打印、CNC雕刻、机械臂关节、自…

2026/10/2 8:16:46

东莞市品牌网站建设报价常见报错与解决

东莞品牌网站建设报价单背后:一份保姆级建站教程避坑实录 网站做好了没人访问,这大概是很多老板最头疼的事。花了大几万做的品牌站,上线后流量惨淡,比路边摊还冷清。别急着骂外包公司,很多“东莞品牌网站建设报价”里藏着不少猫腻,比如用模板站冒充定制…

2026/10/2 18:20:53

如何划分训练/验证集:Spirula Studio五种eval_mode策略详解

如何划分训练/验证集:Spirula Studio五种eval_mode策略详解 【免费下载链接】spirula-studio Cross-vendor 3D Gaussian Splatting trainer - video to splat to mesh, Vulkan or CUDA. 项目地址: https://gitcode.com/GitHub_Trending/sp/spirula-studio Sp…

2026/10/1 10:48:55

SEO怎么推广速查手册新手避坑实战指南

SEO怎么推广速查手册新手避坑实战指南 模板网站太丑不够用?别急着加滤镜,那是治标不治本。很多老板盯着后台流量掉得眼红,却还在纠结首页Banner的圆角是不是3像素。这就像穿着西装去挖土,姿势不对,努力白费。我整理这份 速查手册…

2026/10/3 0:04:31

国内大学生必备的AI写作辅助软件是哪款?

国内高校学生在论文写作过程中,越来越依赖AI辅助工具提升效率,主流方案以本土化全流程工具为核心,结合通用大模型与专业插件,覆盖选题构思、框架搭建、初稿撰写、查重降重、格式调整等关键环节,本文将深入解析当前主流…

2026/10/3 0:04:31

Codex接入Jev模型完整指南:配置方法、本地部署与踩坑排查

最近不少人在讨论 Codex 搭配 Jev 这套玩法,我一开始没太当回事,直到自己把 Jev 接进 Codex跑了几轮编码任务之后,才明白那些说“直接起飞”的人是怎么想的。Codex 作为工具本身已经够能打了,但模型固定、上下文策略固定&#xff…

2026/10/3 0:04:31

GitHub 热门: NVIDIA/Model-Optimizer

👋 Hi,我擅长 AI 大模型应用落地、意识解码与 AI 开发工具链 。 💡 创业路上,用技术换时间,一起把 AI 变成生产力 🚀 >GitHub 热门: NVIDIA/Model-Optimizer 凌晨两点,你刚把跑通了的 Qwen3.…

还想了解更多?直接咨询顾问

免费诊断 + 免费方案 + 透明报价。

全国咨询热线400-8866-253
免费获取方案
☎咨询二维码 ☎ ↑