FreeBSD 15 安装 OpenClaw 完整教程

OpenClaw 是一个强大的AI助手框架，支持多种聊天渠道（Telegram、Discord、飞书等）。本教程详细介绍如何在FreeBSD 15系统中安装和配置OpenClaw。

前置要求

在开始安装之前，请确保您具备以下条件：

• 一台运行FreeBSD 15-RELEASE的服务器或电脑
• root权限或sudo访问权限（FreeBSD中使用su或sudo）
• 稳定的网络连接
• 基本的BSD命令行操作知识

第一步：更新系统

首先，更新FreeBSD ports和软件包：

# 更新ports目录（如果使用ports）
 portsnap fetch extract

# 或者直接使用pkg更新
sudo pkg update -f

升级现有软件包：

sudo pkg upgrade -y

第二步：安装必要依赖

OpenClaw基于Node.js开发，需要安装Node.js、npm和其他必要工具。

安装Node.js 20.x

FreeBSD提供了多种方式安装Node.js：

方式一：使用pkg安装（推荐）

# 安装Node.js 20 LTS
sudo pkg install node20 npm curl git wget

方式二：使用ports安装

# 安装Node.js
cd /usr/ports/lang/node20
sudo make install clean

# 安装其他必要工具
cd /usr/ports/devel/git
sudo make install clean

cd /usr/ports/ftp/curl
sudo make install clean

方式三：使用nvm安装（高级用户）

# 安装nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash

# 重新加载shell配置
source ~/.bashrc

# 安装Node.js LTS
nvm install --lts
nvm use --lts

验证安装：

node --version
npm --version

安装其他必要工具

sudo pkg install bash git curl wget nano vim

注意：FreeBSD默认使用sh/bash，如果需要bash：

sudo pkg install bash

第三步：安装OpenClaw CLI

OpenClaw可以通过npm全局安装：

sudo npm install -g openclaw

如果遇到权限问题，可能需要：

# 使用sudo安装
sudo npm install -g openclaw --unsafe-perm=true

# 或者配置npm全局目录
mkdir -p ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrc
npm install -g openclaw

验证安装：

openclaw --version

您应该能看到类似以下的输出：

🦞 OpenClaw 2026.4.21 (f788c88)

第四步：初始化配置

安装完成后，首次运行需要进行基础配置：

openclaw setup

这个命令会引导您完成以下配置：

1. 创建工作区：选择存放配置和数据的目录（默认~/.openclaw）
2. 配置Gateway：设置WebSocket网关的端口（默认8787）
3. 选择渠道：配置您想要使用的聊天渠道（Telegram、Discord、飞书等）

手动配置（可选）

如果您更喜欢手动配置：

# 查看配置选项
openclaw config --help

# 手动设置配置
openclaw config set gateway.port 8787

第五步：启动Gateway服务

OpenClaw使用Gateway作为核心服务，需要先启动它。

方式一：直接运行

openclaw gateway

方式二：使用screen或tmux运行（后台持久化）

# 安装screen
sudo pkg install screen

# 创建screen会话
screen -S openclaw

# 在screen中启动
openclaw gateway

# 分离screen：按 Ctrl+A 然后按 D

或者使用tmux：

# 安装tmux
sudo pkg install tmux

# 创建tmux会话
tmux new -s openclaw

# 在tmux中启动
openclaw gateway

# 分离：按 Ctrl+B 然后按 D

方式三：作为系统服务运行（推荐用于生产环境）

使用rc脚本

创建启动脚本：

sudo tee /usr/local/etc/rc.d/openclaw > /dev/null << 'EOF'
#!/bin/sh

# PROVIDE: openclaw
# REQUIRE: NETWORKING
# KEYWORD: shutdown

. /etc/rc.subr

name="openclaw"
rcvar="${name}_enable"
command="/usr/local/bin/openclaw"
command_args="gateway"
pidfile="/var/run/${name}.pid"

load_rc_config $name
run_rc_command "$EOF"

