Agent 任务台
自托管的 Agent 系统。浏览器或微信下发任务,模型在独立工作目录里读写文件、执行命令、调用技能,产物直接回传。
快速开始
服务器
需要 Docker 与 Compose v2:
./scripts/init.sh
docker compose up -d --build
打开 http://<服务器 IP>:8090,用 admin / admin 登录,先改密码,再到「设置 → 模型」添加平台和 API Key,保存后点「重启服务」。
本机运行
macOS / Linux,Node 20+,不需要 Docker:
./local/start.sh # 后台启动
./local/stop.sh
首次运行会让你选一个工作目录(技能、会话、数据库都在里面)。命令直接在本机执行,没有沙箱隔离,只监听 127.0.0.1。
需要从外网访问时,配好 tunnel/client.yml 后 start.sh 会一并拉起隧道 client;未配置则跳过。
组成
| 目录 | 说明 |
|---|---|
app/ |
agent-core:Express + SQLite + 前端静态资源,唯一对外端口 |
executor/ |
agent-executor:隔离的命令执行、Office 预览网关 |
wxbot/ |
微信接入 |
mcp/ |
四个 MCP 服务:网页搜索、图片生成、视频生成、语音转写 |
skills/ |
内置技能 |
local/ |
本机模式启动器 |
tunnel/ |
反向隧道:把本机服务经服务器中转,供外网访问 |
device/ |
设备执行端:任意机器装上就连回来,模型可在上面跑命令、传文件 |
远端设备
把任意一台机器(Mac / Linux / Windows / OpenWrt 盒子)接进来,让模型在它上面执行命令、读写文件:
-
编译或下载
device/的二进制,和config.json放在同一个目录:{ "server": "wss://你的域名/dev/ws", "token": "<DEVICE_TOKEN>", "root": "/Users/you", "name": "mac-01" } -
直接运行(默认读同目录的
config.json,token 不会出现在ps里):./agent-device-darwin-amd64 -
服务器
.env里配同一个DEVICE_TOKEN并重启 core。
设备主动出站连接,不需要公网 IP、不需要开端口。连上后模型侧多出 device 工具:
list 看在线设备、health 看负载、exec 跑命令、pull/push 收发文件(单个 2 GiB 以内)。
盒子上的常驻用系统自带的服务管理器(systemd / procd / schtasks),细节见 device/README.md。
配置
./scripts/init.sh 首次生成 config.yml,只有 agent-core 读取。日常改动走设置页,保存后点「重启服务」。
platforms:
- name: bigmodel
url: https://open.bigmodel.cn/api/paas/v4
models:
- id: glm-5.3-flash
vision: true
keys:
- api_key: "sk-..."
端口与其余环境变量在 docker-compose.yml 里。
升级
git pull
docker compose up -d --build
数据在 data/、tasks/ 和 config.yml 里,升级不受影响。
安全
- 对外只开 agent-core 一个端口,其余服务只在 Docker 内网
- 隧道只经服务器 nginx(TLS)对外,宿主机端口仅绑
127.0.0.1;server.yml与client.yml的 token 必须一致 - 命令在 executor 容器里执行,只挂当前会话目录,根文件系统只读
- 单租户设计:除管理员接口外不做用户级资源隔离,不要开放给互不信任的人
config.yml、.env、wxbot/data/存密钥,已加入.gitignore
License
AGPL-3.0,见 LICENSE。
