在 Ubuntu 中部署OpenClaw

本指南介绍了如何在 Ubuntu 中部署 OpenClaw 的完整流程,包括环境安装、配置和访问方式。

可参见:菜鸟教程-OpenClaw


一、安装基础环境

1. 更新 apt 包管理器

apt update

2. 安装 Git

apt install git -y

3. 安装 Curl

apt install curl -y

4. 安装 Node.js

访问 Node.js 官方下载页面 或使用 NVM 安装:

# 安装 NVM
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.4/install.sh | bash
 
# 加载 NVM
\. "$HOME/.nvm/nvm.sh"
 
# 安装 Node.js 24 版本
nvm install 24

5. 安装 OpenClaw

npm i -g openclaw

二、配置 OpenClaw

1. 初始化配置

openclaw onboard

按照提示完成配置:

  • Model:选择使用的 AI 模型
  • Channel:配置通讯渠道(如飞书)
  • Skills:可暂时跳过,后续再配置

2. 启动 Gateway

openclaw gateway

3. 配置渠道

根据需要配置飞书、QQ 等通讯渠道。

4. 主配置文件

编辑主配置文件:

nano ~/.openclaw/openclaw.json

注意:修改配置文件后需重启 Gateway:

openclaw gateway restart

三、访问方式

OpenClaw 支持多种访问方式:

1. 通讯渠道访问

如果配置了渠道(如飞书、QQ),可直接通过机器人访问。

QQ开放平台:https://q.qq.com/qqbot/openclaw/login.html

飞书配置:https://www.feishu.cn/content/article/7613711414611463386?utm_source=chatgpt.com

2. TUI 终端访问

openclaw tui

3. Web 访问(gateway 的 bind 需设置为 “lan” 并设置访问许可地址)

  • 安装时会自动生成访问地址
  • 在浏览器中打开该地址即可访问
  • Token 保存在主配置文件 ~/.openclaw/openclaw.json 中,如忘记可查看该文件

常见问题

Q1: 如何查看当前配置?

A: 查看 ~/.openclaw/openclaw.json 文件

Q2: 如何更新 OpenClaw?

A: 运行 npm update -g openclaw

Q3: 想在 Docker 容器中部署用于测试?

A: 参考此文档2 部署(in Docker)