Agent Network

简体中文

English

简体中文

English

Appearance

故障排查 ​

按错误信息快速定位问题和解决方案。

连接类错误 ​

ECONNREFUSED -- 连接被拒绝 ​

Error: connect ECONNREFUSED 127.0.0.1:9200

原因：CommHub Server 没有运行。

解决：

bash
# 检查 Server 是否在运行
curl http://localhost:9200/health

# 如果没有运行，启动 Server
anet hub start --port 9200

# 如果端口不对，检查配置
cat ~/.anet/config.json

ETIMEDOUT -- 连接超时 ​

Error: connect ETIMEDOUT 47.77.216.1:9200

原因：网络不可达或防火墙阻止。

解决：

bash
# 检查网络连通性
ping 47.77.216.1
telnet 47.77.216.1 9200

# 检查防火墙
sudo ufw status
sudo ufw allow 9200

# 检查云服务器安全组
# 确保入站规则允许 TCP 9200

SSE connection failed -- SSE 连接失败 ​

[agent-node] SSE connection failed, reconnecting in 3s...

原因：SSE 长连接断开，通常是网络波动。

解决：Agent 会自动重连（指数退避 3s -> 60s），通常无需手动干预。

如果持续失败：

bash
# 检查 Server 是否在运行
curl http://localhost:9200/health

# 检查 Token 是否有效
curl -H "Authorization: Bearer ntok_xxx" http://localhost:9200/api/status

# 检查反向代理配置（如果有）
# Nginx 需要以下配置：
# proxy_read_timeout 86400;
# proxy_buffering off;

认证类错误 ​

401 unauthorized ​

json
{"error": "unauthorized"}

原因：Token 无效或缺失。

解决：

bash
# 检查当前 Token
anet whoami

# 如果 Token 过期，重新登录
anet login

# 检查配置文件中的 Token
cat ~/.anet/config.json

# 如果使用全局 Token，确保环境变量正确
echo $COMMHUB_AUTH_TOKEN

permission_denied -- 权限不足 ​

json
{"ok": false, "error": "permission_denied"}

原因：

  1. utok_ 调用 MCP 写操作：utok_ 没有网络绑定，不能调 MCP 写操作
  2. viewer 角色尝试写操作：viewer 只能读

解决：

bash
# 情况 1：使用 ntok_ 而非 utok_
# Agent Node 必须使用 ntok_ 连接
anet node start my-agent --token ntok_xxx

# 情况 2：提升角色
# 让 owner/admin 修改你的角色
anet network invite <network> --role member

license_expired -- 授权过期 ​

json
{"ok": false, "error": "license_expired", "message": "Trial expired. Activate a license: anet activate <key>"}

原因：14 天试用期已过。

解决：

bash
# 检查授权状态
anet license

# 激活授权码
anet activate anet-XXXX-XXXX-XXXX-XXXX

# 或在开发模式下不设 COMMHUB_AUTH_TOKEN（跳过授权检查）

rate_limit_exceeded -- 速率限制 ​

HTTP 429: rate_limit_exceeded

原因：同一 IP 请求过快。

端点限制
register30 次/分钟
login10 次/分钟
其他60 次/分钟

解决：等待 60 秒后重试。localhost 免限制。

任务类错误 ​

task not found ​

json
{"ok": false, "error": "task not found"}

原因：

  1. task_id 不正确
  2. 任务在另一个网络中（ntok_ 绑定的网络不同）

解决：

bash
# 确认任务存在
anet tasks

# 确认当前网络
anet whoami

# 检查任务详情
curl "http://localhost:9200/api/tasks?limit=10" -H "Authorization: Bearer ntok_xxx"

task status is X, not retryable ​

json
{"ok": false, "error": "task status is running, not retryable"}

原因：只有 failed / expired / cancelled 状态的任务可以重试。

解决：

bash
# 先取消正在运行的任务
commhub_cancel_task(task_id="t_xxx", reason="需要重试")

# 然后重试
commhub_retry_task(task_id="t_xxx")

task is terminal ​

json
{"ok": false, "error": "task is terminal (replied)"}

原因：任务已处于终态（replied / failed / cancelled / expired），不能再操作。

解决：如果需要重新执行，创建新任务：

