[agent/embedded] embedded run agent end: runId=06439cd0-5d30-4656-975b-4bb943796765 isError=true error=503 status code (no body)

[chenglongxie]

Bug Description

[agent/embedded] embedded run agent end: runId=06439cd0-5d30-4656-975b-4bb943796765 isError=true error=503 status code (no body)
在hiclaw-manager中能访问通openai的自建模型服务

Steps to Reproduce

AI Analysis

No response

Relevant Logs

Component

Manager Agent

Version / Commit

No response

[johnlanni]

感谢反馈！

根据错误信息 embedded run agent end: isError=true error=503 status code (no body)，这与 FAQ 中的 "在房间里和 Manager 聊天没有响应或返回错误状态码" 高度匹配。

503 错误通常表示容器内网络环境问题，导致 LLM 服务不可达。

排查步骤

1. 检查 Higress AI 网关日志

docker exec -it hiclaw-manager cat /var/log/hiclaw/higress-gateway.log

在日志中搜索 503，关注 upstream_host 字段：

• 如果有值 → 请求已到达后端，异常来自上游服务
• 如果为空 → Higress 无法路由请求

2. 确认模型服务可达性

你说在容器内可以访问 OpenAI 的自建模型服务，请确认：

# 进入容器测试
docker exec -it hiclaw-manager bash
curl -v http://<your-model-endpoint>/v1/models

确保这个地址和 Higress AI Route 中配置的地址一致。

3. 检查 AI Route 配置

打开 Higress 控制台 http://localhost:18001，检查 AI Management → AI Routes 中 default-ai-route 的配置是否正确指向你的自建模型服务。

---

更多常见问题请参考 FAQ 文档

项目地址：alibaba/hiclaw
注意：仓库已迁移到 alibaba/hiclaw

---

Thanks for the feedback!

According to the error message embedded run agent end: isError=true error=503 status code (no body), this is highly consistent with "Chatting with the Manager in the room does not respond or returns an error status code" in the FAQ.

**503 errors usually indicate network environment problems within the container, causing the LLM service to be unreachable. **

Troubleshooting steps

1. Check Higress AI gateway logs

docker exec -it hiclaw-manager cat /var/log/hiclaw/higress-gateway.log

Search the logs for 503, focusing on the upstream_host field:

• If there is a value → the request has reached the backend and the exception came from the upstream service
• If empty → Higress cannot route the request

2. Confirm model service reachability

You said that OpenAI's self-built model service can be accessed in the container, please confirm:

# Enter container testing
docker exec -it hiclaw-manager bash
curl -v http://<your-model-endpoint>/v1/models

Make sure this address is consistent with the address configured in Higress AI Route.

3. Check AI Route configuration

Open the Higress console http://localhost:18001 and check whether the configuration of default-ai-route in AI Management → AI Routes correctly points to your self-built model service.

---

For more frequently asked questions, please refer to FAQ document

Project address: alibaba/hiclaw
Note: The warehouse has been moved to alibaba/hiclaw

[chenglongxie]

安装完成后生成的自定义 OpenAI 服务在服务来源菜单中并没有这条记录

[hiclaw@localhost ~]$ bash install.sh

========================================
HiClaw Installation Log
Started: Wed Apr 1 08:05:27 CST 2026
User: hiclaw
System: Linux localhost.localdomain 3.10.0-1160.an7.x86_64 #1 SMP Thu Oct 14 16:04:36 CST 2021 x86_64 x86_64 x86_64 GNU/Linux
Log file: /home/hiclaw/hiclaw-install.log

[HiClaw] === HiClaw Manager 安装 ===
[HiClaw] 镜像仓库: harbor.bigdata.com
[HiClaw]
[HiClaw] 安装目录: /home/hiclaw
[HiClaw] （env 文件 'hiclaw-manager.env' 将保存到 HOME 目录。）
[HiClaw] （请从您希望管理此安装的目录运行此脚本。）
[HiClaw]
[HiClaw] 检测到语言 / Detected language: 中文
[HiClaw] 切换语言 / Switch language:

1. 中文
2. English

请选择 / Enter choice [1]: 1
[HiClaw]
[HiClaw] （输入 b 返回上一步）
[HiClaw] --- Onboarding 模式 ---

选择安装模式:

1. 快速开始 - 使用阿里云百炼快速安装（推荐）
2. 手动配置 - 选择 LLM 提供商并自定义选项

请选择 [1/2]: 2
[HiClaw] 已选择手动配置模式 - 您将选择 LLM 提供商并自定义选项
[HiClaw]
[HiClaw] （输入 b 返回上一步）
[HiClaw] 正在查询最新稳定版本...
[HiClaw] 无法查询 GitHub，使用内置版本 v1.0.8
[HiClaw] --- 版本选择 ---

选择要安装的版本:

1. latest - 最新版（默认）
2. v1.0.8 - 最新稳定版
3. 自定义 - 手动输入版本号（如 v1.0.5）

请选择 [1/2/3] [1]: 1
[HiClaw] 已选择最新版 (latest)
[HiClaw]
[HiClaw] （输入 b 返回上一步）
[HiClaw] --- LLM 配置 ---

