OpenClaw 安装与使用指南

OpenClaw 安装与使用指南svg xmlns http www w3 org 2000 svg style display none svg

大家好,我是讯享网,很高兴认识大家。这里提供最前沿的Ai技术和互联网信息。



 
  
    
     
      
     

OpenClaw 是多通道 AI 网关,支持扩展的消息集成与可视化仪表板。本文档记录安装步骤、常用命令与可视化界面使用。


需已安装并可用:

依赖 要求 验证命令 Node.js 22+ npm 10+ Git 已安装且在 PATH 中

若未安装,可参考同目录下的:


1. 全局安装 OpenClaw

PowerShell 或命令提示符中执行:

GPT plus 代充 只需 145
  • 安装过程会使用 Git,需几分钟,出现 “added xxx packages” 即表示成功。
  • 若报错 ,说明未安装 Git 或 Git 未加入 PATH,请先完成 Git 安装并新开终端再试。

2. 验证安装

 
    

应显示版本号(如 )。

若新开终端后提示 “找不到 openclaw”,请关闭并重新打开终端,或确认 npm 全局目录已在 PATH 中(通常为 )。

3. 首次配置(推荐)

执行引导命令,按提示配置 LLM 与守护进程:

GPT plus 代充 只需 145

按需填写 OpenAI、Anthropic、Gemini 等凭证;完成后网关/服务会按配置运行。


命令 说明 查看版本 检查运行环境 打开仪表板(生成带 token 的链接) 首次配置与安装守护进程 查看网关服务状态、配置路径、端口是否在监听 在前台临时启动网关(未做 onboard 时也可用) 安装网关为系统服务(计划任务),需先完成 onboard

重要:浏览器访问 前,必须让 OpenClaw 网关进程在运行,否则页面会打不开。

4.1 检查网关是否在运行

方式一:看状态

 
      

若输出里没有 “RPC probe: ok” 或显示 “Gateway service missing” / “Runtime: unknown”,说明网关未在运行。

方式二:看端口

GPT plus 代充 只需 145

若能看到一行包含 LISTENING 和 ,说明网关已在监听;若只有 SYN_SENT 没有 LISTENING,说明没有进程在 18789 上监听,需要先启动网关。

4.2 临时启动网关(未做 onboard 时也可用)

在终端执行(保持该终端不关闭):

 
      
  • 表示即使还没有 也可以启动。
  • 启动成功后,再在浏览器打开 或执行 即可使用仪表板。
  • 关闭该终端或按 Ctrl+C 会停止网关,仪表板会再次无法访问。

4.3 长期使用(推荐)

  1. 执行一次引导并安装守护进程:
    GPT plus 代充 只需 145

    按提示配置 LLM 等。

  2. 安装为系统服务(Windows 计划任务),开机或按需自动启动:
     

    之后可通过 / / 管理服务,无需每次手动 。


OpenClaw 提供基于浏览器的管理界面

打开方式

  1. 先确保网关在运行(见上一节「四、启动网关」)。若未运行,先执行:
    GPT plus 代充 只需 145

    并保持该终端不关。

  2. 通过命令打开
    另一个终端执行:
     

    会输出仪表板链接并尝试在浏览器中打开。



  3. 直接访问
    浏览器地址栏输入:


说明

  • 仪表板用于聊天、配置、审批等;具体功能以当前版本为准。
  • 必须先让网关运行(临时用 或长期用 onboard + ),仪表板才能打开。
  • 认证通过 WebSocket 握手时的 token 或密码进行,token 会保存在浏览器 localStorage 中。

Q: 命令找不到

  • 安装后请重新打开终端或 Cursor。
  • 检查 PATH 是否包含 npm 全局目录(如 )。

Q:安装时报错与 Git 相关

  • 先安装 Git 并确保在终端中能执行 ,再执行 。

Q:仪表板 http://127.0.0.1:18789/ 打不开或无法连接

  • 原因:仪表板依赖网关进程,若网关未运行,18789 端口没有在监听,页面会打不开。
  • 排查:执行 ,或 ,看是否有 127.0.0.1:18789 处于 LISTENING
  • 解决:在终端执行 ,保持该终端不关,再在浏览器打开 或执行 。详见上文「四、启动网关」。

Q:提示 (需要 token 才能连上网关)

  • 原因:网关开启了 token 认证(),但你的仪表板/CLI 连接时没有携带 token。
  • 解决(按我刚才的操作复现一遍)
    1. 用 token 模式重启网关(会自动踢掉占用 18789 的旧进程):
GPT plus 代充 只需 145
  1. 生成带 token 的仪表板链接并打开(在另一个终端执行):
 
        
  1. 在浏览器里使用带 token 的链接
    • 会输出类似 的地址。
    • 如果 Control UI 里仍提示填 token,把你的 token 粘贴到 Control UI 的设置里即可。

  • 安装方式
  • 环境:Node.js v22.22.1,npm 10.9.4,Git 已安装。
  • 结果:安装成功,版本 2026.3.7, 与 可用。
  • 仪表板打不开的排查与解决:首次访问时网关未运行,执行 在前台启动网关后,端口 18789 处于 LISTENING,仪表板可正常打开。
  • token 认证导致 unauthorized 的排查与解决:网关启用 token 认证后,需使用 启动,并通过 打开带 的仪表板链接,或在 Control UI 设置中粘贴 token。

文档生成于 2025 年 3 月,适用于 Windows。

openclaw.json目录:

C:Users24.openclawopenclaw.json

小讯
上一篇 2026-03-16 16:36
下一篇 2026-03-16 16:33

相关推荐

版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容,请联系我们,一经查实,本站将立刻删除。
如需转载请保留出处:https://51itzy.com/kjqy/239016.html