@aionui/agent-gateway

独立部署的 Agent Gateway，负责把不同执行后端转换为统一 WebSocket 服务，供 AionUI 或其他客户端远程接入。

功能

• WebSocket 命令入口：/ws
• 健康检查接口：/healthz
• 运行时可切换：opencode / flowise / langgraph / claude-code
• 支持远程运行目录 workspace 指定
• 支持目录白名单限制（allowedRoots）
• 支持 token 鉴权

快速启动

本地开发

pnpm install
pnpm dev -- --port 18790 --token your-token --allowed-roots /srv/projects,/data/workspaces

构建后运行

pnpm build
pnpm start -- --runtime opencode --port 18790 --token your-token --allowed-roots /srv/projects

发布后服务器一条命令运行

pnpm dlx @aionui/agent-gateway --runtime opencode --port 18790 --token your-token --allowed-roots /srv/projects

CLI 参数

• --host 监听地址，默认 0.0.0.0
• --port 监听端口，默认 18790
• --runtime 运行时类型，opencode|flowise|langgraph|claude-code，默认 opencode
• --token 连接 token（客户端需带 ?token=...）
• --allowed-roots 远程目录白名单，逗号分隔绝对路径
• --max-sessions 最大会话数，默认 30
• --idle-timeout-ms 空闲回收毫秒数，默认 1800000
• --request-timeout-ms RPC 超时毫秒数，默认 20000
• --opencode-command opencode 可执行命令，默认 opencode
• --opencode-args opencode 参数，逗号分隔，默认 acp
• --claude-code-command claude code 可执行命令，默认 claude
• --claude-code-args claude code 参数，逗号分隔，默认 --experimental-acp
• --flowise-base-url Flowise 服务地址（flowise runtime 可选默认）
• --flowise-workflow-id Flowise 默认 workflowId（flowise runtime 可选默认）
• --flowise-authorization Flowise 默认 Authorization（flowise runtime 可选默认）

环境变量

CLI 参数会覆盖同名环境变量。

• AGENT_GATEWAY_HOST
• AGENT_GATEWAY_PORT
• AGENT_GATEWAY_RUNTIME
• AGENT_GATEWAY_TOKEN
• AGENT_GATEWAY_ALLOWED_ROOTS
• AGENT_GATEWAY_MAX_SESSIONS
• AGENT_GATEWAY_IDLE_TIMEOUT_MS
• AGENT_GATEWAY_REQUEST_TIMEOUT_MS
• AGENT_GATEWAY_OPENCODE_COMMAND
• AGENT_GATEWAY_OPENCODE_ARGS
• AGENT_GATEWAY_CLAUDE_CODE_COMMAND
• AGENT_GATEWAY_CLAUDE_CODE_ARGS
• AGENT_GATEWAY_FLOWISE_BASE_URL
• AGENT_GATEWAY_FLOWISE_WORKFLOW_ID
• AGENT_GATEWAY_FLOWISE_AUTHORIZATION

WebSocket 协议

连接地址：

ws://host:port/ws?token=your-token

客户端请求格式：

{
  "action": "create_session",
  "requestId": "req-1",
  "payload": {
    "workspace": "/srv/projects/demo-repo"
  }
}

action 支持：

• create_session
• send_message
• set_model
• set_config_option
• confirm_permission
• stop_session
• list_sessions
• list_workspace
• read_file
• write_file
• create_entry
• rename_entry
• delete_entry

服务端响应格式：

{
  "type": "response",
  "requestId": "req-1",
  "success": true,
  "data": {
    "sessionId": "gateway-session-id"
  }
}

服务端事件格式：

{
  "type": "event",
  "sessionId": "gateway-session-id",
  "event": {
    "type": "acp_message",
    "payload": {}
  }
}