Skip to content

HiClaw 部署指南

This content is not available in your language yet.

环境要求

Section titled “环境要求”
  • Docker 已安装并运行
  • LLM API Key（如通义千问、OpenAI）
  • （可选）GitHub Personal Access Token，用于 GitHub 协作功能

快速安装

Section titled “快速安装”

方式一：一键安装脚本

Section titled “方式一：一键安装脚本”
Terminal window
# 交互式安装
bash <(curl -sSL https://higress.ai/hiclaw/install.sh)

安装脚本会自动：

  1. 检测时区，选择最优镜像源
  2. 交互式配置（LLM 提供商、API Key、端口等）
  3. 等待 Manager 就绪后退出
  4. 发送欢迎消息

方式二：克隆源码安装

Section titled “方式二：克隆源码安装”
Terminal window
git clone https://github.com/higress-group/hiclaw.git && cd hiclaw
HICLAW_LLM_API_KEY="sk-xxx" make install

安装选项

Section titled “安装选项”

环境变量配置

Section titled “环境变量配置”
Terminal window
# 非交互模式（使用全部默认值）
HICLAW_NON_INTERACTIVE=1 HICLAW_LLM_API_KEY="sk-xxx" make install


# 自定义端口
HICLAW_PORT_GATEWAY=8080 HICLAW_PORT_CONSOLE=8001 HICLAW_LLM_API_KEY="sk-xxx" make install


# 指定外部数据目录
HICLAW_DATA_DIR=~/hiclaw-data HICLAW_LLM_API_KEY="sk-xxx" make install


# 预设所有配置
HICLAW_LLM_PROVIDER=qwen \
HICLAW_DEFAULT_MODEL=qwen3.5-plus \
HICLAW_LLM_API_KEY="sk-xxx" \
HICLAW_ADMIN_USER=admin \
HICLAW_ADMIN_PASSWORD=yourpassword \
HICLAW_TIMEZONE=Asia/Shanghai \
make install

可配置项

Section titled “可配置项”
环境变量说明默认值
HICLAW_LLM_PROVIDERLLM 提供商qwen
HICLAW_DEFAULT_MODEL默认模型qwen3.5-plus
HICLAW_LLM_API_KEYLLM API Key（必填）
HICLAW_ADMIN_USER管理员用户名admin
HICLAW_ADMIN_PASSWORD管理员密码（自动生成）
HICLAW_PORT_GATEWAY网关端口8080
HICLAW_PORT_CONSOLE控制台端口8001
HICLAW_DATA_DIR数据目录~/hiclaw-manager

升级与重装

Section titled “升级与重装”

在已有安装上再次运行安装脚本时，会提示选择：

Choose an action:
  1) In-place upgrade (keep data, workspace, env file)
  2) Clean reinstall (remove all data, start fresh)
  3) Cancel
  • 原地升级：保留所有数据，仅重建 Manager 容器
  • 全量重装：删除所有内容，需手动确认

DNS 配置

Section titled “DNS 配置”

安装完成后，添加以下内容到 /etc/hosts：

127.0.0.1 matrix-local.hiclaw.io matrix-client-local.hiclaw.io aigw-local.hiclaw.io fs-local.hiclaw.io

访问服务

Section titled “访问服务”
服务地址说明
Element Webhttp://matrix-client-local.hiclaw.io:8080IM 客户端
Higress Consolehttp://localhost:8001网关控制台
MinIO Consolehttp://localhost:9001文件存储控制台

验证安装

Section titled “验证安装”

检查容器状态

Section titled “检查容器状态”
Terminal window
docker ps | grep hiclaw-manager

登录 Element Web

Section titled “登录 Element Web”
  1. 打开 http://matrix-client-local.hiclaw.io:8080
  2. 使用管理员账号登录
  3. Manager 会主动问候并介绍能力

创建第一个 Worker

Section titled “创建第一个 Worker”

通过 Element Web 或 CLI：

Terminal window
make replay TASK="创建一个名为 alice 的 Worker，负责前端开发，直接创建。"

常用命令

Section titled “常用命令”
Terminal window
# 发送任务给 Manager
make replay TASK="你的任务描述"


# 查看最新对话日志
make replay-log


# 卸载所有内容
make uninstall


# 清理容器和镜像
make clean

故障排查

Section titled “故障排查”

容器无法启动

Section titled “容器无法启动”

检查 Docker 日志：

Terminal window
docker logs hiclaw-manager-agent

无法访问 Element Web

Section titled “无法访问 Element Web”
  1. 确认 DNS 配置正确
  2. 检查端口是否被占用
  3. 确认容器正常运行

Manager 无响应

Section titled “Manager 无响应”
  1. 检查 LLM API Key 是否有效
  2. 查看容器日志排查错误
  3. 尝试重启容器

更多资源

Section titled “更多资源”