Debian部署OpenClaw教程

一、准备工作

（一）所需材料

  1. Debian 服务器

    • 推荐使用 Debian 12 系统

  2. OpenClaw

（二）防火墙放行

需放行以下端口：

  • TCP/22（SSH 默认端口）
  • TCP/18789（OpenClaw Gateway 默认端口）

二、切换 Root 用户

1
su root

三、安装基础工具

（一）安装 curl

1
apt update && apt install -y curl

（二）安装 vim

1
apt install -y vim

四、安装 OpenClaw

1
curl -fsSL https://openclaw.ai/install.sh | bash

安装完成后，需要将 root 下的配置文件复制到普通用户目录：

1
2
3
rm -rf ~/.openclaw
cp -r /root/.openclaw ~/.openclaw
chown -R $(whoami):$(whoami) ~/.openclaw

五、配置 OpenClaw

（一）退出 Root 用户

1
exit

（二）修改配置文件

编辑配置文件：

1
vim ~/.openclaw/openclaw.json

修改以下内容：

  1. 开启 LAN 访问和 Web 控制台
1
2
3
4
5
6
7
8
9
10
11
"gateway": {
  "bind": "lan",
  "controlUi": {
    "enabled": true,
    "allowedOrigins": [
      "*"
    ],
    "allowInsecureAuth": true,
    "dangerouslyDisableDeviceAuth": true
  }
}
  1. 修改 workspace 路径
1
2
3
4
5
"agents": {
  "defaults": {
    "workspace": "/home/你的用户名/.openclaw/workspace"
  }
}
  1. 配置 Skills 文件夹路径
1
2
3
4
5
"skills": {
  "load": {
    "extraDirs": ["~/.openclaw/skills"]
  }
}

（三）创建 Skills 文件夹

1
mkdir -p ~/.openclaw/skills

（四）安装 ClawHub

ClawHub 是 OpenClaw 的 Skills 技能包管理器，可以方便地下载和安装各种技能：

1
npm i -g clawhub

安装完成后，可以使用以下命令：

1
2
3
clawhub search <关键词>    # 搜索技能
clawhub install <技能名>   # 安装技能
clawhub list              # 列出已安装技能

下载的技能会自动解压到 ~/.openclaw/skills/ 目录。

六、安装并启动 Gateway

（一）安装 Gateway 服务

1
openclaw gateway install

（二）检查运行状态

1
openclaw gateway status

正常输出示例：

1
2
3
OpenClaw Gateway is running
  PID: 12345
  Port: 18789

七、配置防火墙

（一）安装 ufw

1
apt install -y ufw

（二）放行端口

1
2
3
ufw allow ssh
ufw allow 18789/tcp
ufw enable

（三）检查防火墙状态

1
ufw status

八、获取访问 Token

1
openclaw dashboard --no-open

输出示例：

1
2
OpenClaw Dashboard
  URL: http://10.10.10.3:18789?token=f744fbd740591971e275c89032a0ca8cbedc1cc4aa90bf48

复制 URL 到浏览器即可访问 Web 控制台。

九、配置静态 IP（可选）

（一）修改网络配置

编辑网络配置文件：

1
vim /etc/network/interfaces

修改为静态 IP：

1
2
3
4
5
6
auto enp1s0
iface enp1s0 inet static
    address 10.10.10.3
    netmask 255.255.255.0
    gateway 10.10.10.1
    dns-nameservers 10.10.10.1 8.8.8.8

注意：enp1s0 需要替换为你的实际网卡名称，可通过 ip addr 查看。

（二）重启网络服务

1
systemctl restart networking

（三）配置 DNS

编辑 DNS 配置文件：

1
vim /etc/resolv.conf

添加 DNS 服务器：

1
2
nameserver 10.10.10.1
nameserver 8.8.8.8

十、验证安装

访问 Web 控制台：

1
http://你的IP:18789/#token=你的Token

如果能看到 OpenClaw 控制界面，说明安装成功！
