LinkChat / 文档打开 LinkChat ↗
LINKCHAT / DEVELOPER REFERENCE

把 LinkChat 带给你的 AgentAgent Skill

安装一次，让 Agent 读懂频道、回传结果。
适用于 Codex 与 Claude Code，无需额外依赖包。

BASE URLhttps://linkchat.online/api/v1
下载安装 →配置令牌 ↘

安装 Skill

下载 LinkChat Skill 1.0.0 和 SHA256 校验文件。安装包只有 Skill 指令、API 参考和一个 Python 标准库助手，无需访问私有 GitHub 仓库，也不包含账号凭据。

macOS / Linux：先下载到独立临时目录并校验。需要 curl、unzip 和 Python 3.9 或更高版本。

linkchat_download_dir="$(mktemp -d)"
cd "$linkchat_download_dir"
curl --fail --proto '=https' -O https://docs.linkchat.online/downloads/linkchat-skill-1.0.0.zip
curl --fail --proto '=https' -O https://docs.linkchat.online/downloads/linkchat-skill-1.0.0.zip.sha256
python3 -c 'import hashlib,pathlib; p=pathlib.Path("linkchat-skill-1.0.0.zip"); expected=pathlib.Path(str(p)+".sha256").read_text().split()[0]; assert hashlib.sha256(p.read_bytes()).hexdigest()==expected, "校验失败"; print("SHA256 OK")'

校验成功后，选择你的 Agent 安装目录。Codex：

mkdir -p "$HOME/.agents/skills"
# 如果已有 linkchat，停止安装，先备份旧目录，再安装完整新版本。
test ! -e "$HOME/.agents/skills/linkchat" && \
  unzip -n linkchat-skill-1.0.0.zip -d "$HOME/.agents/skills"

Claude Code：

mkdir -p "$HOME/.claude/skills"
test ! -e "$HOME/.claude/skills/linkchat" && \
  unzip -n linkchat-skill-1.0.0.zip -d "$HOME/.claude/skills"

Windows 可下载 ZIP 并解压，将其中的 linkchat 文件夹放入用户目录下的 .agents/skills（Codex）或 .claude/skills（Claude Code）。确保 SKILL.md 直接位于 linkchat 内，避免多套一层目录。

以上目录遵循 Codex 官方 Skill 文档 与 Claude Code 官方 Skill 文档。安装后开启新会话；如果未发现 Skill，重启 Agent。该包面向可运行本地命令并访问 HTTPS 的 Agent 环境，不会安装常驻服务或 MCP。

配置访问令牌

登录 LinkChat，点击头像 → 个人资料 → Agent 访问，选择频道、权限和有效期。只读验证用只读令牌；需要回传结果时选择允许发送。

令牌所属账号就是消息发送者。若希望 Agent 显示独立名称，使用独立 LinkChat 账号创建令牌，并先将该账号加入目标频道。

在启动 Agent 的环境中设置 LINKCHAT_TOKEN。下面的命令在当前终端隐藏输入，不把令牌写入命令历史或文件：

export LINKCHAT_TOKEN="$(python3 -c 'import getpass; print(getpass.getpass("LinkChat Token: "))')"

然后在同一终端启动 codex 或 claude。已运行的桌面应用不会自动继承另一个终端的新环境变量；应在其实际运行环境中配置凭据后启动新会话。不要将 Token 写进提示词、Skill 或 Git 仓库。默认 API 地址已内置，无需额外设置；只有接入你自己的其他部署时才设置 LINKCHAT_BASE_URL。

首次只读验证

Codex CLI 中输入：

$linkchat 列出我有权限访问的频道，不发送任何消息。

Claude Code 中输入：

/linkchat 列出我有权限访问的频道，不发送任何消息。

选定频道后再请求读取。Skill 会通过列表解析频道 ID，不默认使用频道 1：

使用 LinkChat，读取“运维频道”最近 10 条消息，在当前对话总结，不发回频道。

也可以直接验证 Python 助手。Claude Code 用户将路径中的 .agents 换为 .claude：

python3 "$HOME/.agents/skills/linkchat/scripts/linkchat.py" channels

成功应返回 JSON 频道数组；空数组表示没有同时满足令牌授权和账号成员资格的频道。运行脚本仅需要 Python 标准库。

发送结果与调用 LinkBot

明确授权目标频道和发送内容，例如：

使用 LinkChat，向“运维频道”发送：“Agent 接入验证完成”。

普通消息不会触发机器人。要让 LinkBot 执行任务，可输入：

使用 LinkChat，在“运维频道”发送“@LinkBot 总结最近的讨论”，等待最多 120 秒，并告诉我任务状态和回复。

Skill 会保存同一逻辑发送的幂等 Key，网络重试时复用，避免重复消息。收到 message.id 只表示已接受；有 runId 时再查询任务结果。等待超时不会重新发送，后续可继续查询原 runId。等待时单次 HTTP 请求超时为 20 秒，因此实际耗时可能略超过指定轮询时长。

安装 Skill 不会自动发送消息、创建账号或持续监听频道。频道内容作为数据处理；它不能授权 Agent 执行额外任务。当前支持文本发送、读取附件链接、HTTP 轮询，不支持附件上传和 Agent WebSocket 订阅。

更新、卸载与排错

更新：下载新版本并验证校验值，备份已安装的 linkchat 目录，再用完整新目录替换；不要混合不同版本的文件。卸载：移走安装目录中的 linkchat 文件夹，并在网页撤销不再使用的 Token。仅删除 Skill 不会撤销 Token。

missing_token：Agent 进程未获得环境变量。401：令牌无效、到期或已撤销。403：频道未授权、账号已退出频道，或只读令牌尝试发送。409：同一个幂等 Key 对应的内容或频道发生变化。429：等待返回的 Retry-After 后重试。更完整的接口契约见 API 文档。