入门指南

进入工作台

访问部署地址的 /app。用邮箱创建工作空间，或粘贴邀请令牌加入。默认落地为 Agent 目录。

拿到注册根令牌

Owner 在「节点」页轮换注册根凭证，复制一次性令牌。页面只长期显示前缀。

指向控制面 API

export CONTROL_PLANE_BASE_URL=http://<host>:8787

此处「控制面」指 API 基址，供 Node 上报；工作台在 /app。本机需已安装 Node.js ≥20。

npx 安装 · 注册

npx -y --package http://<host>/releases/agentory-node.tgz -- agentory-node register --token <NODE_ROOT_TOKEN> --name local

成功后写入 ~/.agentory/node.json；可用 … agentory-node version 自检。

启动 daemon（推荐）

注册一次后，一条命令常驻运行即可自动上报心跳、Agent 发现与会话/记忆索引——控制台不再依赖手动刷新。

npx -y --package http://<host>/releases/agentory-node.tgz -- agentory-node daemon

前台运行即常驻；也可 nohup … & 后台跑或做成 systemd / launchd 用户服务。仅需手动上报时可用 … heartbeat / … discover / … asset-index，或 … daemon --once 跑一轮即退（适合 cron）。

对齐配置（可选）

在 Agent 详情对 Cursor Agent 预览并确认后，节点执行（daemon 运行中会自动拉取，无需手动）：

npx -y --package http://<host>/releases/agentory-node.tgz -- agentory-node align

在 IM 里直接派活

微信、飞书、钉钉、企微四个渠道都支持。机器人接入与凭据在部署配置里完成（见部署 README 的「IM 渠道」小节），其余操作都在工作台的「IM 渠道」页。

在页面生成绑定码，私聊机器人发送 /bind <绑定码> 即完成绑定——绑定码短时效、一次性，绑定即生效。

绑定后私聊发一句话，就是给默认 Agent 派活；多个 Agent 时用 /to <Agent 名> 指定交给谁；群聊里 @ 机器人同样有效。执行结束，机器人把结果摘要回给你，附工作台链接看全文。

同一页面可随时解绑，解绑即失效。Agent 暂时不在线时消息不会丢，等它上线后会继续处理。