@alfe.ai/门路
本地网关守护进程 Alfe —— 代理 VM 之间的常有控制平面, 它的运行时间,和阿尔费云.
概览
网关守护进程是一个独立的节点.js进程:
- 与 Alfe 云保持持久的 WebSocket 连接(
@alfe/gateway-service(关于Fly.io) - 显示 Unix 套接字
~/.alfe/gateway.sock用于本地插件 IPC - 从全云快照调试集成和状态化的运行时配置
- 监督所选运行时间( E)
openclaw, (中文(简体) ),hermes,或claude-code(中文(简体) ) - 托管本地 AI 代理和 MCP 捆绑器
- 幸存时间重新启动并报告生命周期/健康回云
建筑
Alfe Cloud ←—— control WS ——→ @alfe.ai/gateway (daemon)
├── runtime supervisor → OpenClaw/Hermes/Claude host
├── integration reconciliation
├── local AI proxy + MCP bundler
└── IPC (~/.alfe/gateway.sock) ← runtime plugins/CLI
先决条件
- 运行
alfe setup(或有管理地提供)配置代理身份 - 节点.js 22+
- 小时
使用量
通过 alfe CLI(建议)
# Start daemon (foreground)
alfe gateway start
# Check status
alfe gateway status
# Stop daemon
alfe gateway stop
# Install as system service (auto-start on boot)
alfe gateway install
# Remove system service
alfe gateway uninstall
# View logs
alfe gateway logs
# Full health check
alfe doctor
通过独立二进制
# Start daemon in foreground
alfe-gateway start
# Status
alfe-gateway status
# Stop
alfe-gateway stop
IPC 议定书
插件连接到 ~/.alfe/gateway.sock 并说新线限制 JSON:
请求( 插件 ) — 守护进程)
{ "type": "req", "id": "uuid", "method": "register", "params": { "name": "my-plugin", "version": "1.0.0", "protocolVersion": 1, "capabilities": ["integrations"] } }
响应( 守护程序 ) – 插件
{ "id": "uuid", "ok": true, "payload": { "status": "registered", "daemonVersion": "<current CLI version>", "protocolVersion": 1 } }
事件( 守护- 插件)
{ "type": "event", "event": "cloud.status", "payload": { "connected": true } }
现行方法
| 方向 | 方法 | 说明 |
|---|---|---|
| 守护进程- 缓冲 | runtime.activity | 测试在计划重启之前是否有聊天转机 |
| 插件 – 守护程序 | register | 用守护进程注册插件 |
| 插件 – 守护程序 | status | 获取守护进程健康状况 |
| 插件 – 守护程序 | integration.list | 列出已知的整合 |
| 插件 – 守护程序 | integration.report | 报告整合状况 |
| 插件 – 守护程序 | mcp.list_tools 编号 : mcp.call_tool | 检查或引用捆绑的MCP工具 |
| 插件 – 守护程序 | mcp.list_servers 编号 : mcp.add_server 编号 : mcp.remove_server | 管理本地 MCP 服务器 |
IPC是只拥有者,新线限定的JSON. 请求必须包含非空
id编号 :method 字段和对象 params; 单个信件封顶于
1个米B.
文件位置
| 文件 | 路径 |
|---|---|
| 配置 | ~/.alfe/config.toml |
| 套接字 | ~/.alfe/gateway.sock |
| PID 文件 | ~/.alfe/gateway.pid |
| 日志 | ~/.alfe/logs/gateway.log |
| 已启动列表 | ~/Library/LaunchAgents/ai.alfe.gateway.plist |
| 系统化单元 | ~/.config/systemd/user/alfe-gateway.service |
| 系统环境管理 | ~/.alfe/gateway.env (或 /etc/alfe/gateway.env 用于根) |
警卫
- 套接字文件为
chmod 0600(仅限所有者使用) - PID 所有权在发送信号前与实时进程命令进行校验
- 管理下的系统化证书只保存在所有人(
0600) 环境文件,而不是单位文本 - 证书碎片从未被记录
- Auth 使用来自所管理环境的代理 API 密钥或
~/.alfe/config.toml
发展
# From monorepo root
pnpm install
pnpm --filter @alfe.ai/gateway build
pnpm --filter @alfe.ai/gateway test
pnpm --filter @alfe.ai/gateway lint
pnpm --filter @alfe.ai/gateway typecheck
# Dev mode (auto-restart on changes)
pnpm --filter @alfe.ai/gateway dev
云协议
守护进程使用云网关服务表达以下消息类型:
| 方向 | 消息 | 说明 |
|---|---|---|
| 出境 | SERVICE_REGISTER | 用云注册守护进程 |
| 入境 | SERVICE_ACK | 云确认注册 |
| 入境 | COMMAND | 云发出命令执行 |
| 出境 | COMMAND_ACK | 守护进程报告命令结果 |
| 入境 | DESIRED_STATE | 云能推动理想的融合状态 |
| 出境 | RECONCILIATION_REPORT | 守护进程报告调节结果 |
| 出境 | COMMANDS_AVAILABLE | 守护进程发布整合命令 |
| 入境 | PING | 云心跳动 |
| 出境 | PONG | 守护进程心跳响应 |
DESIRED_STATE 是一个原子,可以删除的快照。 守护进程验证
当一行形状不正确时,每个嵌入的条目都会拒绝整个框架
已复制。 如果本地化状态无法实现, 它也会跳过所有突变
读取。 见 src/protocol.ts, (中文(简体) ), src/reconciliation.ts,以及 DEVELOPING.md 联 合 国
正式合同.