初始化OpenClaw

发表于： 更新于： 分类于：
字数： 2159 阅读：≈ 5分钟 浏览： 评论：
温馨提醒
总结摘要
详细介绍OpenClaw AI助手的完整初始化配置流程，包括网关设置、工作目录配置、认证方式选择等核心技术要点

初始化OpenClaw

该文档是纯初始化操作，不包含skills、插件、通信渠道、大模型等设置

在安装完成OpenClaw之后，会自动启动一个初始化页面（如果误操作选择了No可以使用命令openclaw onboard，命令调出初始化，如下图。

初始化OpenClaw

如果是安装完成之后选择了No退出了，或者是安装完成之后仍希望调初始化引导配置OpenClaw的，可以使用命令：openclaw onboard 命令进行初始化操作，这里翻译阅读风险声明之后选择【Yes】回车，选择时使用键盘方向键或空格选择。

初始化操作可以分为快速初始化和手动初始化，主要完成的配置如下：

**本地模式（默认）**引导你完成：

  • 模型/认证（OpenAI Code (Codex) 订阅 OAuth、Anthropic API 密钥（推荐）或 setup-token（粘贴），以及 MiniMax/GLM/Moonshot/AI Gateway 选项）
  • 工作区位置 + 引导文件
  • Gateway 网关设置（端口/绑定/认证/tailscale）
  • 通信渠道提供商（Telegram、WhatsApp、Discord、Google Chat、Mattermost（插件）、Signal）
  • 守护进程安装（LaunchAgent / systemd 用户单元）
  • 健康检查
  • Skills（推荐）

官方引导可以参考：https://docs.openclaw.ai/zh-CN/start/wizard

如下图所示，开始选择初始化的方式

初始化方式

会有两个选项【QuickStart】（快速初始化）、【Manual】（手动配置）此次示例以手动配置为例，因此选择【Manual】继续下一步

下一步之后到选择安装模式【Local Gateway】（本地安装gateway），【Remote Gateway】（使用远程的gateway），这个涉及到openclaw的运行逻辑，因为openclaw可以有一个gateway控制多个node，这里我们是给本地服务器安装，因此选择第一个之后回车进行下一步。

安装模式

这里是可以自行设置openclaw工作目录，该工作目录会包含一些提示词、技能安装、插件安装路径，如果没有特殊要求，保持这个路径即可回车下一步

image-20260213154616237

这里一步就开始有所不同了，个人喜好或tokens价格的问题有人会选择不同的大模型供应商，这里我为了方便演示，先使跳过设置【Skip for now】，接下来的选择供应商这里，仍然跳过，先完成安装之后在进行设置，接下来的选择是【All providers】-【Keep current】。

跳过选择之后接下来到端口设置的地方，默认的端口为18789，可以自定义设置或者保留该设置，如果需要更改，退格删除端口自己配置即可，我这边不改了，直接回车下一步

端口设置

这里设置的是网关程序绑定的IP，可以支持的选项如下图

选项的含义：

  • Loopback：本地回环IP：127.0.0.1，选择该选项之后只能本地去访问gateway的dashboard
  • LAN：侦听所有网卡的IP，如果您需要公网访问、IPv6访问、局域网访问，则选择该选项
  • Tailnet：这个是绑定到Tailscale IP上，Tailscale可以简单理解为一个虚拟网卡用于内网穿透，想了解的可以参考：https://tailscale.com/docs
  • Auto：官方解释是如果存在 tailnet IP 则优先使用，否则 lan，我不使用tailscale所以没有测试
  • Custom IP：这个是自定义侦听IP，适用于监听某一个网卡已存在的IP

网关侦听绑定

通常情况下两种选择，一种是本机环境，那么就选择Loopback即可，如果需要公网或局域网选择的话，那么就是用LAN即可，我这里选择【LAN】下一步继续操作

下一步到Gateway的验证方式，验证方式推荐使用Token，也是官方推荐的一种。保持默认选择进行下一步

认证方式选择

下一步是关于Tailscale设置，我这里直接跳过了，选择的【OFF】继续下一步

这里"Gateway token"是设置连接远程时使用的token地址，建议不要有符号（设置符号的话后续URL访问需要转义才可以使用），使用数字和字母即可，输入自己设置的token继续下一步

Token设置

接下列是"chat channels"的设置，这篇文章不包含，因此跳过。包括后续的skills、hooks都是选择的跳过

image-20260213164342920

直到下一个选项，如下图所示，如果执行的安装命令或者是跳过安装重新使用openclaw onboard命令进入的该初始胡操作的话，因为服务器内还没有Gateway服务，所以是"install Gateway services"，选择推荐的Yes即可，之后会到安装角色，只有一个node那么选择之后下一步

安装网关

image-20260213164720506

下一步到配置，这个功能应该是心上的，如果是快速安装或者是低版本的openclaw就没有这个，建议安装，安装后可以在命令使用openclaw 按tab键提示接下来的子命令以及参数选择（安装之后每次打开shell窗口或命令行会有一些卡顿，自行决定吧）

shell bash completion

出现：“Onboarding complete. Dashboard opened; keep that tab to control OpenClaw.“则说明安装完成，直接ctrl + c 结束即可

安装完成

可以使用命令：ss -tpln|grep openclaw 看下gateway服务是否在运行

ss -tpln|grep opencalw

打开自己的浏览器去访问安装服务器的IP+端口+token去访问即可

如果需要快速获取，可以使用命令下列命令获取完整路径

1
2

# 获取 dashboard访问地址
openclaw dashboard

本地访问到这里就已经安装初始化完成

完成截图