设置权限并启用：

sudo chmod 755 /usr/local/etc/rc.d/openclaw
sudo sysrc openclaw_enable="YES"
sudo service openclaw start

检查状态：

sudo service openclaw status

第六步：配置聊天渠道

根据您的需求配置相应的聊天渠道。

Telegram

1. 联系 @BotFather 创建机器人，获取API Token
2. 配置Telegram渠道：

openclaw channels login telegram

按照提示输入Token即可。

Discord

1. 在Discord开发者门户创建应用和机器人
2. 获取机器人Token
3. 配置Discord：

openclaw channels login discord

飞书（Lark）

openclaw channels login feishu

需要配置飞书开放平台应用并获取App ID和App Secret。

第七步：验证安装

完成以上步骤后，验证OpenClaw是否正常工作：

# 检查Gateway状态
openclaw status

# 测试健康检查
openclaw health

如果一切正常，您应该能看到Gateway正在运行，并且渠道已连接。

常见问题解决

端口被占用

如果遇到端口占用错误：

# 查找占用端口的进程
sudo sockstat -4 -l | grep 8787

# 或者使用lsof
sudo lsof -i :8787

# 使用其他端口启动
openclaw gateway --port 8788

Node.js版本问题

如果遇到兼容性问题，请确保使用的是Node.js 18.x或更高版本：

# 检查Node版本
node --version

# 如需更新，请参考第二步重新安装

权限问题

如果遇到权限错误：

# 检查OpenClaw目录权限
ls -la ~/.openclaw

# 如需修复
chown -R $USER:$USER ~/.openclaw

FreeBSD特定问题

pkg命令找不到

# 初始化pkg（首次使用）
sudo pkg

# 更新仓库数据
sudo pkg update

防火墙配置

FreeBSD使用pf作为默认防火墙，需要开放端口：

# 编辑pf配置
sudo nano /etc/pf.conf

# 添加规则（根据需要调整端口）
pass in on egress proto tcp from any to any port 8787

# 重新加载pf规则
sudo pfctl -f /etc/pf.conf

或者使用ipfw：

# 开放端口
sudo ipfw add allow tcp from any to any 8787 in

高级配置

配置模型提供商

OpenClaw支持多种AI模型提供商：

# 查看可用模型
openclaw models list

# 配置OpenAI
openclaw config set providers.openai.key YOUR_API_KEY

# 配置本地模型（如Ollama）
openclaw config set providers.ollama.url http://localhost:11434

配置安全策略

# 查看安全选项
openclaw security --help

# 配置执行策略
openclaw exec-policy set --scope node --policy allow

使用Docker运行（可选）

如果更喜欢使用Docker：

# 安装Docker
sudo pkg install docker

# 启用Docker服务
sudo sysrc docker_enable="YES"
sudo service docker start

# 拉取并运行OpenClaw
docker pull openclaw/openclaw
docker run -d \
  --name openclaw \
  -p 8787:8787 \
  -v ~/.openclaw:/root/.openclaw \
  openclaw/openclaw

高级：配置HTTPS/WebSocket安全

对于生产环境，建议配置HTTPS和WSS：

# 使用nginx反向代理
sudo pkg install nginx

# 配置nginx
sudo nano /usr/local/etc/nginx/nginx.conf

示例nginx配置：

server {
    listen 443 ssl http2;
    server_name your-domain.com;

    ssl_certificate /path/to/ssl/cert.pem;
    ssl_certificate_key /path/to/ssl/key.pem;

    location / {
        proxy_pass http://127.0.0.1:8787;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
    }
}

总结

恭喜！您已经成功在FreeBSD 15上安装了OpenClaw。现在您可以：

• 通过配置的渠道与AI助手交互
• 使用OpenClaw的各种功能（如文件管理、代码执行等）
• 根据需要扩展更多渠道和功能

如需更多帮助，请查阅官方文档：https://docs.openclaw.ai

祝您使用愉快！