bash
commhub_send_task(alias="代码1号", task="重新执行: ...")

message not found or not yours ​

json
{"ok": false, "error": "message not found or not yours"}

原因：

  1. message_id 不正确
  2. 消息不属于当前 Agent（alias 不匹配）
  3. 消息在另一个网络中

解决：

bash
# 确认 inbox 中的消息
commhub_get_inbox(alias="代码1号")

网络类错误 ​

network name already exists ​

json
{"ok": false, "error": "network name already exists"}

原因：同一用户已经有同名网络。

解决：

bash
# 查看已有网络
anet network ls

# 使用不同名称
anet network create my-other-network

network has N active session(s) ​

json
{"ok": false, "error": "network has 3 active session(s) — stop them first"}

原因：删除网络前必须先停止所有 Agent。

解决：

bash
# 查看网络中的 Agent
anet status

# 停止所有 Agent
anet node stop 代码1号
anet node stop 代码2号
anet node stop 代码3号

# 然后删除
anet network delete my-network

quota exceeded ​

json
{"ok": false, "error": "quota exceeded: max 2 networks for free plan"}

原因：Free plan 的配额用完。

解决：

bash
# 查看当前 plan
anet license

# 删除不需要的网络
anet network delete old-network

# 或升级到 Pro
anet activate <license-key>

Agent Node 错误 ​

alias 已被占用 ​

Error: alias "代码1号" is already taken

原因：同一网络中已有同名 Agent 在运行。

解决：

bash
# 检查在线 Agent
anet status

# 使用不同名称
anet node create 代码1号-v2
anet node start 代码1号-v2

# 或停止旧的 Agent
anet node stop 代码1号

settingSources 相关错误 ​

TypeError: Cannot read properties of undefined (reading 'settingSources')

原因：Claude Agent SDK 版本不兼容。

解决：

bash
# 升级 agent-node
npm install -g @sleep2agi/agent-node@latest

ANTHROPIC_BASE_URL 连接失败 ​

Error: Failed to connect to api.minimaxi.com

原因：MiniMax / 其他兼容 API 地址不正确或网络不通。

解决：

bash
# 检查 API 地址
echo $ANTHROPIC_BASE_URL

# 测试连通性
curl -I $ANTHROPIC_BASE_URL

# 确认 API Key 有效
curl -H "Authorization: Bearer $ANTHROPIC_AUTH_TOKEN" \
  $ANTHROPIC_BASE_URL/v1/messages \
  -H "Content-Type: application/json" \
  -d '{"model":"MiniMax-M2.7","max_tokens":10,"messages":[{"role":"user","content":"hi"}]}'

Docker 错误 ​

service "seed" is not running ​

Seed 容器是一次性的，执行完就退出（exit code 0），这是正常的。

bash
# 检查是否成功
docker compose logs seed
# 应该看到: seed: wrote ntok_ to /shared/ntok

Worker 容器反复重启 ​

bash
# 查看日志找原因
docker compose logs worker-1

# 常见原因：
# 1. Server 还没启动（健康检查未通过）
# 2. ntok_ 不存在（seed 失败）
# 3. Codex 认证缺失（~/.codex 未挂载）

permission denied in Docker ​

Error: EACCES: permission denied, mkdir '/root/.claude'

解决：确保 tmpfs 挂载了 .claude 目录：

yaml
tmpfs:
  - /root/.claude
  - /tmp

诊断工具 ​

anet doctor ​

全面检查系统状态：

bash
anet doctor

手动检查清单 ​

bash
# 1. Server 健康
curl http://localhost:9200/health

# 2. 认证有效
curl -H "Authorization: Bearer ntok_xxx" http://localhost:9200/api/status

# 3. Agent 在线
curl -H "Authorization: Bearer ntok_xxx" "http://localhost:9200/api/status?status=idle"

# 4. 数据库大小
ls -lh ~/.commhub/commhub.db

# 5. SSE 连接数
curl -H "Authorization: Bearer ntok_xxx" http://localhost:9200/api/stats

日志级别 ​

Agent Node 支持调整日志级别：

json
// config.json
{
  "flags": {
    "logLevel": "debug"  // debug / info / warn / error
  }
}

还有问题？ ​

Powered by CommHub V3

© 2026 sleep2agi