可用 LLM 提供商:

1. 阿里云百炼 - 推荐中国用户使用
2. OpenAI 兼容 API - 自定义 Base URL（OpenAI、DeepSeek 等）

选择提供商 [1/2]: 2
[HiClaw] 提供商: openai-compat（OpenAI 兼容）

Base URL（例如 https://api.openai.com/v1）: http://10.110.177.100:3000
默认模型 ID [gpt-5.4]: Qwen3-30B-I
[HiClaw] Base URL: http://10.110.177.100:3000
[HiClaw] 模型: Qwen3-30B-I

[HiClaw] ⚠️ 模型 'Qwen3-30B-I' 不在内置模型列表中，请配置模型参数:

最大上下文长度（token 数）[150000]:
最大输出长度（token 数）[128000]:
是否支持推理/思考模式？[Y/n]: Y
是否支持图片输入？[y/N]: N
[HiClaw] 自定义模型参数: 上下文=150000, 最大输出=128000, 推理=true, 图片=false
[HiClaw]
LLM API Key:
[HiClaw] 正在测试 API 联通性...
[HiClaw] ✅ API 联通性测试通过
[HiClaw]
[HiClaw] （输入 b 返回上一步）
[HiClaw] --- 管理员凭据 ---
管理员用户名 [admin]:
管理员密码（留空自动生成，最少 8 位）:
[HiClaw]
[HiClaw] （输入 b 返回上一步）
[HiClaw] --- 网络访问模式 ---

1. 仅本机使用，无需开放外部端口（推荐）
2. 允许外部访问（局域网 / 公网）

请选择 [1/2]: 2
[HiClaw] 端口已绑定到所有网络接口（0.0.0.0）

⚠️ 建议在 Higress 控制台配置 TLS 证书并启用 HTTPS，避免明文传输。
[HiClaw] （输入 b 返回上一步）
[HiClaw] --- 端口配置（按回车使用默认值）---
网关主机端口（容器内 8080） [18080]:
Higress 控制台主机端口（容器内 8001） [18001]:
Element Web 直接访问主机端口（容器内 8088） [18088]:
OpenClaw 控制台主机端口（容器内 18888） [18888]:
[HiClaw]
[HiClaw] （输入 b 返回上一步）
[HiClaw] --- 域名配置（按回车使用默认值）---
[HiClaw] 提示: 自定义域名前必须事先做好 DNS 解析。单机 ECS 部署时无需修改 aigw、fs 等域名；Element Web 和 Matrix Server 也可通过 IP 直接访问。
Matrix 域名 [matrix-local.hiclaw.io:18080]:
Element Web 域名 [matrix-client-local.hiclaw.io]:
AI 网关域名 [aigw-local.hiclaw.io]:
文件系统域名 [fs-local.hiclaw.io]:
OpenClaw 控制台域名 [console-local.hiclaw.io]:
[HiClaw]
[HiClaw] （输入 b 返回上一步）
[HiClaw] --- GitHub 集成（可选，按回车跳过）---
GitHub 个人访问令牌（可选）:
[HiClaw] （输入 b 返回上一步）
[HiClaw]
[HiClaw] --- Skills 注册中心（可选，按回车使用默认 https://skills.sh）---
Skills 注册中心 URL（留空使用默认 https://skills.sh）:
[HiClaw]
[HiClaw] （输入 b 返回上一步）
[HiClaw] --- 数据持久化 ---
Docker 卷名称 [hiclaw-data]:
[HiClaw] 使用 Docker 卷: hiclaw-data
[HiClaw] （输入 b 返回上一步）
[HiClaw] --- Manager 工作空间 ---
Manager 工作空间目录 [/home/hiclaw/hiclaw-manager]:
[HiClaw] Manager 工作空间: /home/hiclaw/hiclaw-manager
[HiClaw] （输入 b 返回上一步）
[HiClaw] --- 默认 Worker 运行时 ---

1. OpenClaw（Node.js 容器，~500MB 内存）
2. CoPaw（Python 容器，~150MB 内存，默认关闭控制台，可跟 Manager 对话按需开启）

请选择 [1/2]: 2
[HiClaw] 默认 Worker 运行时: copaw
[HiClaw] （输入 b 返回上一步）
[HiClaw]
[HiClaw] --- Matrix 端到端加密（E2EE）---

E2EE 会对 Manager 与 Worker 之间的 Matrix 消息进行端到端加密。
启用后，即使 Matrix 服务器被入侵，消息内容也无法被窃取。
但 E2EE 会增加首次握手耗时，且要求所有 Agent 都支持 matrix-sdk-crypto。
如果不确定，建议保持禁用。
⚠ 注意：禁用 E2EE 后，请勿在 Element 上创建默认启用加密的 Private 房间，
否则 Agent 将无法读取该房间中的加密消息。请改用 Public 房间或关闭房间加密。

1. 禁用 E2EE（推荐）
2. 启用 E2EE

请选择 [1/2]: 1
[HiClaw] Matrix E2EE: 已禁用（默认）
[HiClaw] （输入 b 返回上一步）

--- Docker API 安全代理 ---

