指南
OpenILink 更像一个小型生态,而不是单一仓库。官网负责解释整体结构和入口关系,Hub 提供更直接的平台入口,SDK 仓库承担不同运行时的接入细节,渠道仓库则指向外部集成方向。
先理解几个入口
你可以把 OpenILink 理解成四个相互配合的表面:
- 官网:
openilink.com,负责讲清结构、入口和文档。 - Hub:
hub.openilink.com,负责承接更直接的平台入口。 - SDK:6 个官方运行时仓库,负责具体接入。
- 渠道与生态:Telegram 与 OpenClaw 相关仓库,负责把能力延伸到外部场景。
核心模型
中心链路围绕 bot 接入展开:
- 完成认证并建立可用会话。
- 通过长轮询接收入站消息。
- 发出响应消息与状态更新。
- 缓存 context token 以支持主动触达。
- 在同一套传输原语之上继续叠加更高层能力。
站点结构
站点被刻意拆成几个明确区域:
https://hub.openilink.com放平台入口/guide/放概念与方向/sdk/放 6 个运行时 SDK 的统一入口/repositories放组织全部公开仓库索引/roadmap放后续方向/community放仓库和协作方式
仓库分层
目前可以把 openilink 组织理解成四层:
- 官网层:
openilink.com - 中枢层:
openilink-hub - 渠道层:
openilink-tg、openclaw-channel-openilink - SDK 层:
openilink-sdk-node、openilink-sdk-php、openilink-sdk-go、openilink-sdk-python、openilink-sdk-csharp、openilink-sdk-java
实现原则
OpenILink 偏向保持窄而清晰的起始面:
- 不同语言 SDK 尽量保持方法和流程对齐。
- 请求和响应形态优先保持直白,而不是过度抽象。
- 示例要能直接映射到真实使用场景。
- 文档结构要便于随着生态增长持续扩展。