喂饭教程！在 Linux 环境下快速完成安装、初始化与 Web UI 配置

前言

OpenClaw 是一款开源的 AI Agent 工具，但对第一次接触的用户来说，完整跑通流程并不直观。本文以 Linux 环境为例，详细记录了 OpenClaw 的安装、初始化流程、模型选择、TUI 使用方式，以及 TUI 与 Web UI 认证不一致导致的常见问题与解决方法，帮助你最快速度把 OpenClaw 真正跑起来

环境准备

1）安装nodejs

curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt install -y nodejs

> node --version
v22.22.0

2）安装openclaw

npm install -g openclaw@latest

> openclaw --version
2026.2.25

初始化openclaw

openclaw onboard --install-daemon

• 为了快速跑起来，先选择QuickStart

  

• 选择模型提供商，为了快速测试，这里直接选择Qwen方便快速跑通流程

  

• 选择完成之后，会在浏览器弹出登陆页面

  

• 有为老哥提出疑问：为什么没有支付宝或者手机之类的登陆方式呢？因为openclaw 作为一个开源工具，其默认的 Qwen 配置（qwen-portal）通常指向国际版 API，国际版显然没有支付宝、国内手机号直接登录等登陆方式，取而代之的是Google 账号、GitHub 账号等，如果没有账号，注册一个账号即可
• 选择Qwen也是因为门槛地，快速上手，国际版往往提供针对开发者的免费试用额度（如每天 2000 次请求）
• 后面可以换模型供应商，所以当前的目标是快速搭建并且跑通流程，所以选择Qwen。继续...

• 完成登陆之后回到控制台，选择具体模型，选择默认的即可

  

• 下一步，选择渠道，这里先跳过，因为这一步后面会详细描述，这里的目标还是先完成安装并且跑通

  

• 选择是否配置skills，是

  

• 同样，先跳过，后面再来配置

  

• 下面的全选否

  

• Set GOOGLE_PLACES_API_KEY for goplaces，是否要选择Google Places API 来查询现实世界中的地点信息（比如电影院、餐馆等），首先是不能使用google服务，并且不在我们本文的流程中，暂时不需要，选否
• Set GEMINI_API_KEY for nano-banana-pro，询问你是否要为名为 nano-banana-pro 设置 Google Gemini API 密钥，问题还是不能使用google的服务，选否。至于nano-banana-pro是什么东西，我也不知道...
• Set NOTION_API_KEY for notion?，配置notion的使用权限，notion是什么？Notion 是一款集笔记、文档、任务管理、数据库和协作于一体的“超级办公室”软件。用不上，选否
• Set ELEVENLABS_API_KEY for sag?，让openclaw说话，而不是只有文字交流，而说话的能力正是ElevenLabs赋予的，它提供的服务是目前行业内领先的文本转语音（Text-to-Speech, TTS）平台。其生成的语音非常自然、富有情感，听起来几乎和真人一样。不在当前流程，先选否

• 下一步询问你是否要启用 Hooks（钩子/插件），选择session-memory，让 AI “记住”之前的对话内容或项目上下文，即使你关闭了终端再重新打开，它也能延续之前的话题

  

• 到此基本配置已经结束，下一步问你怎么孵化小机器人，直接选择推荐的方式，使用tui（terminal ui）完成最后一步

  

• 这是终结者要来了吗？斯瓦辛格从天而将，并且bgm：”洞洞咚，懂冻，洞洞咚，懂洞咚“

  

斯瓦辛格能不能说中文阿？

• 能说中文啊，那就更简单了，现在需要告诉配置初始化一下这个机器人，就像星级穿越里面，男主重新配置TAS一样

  

• 配置完成，回归测试一下

  

安装完成

页面配置

为什么tui配置成功了，在webui却一直报错，因为tui和webui使用的是两套完全独立的认证系统

需要把token给应用在页面上就可以了

1）获取token

> cat ~/.openclaw/openclaw.json | grep -o '"token": "[^"]*"'
"token": "7da3f004ff2a1e700f229a87fb5ea12c150b37d58199295f"

2）将参数补充在页面上，token=7da3f004ff2a1e700f229a87fb5ea12c150b37d58199295f

注：如果访问http://127.0.0.1:18789/会有自动跳转，那使用&将参数补充在后面即可

页面也正常了，并且把之前在控制台的聊天记录也同步过来了

总结

本文在linux下实现了安装openclaw，并且完成了基本流程的搭建，至于后面发掘openclaw的更多功能，敬请期待

联系我

• 联系我，做深入的交流

至此，本文结束
在下才疏学浅，有撒汤漏水的，请各位不吝赐教...