Kali Linux 中 OpenClaw 安装完整指南

环境准备与依赖安装

1. 系统要求检查

在开始安装前，请确保您的 Kali Linux 系统满足以下基本要求：

组件	最低要求	推荐版本
操作系统	Kali Linux 2023+	Kali Linux 2024.3+
内核版本	Linux 5.10+	Linux 6.1+
架构	x86_64	ARM64/x86_64
内存	4GB	8GB+
存储	10GB 可用空间	20GB+ 可用空间

2. Node.js 环境配置

OpenClaw 需要 Node.js 运行环境，建议使用 Node.js 18+ 版本：

# 更新系统包管理器
sudo apt update && sudo apt upgrade -y

# 安装 Node.js 18 LTS 版本
curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash -
sudo apt-get install -y nodejs

# 验证安装
node --version
npm --version

如果遇到权限问题，可以尝试使用 Node Version Manager (NVM) 进行安装：

# 安装 NVM
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
source ~/.bashrc

# 安装并使用 Node.js 18
nvm install 18
nvm use 18

3. 包管理器配置

推荐使用 pnpm 作为包管理器，以提高依赖安装效率：

# 安装 pnpm
npm install -g pnpm

# 或者使用官方脚本安装
curl -fsSL https://get.pnpm.io/install.sh | sh

OpenClaw 安装方法

方法一：官方一键脚本安装（推荐）

这是最快捷的安装方式，适用于大多数用户：

# 下载并执行官方安装脚本
curl -fsSL https://raw.githubusercontent.com/open-claw/cli/main/install.sh | bash

# 或者使用 wget
wget -qO- https://raw.githubusercontent.com/open-claw/cli/main/install.sh | bash

安装完成后，系统会自动启动交互式配置向导：

# 启动 OpenClaw
claw start

配置向导会引导您完成以下设置：

• 访问模式选择：本地访问或远程访问
• Token 认证配置：设置 API 访问令牌
• 端口绑定：默认端口 18789
• 安全策略：配置 allowedOrigins 白名单

方法二：手动源码安装

如果需要更精细的控制或自定义配置，可以选择手动安装：

# 克隆 OpenClaw 仓库
git clone https://github.com/open-claw/openclaw.git
cd openclaw

# 安装依赖
pnpm install

# 构建项目
pnpm build

# 启动开发服务器
pnpm dev

方法三：Docker 容器化安装

对于希望环境隔离的用户，可以使用 Docker 方式：

# 拉取 OpenClaw 镜像
docker pull openclaw/openclaw:latest

# 运行容器
docker run -d \
  --name openclaw \
  -p 18789:18789 \
  -v /path/to/config:/app/config \
  openclaw/openclaw:latest

安装后配置

1. Web 控制台访问

安装完成后，通过浏览器访问 OpenClaw 控制台：

# 默认访问地址
http://localhost:18789

如果遇到 WebSocket 连接问题（如 4008 错误），需要检查防火墙设置和浏览器配置。

2. 大模型集成配置

OpenClaw 支持多种大模型后端，以下是常见的配置示例：

# config.yaml 示例配置
model_providers:
  ollama:
    enabled: true
    base_url: "http://localhost:11434"
    models:
      - name: "qwen:7b"
        type: "chat"
      - name: "llama2:7b" 
        type: "chat"
  
  openai:
    enabled: true
    api_key: "${OPENAI_API_KEY}"
    base_url: "https://api.openai.com/v1"

3. 飞书机器人集成

配置飞书机器人接入：

# 获取飞书开发者凭证
# 1. 访问 https://open.feishu.cn/
# 2. 创建企业自建应用
# 3. 获取 App ID 和 App Secret

# 在 OpenClaw 中配置飞书
claw config set feishu.app_id "your_app_id"
claw config set feishu.app_secret "your_app_secret"
claw config set feishu.encrypt_key "your_encrypt_key"

常见问题排查

1. 依赖冲突解决

如果遇到依赖冲突，可以尝试以下方法：

# 清理 npm 缓存
npm cache clean --force

# 删除 node_modules 重新安装
rm -rf node_modules
pnpm install

# 或者使用 --force 参数强制安装
pnpm install --force

2. 权限问题处理

对于权限相关的错误：

# 修复全局包安装权限
sudo chown -R $(whoami) ~/.npm
sudo chown -R $(whoami) /usr/local/lib/node_modules

# 或者使用 pnpm 的 store 路径配置
pnpm config set store-dir ~/.pnpm-store

3. 网络连接问题

如果下载速度慢或连接超时：

# 配置国内镜像源
npm config set registry https://registry.npmmirror.com
pnpm config set registry https://registry.npmmirror.com

# 或者使用环境变量
export PNPM_REGISTRY=https://registry.npmmirror.com

安全配置建议

1. 生产环境安全设置

安全项目	配置建议	说明
Token 认证	使用强密码生成器	避免使用默认或弱令牌
端口绑定	限制为 localhost	防止外部直接访问
防火墙	配置 IP 白名单	只允许可信 IP 访问
HTTPS	配置 SSL 证书	加密数据传输

2. 访问控制配置

# 安全策略配置示例
security:
  allowed_origins:
    - "https://your-domain.com"
    - "http://localhost:3000"
  rate_limiting:
    enabled: true
    requests_per_minute: 60
  authentication:
    required: true
    token: "your_secure_token_here"

验证安装成功

完成安装后，通过以下命令验证 OpenClaw 是否正常运行：

# 检查服务状态
claw status

# 测试 API 接口
curl -X GET "http://localhost:18789/api/health" \
  -H "Authorization: Bearer your_token"

# 查看日志
claw logs

如果一切正常，您应该能够：

1. 成功访问 Web 控制台界面
2. 通过健康检查 API 获得响应
3. 在日志中看到服务启动成功信息

通过以上步骤，您应该能够在 Kali Linux 系统中成功安装和配置 OpenClaw。如果在安装过程中遇到特定问题，建议参考官方文档或社区支持。