Docker API 代理可防止 AI Agent 通过 Docker API 越狱访问宿主机。
启用后，Manager 不再直接持有 Docker socket，所有容器操作经过安全校验。

1. 启用（推荐）
2. 禁用（直接挂载 Docker socket）

[HiClaw] Docker API 代理: 已启用

默认放行的镜像来源：本地镜像、localhost、Higress 仓库（所有 region）。
如需放行其他镜像仓库，请输入逗号分隔的地址前缀。
示例: ghcr.io/myorg,registry.example.com/team

额外放行的镜像来源（按回车跳过）: harbor.bigdata.com
[HiClaw] （输入 b 返回上一步）
Worker 空闲自动停止超时（分钟）[720]:
[HiClaw] Worker 空闲超时: 720 分钟
[HiClaw] （输入 b 返回上一步）
与 Agent 共享的主机目录（默认: /home/hiclaw）:
[HiClaw]
[HiClaw] 正在生成密钥...
[HiClaw] 配置已保存到 /home/hiclaw/hiclaw-manager.env
[HiClaw] 容器运行时 socket: /var/run/docker.sock（已启用直接创建 Worker）
[HiClaw] 共享主机目录: /home/hiclaw -> 容器内 /host-share
[HiClaw] 正在拉取 Manager 镜像: harbor.bigdata.com/higress/hiclaw-manager:latest
latest: Pulling from higress/hiclaw-manager
Digest: sha256:b3ed81055add4751afcd105ceb4c1a918acef2abded2172478a5076da9c633b1
Status: Image is up to date for harbor.bigdata.com/higress/hiclaw-manager:latest
harbor.bigdata.com/higress/hiclaw-manager:latest
[HiClaw] 正在拉取 Worker 镜像: harbor.bigdata.com/higress/hiclaw-copaw-worker:latest
latest: Pulling from higress/hiclaw-copaw-worker
Digest: sha256:79cd5c5d29cbde1c5aa031930ad83c28031a8a585ac1e8f4dc273d7cfe8151bd
Status: Image is up to date for harbor.bigdata.com/higress/hiclaw-copaw-worker:latest
harbor.bigdata.com/higress/hiclaw-copaw-worker:latest
[HiClaw] 正在启动 Manager 容器...
[HiClaw] Starting Docker API proxy...
a0f3374c7d55ffd7c4535fc478a885df07e1d8c8d7d26b186b358ef5d97025f2
2e7292cd0bed6af9034c69b00dd76b8b1ce7fa59fb60454a010b8ee0a19f5a05
[HiClaw] 等待 Manager Agent 就绪（超时: 300s）...
[HiClaw] 等待中... (85s/300s)[HiClaw] Manager Agent 已就绪！
[HiClaw] 等待 Matrix 服务就绪（超时: 300s）...
[HiClaw] Matrix 服务已就绪！
[HiClaw]
[HiClaw] === HiClaw Manager 已启动！===
[HiClaw]
[HiClaw] 以下域名已配置解析到 127.0.0.1:
[HiClaw] matrix-local.hiclaw.io matrix-client-local.hiclaw.io aigw-local.hiclaw.io fs-local.hiclaw.io console-local.hiclaw.io
[HiClaw]
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
★ 在浏览器中打开以下 URL 开始使用: ★

http://127.0.0.1:18088/#/login
                                                                             
登录信息:
    用户名: admin
    密码: Xmz@323!
                                                                             
登录后，开始与 Manager 聊天！
    告诉它: "创建一个名为 alice 的前端开发 Worker"
    Manager 会自动处理一切。

─────────────────────────────────────────────────────────────────────────────
📱 移动端访问（FluffyChat / Element Mobile）:

    1. 在手机上下载 FluffyChat 或 Element
    2. 设置 homeserver 为: http://10.110.177.107:18080
    3. 登录信息:
              用户名: admin
              密码: Xmz@323!

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
[HiClaw]
[HiClaw] --- 其他控制台 ---
[HiClaw] Higress 控制台: http://localhost:18001（用户名: admin / 密码: Xmz@323!）
[HiClaw] OpenClaw 控制台（本地）: http://localhost:18888（无需登录）
[HiClaw] OpenClaw 控制台（网关）: http://console-local.hiclaw.io（用户名: admin / 密码: Xmz@323!）
[HiClaw]
[HiClaw] --- 切换 LLM 提供商 ---
[HiClaw] 您可以通过 Higress 控制台切换到其他 LLM 提供商（OpenAI、Anthropic 等）。
[HiClaw] 详细说明请参阅:
[HiClaw] https://higress.ai/en/docs/ai/scene-guide/multi-proxy#console-configuration
[HiClaw]
[HiClaw] 提示: 您也可以在聊天中让 Manager 为您配置 LLM 提供商。
[HiClaw]
⚠️ 建议在 Higress 控制台配置 TLS 证书并启用 HTTPS，避免明文传输。
[HiClaw]
[HiClaw] 配置文件: /home/hiclaw/hiclaw-manager.env
[HiClaw] 数据卷: hiclaw-data
[HiClaw] Manager 工作空间: /home/hiclaw/hiclaw-manager