自建本地AI Agent平台·网关常驻多Agent沙箱落地指南

自建本地 AI Agent 平台

你要的不是又一个聊天框。你要的是一个能在你自己机器上真的动手的助手:
读你的文件、跑你的命令、开浏览器、收发你已经在用的聊天软件里的消息 —— 而状态、记忆、凭证全都留在本地。

## ⚠️ 先申请你自己的 API Key
本 Skill 不内嵌任何密钥,也不代付费用。 请到
算力集市 api.a7w.cn 注册并创建你自己的 API Key
(新用户有赠送点数,可以先免费试跑几条)。
拿到后填进环境变量 A7W_API_KEY,或直接传给 --key 参数。
请勿使用他人提供的 Key —— 用量与费用都记在 Key 所属账号上。

这套东西的形态是一个常驻本机的网关,加上命令行、终端界面、浏览器控制台、桌面伴侣、
手机节点这几类客户端,默认只在回环地址上监听。

最省事的一步是模型侧:把 provider 指向 api.a7w.cn。 一个 base_url、一把 Key,
DeepSeek、通义千问、智谱 GLM、Kimi、混元、MiniMax 与 GPT 全部进同一个模型列表,
换 model 就是换模型,不用逐家注册、逐家对账。

你最关心答案
多少钱1 元 = 100 点,按实际用量扣,没有月费;平台本身在本机运行,不额外收费
要多久装好即用(分钟级);模型响应同步返回,长任务是异步任务
要装什么一个 Node 运行时(或直接用平台安装包)+ 包里自带的零依赖客户端
能用几个模型75 个在架大模型 + 21 个生成应用,同一把 Key、同一份账单
能商用吗可以。生成内容的使用与合规责任由使用者承担

一、三分钟跑通

第一步:拿到你自己的 Key

到 api.a7w.cn 注册,创建一个 API Key(形如 sk-...),填进环境变量:

export A7W_API_KEY=sk-你的key      # Windows: $env:A7W_API_KEY="sk-你的key"

第二步:先把模型侧验通(不要等平台装完再排错)

curl -sS -X POST "https://api.a7w.cn/api/v1/chat/completions" \
  -H "Authorization: Bearer $A7W_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"DeepSeek-V4-Flash","messages":[{"role":"user","content":"你好"}],"max_tokens":256}'

返回 choices[0].message.content 有内容,说明 Key、地址、模型名全对。

第三步:把平台接上这个 provider

在平台的 provider 配置里加一个 OpenAI 兼容条目:

配置项填什么
base_url / api_basehttps://api.a7w.cn/api/v1(自带 /v1 的宿主填 https://api.a7w.cn/api)
api_keysk-你的key(用环境变量注入,不要写死在配置文件里)
model例如 DeepSeek-V4-Flash;编码以线上清单为准
fallback(可选)再加一个 DeepSeek-V4-Pro 或 Qwen3.6-Plus 作主备降级
// provider 配置示意(字段名按你实际使用的平台命名)
{
  "providers": {
    "a7w": {
      "type": "openai-compatible",
      "baseUrl": "https://api.a7w.cn/api/v1",
      "apiKeyEnv": "A7W_API_KEY",
      "models": ["DeepSeek-V4-Flash", "DeepSeek-V4-Pro", "Qwen3.6-Plus", "Kimi-K2.6"]
    }
  }
}

现场拉真实模型清单,别抄文章里的模型名:

curl -sS "https://api.a7w.cn/api/v1/models" -H "Authorization: Bearer $A7W_API_KEY"

第四步:权限先收紧,再给它动手能力

平台最容易出的事不是「不能用」,而是「用过头」。放开顺序固定:

  1. 先跑通会话(只读);
  2. 再开文件读写(限定 workspace);
  3. 再开命令执行(开审批);
  4. 最后才考虑沙箱与对外暴露。

细节见 references/capabilities-and-usage.md。


二、包里有什么

sanjianke-agent-platform/
├── SKILL.md                       本文件
├── README.md
├── LICENSE.md
├── references/
│   ├── install-and-config.md       部署形态、目录端口、服务化、模型 provider 与 Key 轮换、通道与配对、远程接入、备份升级
│   ├── capabilities-and-usage.md   工具清单与档位、权限模式与沙箱、多 Agent 与绑定、记忆与定时任务、技能与插件
│   ├── extend-and-troubleshoot.md  写技能与插件、四类故障排查阶梯、升级回滚、日志与审计、卸载清理
│   ├── model-provider.md           provider 怎么填、多模型与主备降级、用量观测
│   └── general.md                  平台侧鉴权、错误码、计费口径与排错通用说明
└── scripts/
    └── a7w.py                      零依赖客户端(库 + 命令行,只用 Python 标准库)

零安装用法

export A7W_API_KEY=sk-你的key

# Key 可用性自检
python3 scripts/a7w.py whoami

# 看 21 个生成应用与各自接口
python3 scripts/a7w.py apps

# 看某个应用的接口名、参数与真实价
python3 scripts/a7w.py schema voice_tts

# 调一个接口(异步任务自动轮询到出结果)
python3 scripts/a7w.py call voice_tts tts --body '{"text":"你好,这是一段试听"}'

三、平台侧的核心概念

概念是什么为什么重要
网关 / 控制面单实例常驻进程,统一持有会话、工具、事件与通道连接一个网关就是一个信任域;多租户要一租户一个
回环监听默认只监听 127.0.0.1改变绑定范围前必须先做一次安全审计
类型化接口首帧握手 + 设备配对 + 幂等键客户端不会互相踩;重试不会重复执行副作用
工具档位minimal / messaging / coding / full决定模型能看到哪些工具;默认档位不要给 full
会话权限模式read-only / guarded / workspace / full按最小够用选:能只读就别给写
沙箱docker / podman / ssh 等后端隔离执行降低爆炸半径,不是牢不可破的边界
多 Agent每个 Agent 独立 workspace、独立目录、独立会话库人设与权限各管一摊,再用绑定把通道账号路由过去
技能 / 插件技能是指令包,插件可加工具、provider、通道、hooks扩展写不好等于给自己开后门:锁版本、走白名单

四、工作流路由

你要什么看哪份
部署形态、目录与端口、服务化常驻、模型 provider 与 Key 轮换、通道添加与配对、远程接入、备份与升级references/install-and-config.md
工具有哪些、档位怎么调、权限与沙箱怎么设、多 Agent 怎么编排、记忆与定时任务、技能与插件怎么装references/capabilities-and-usage.md
写自己的技能或插件、网关起不来、通道连不上、工具被策略挡住、模型报错、升级回滚与卸载references/extend-and-troubleshoot.md
模型 provider 怎么填、多模型与主备降级、用量观测references/model-provider.md
鉴权、错误码、计费口径references/general.md

五、常见坑

坑表现怎么避
模型 provider 地址填错层数404,报错只说连接失败OpenAI 兼容客户端填 https://api.a7w.cn/api/v1;自带 /v1 的填 https://api.a7w.cn/api
模型名抄了文章里的旧名404 / 403用 /api/v1/models 现场拉编码,逐字复制
推理模型回复是空的content 为 null、finish_reason 是 length推理模型先花 token 出思维链,max_tokens 调到 256 以上立即正常
Key 写进配置文件泄漏即余额泄漏用环境变量注入;配置文件权限收紧
一上来就开 full 档位助手能删你的文件从只读起步,逐级放开;沙箱与命令审批按需打开
把沙箱当绝对安全边界以为开了就万事大吉沙箱只是降低爆炸半径;网络策略、挂载范围、出口白名单都要自己确认
重启后配置与会话全没了数据目录每次换位置固定一个状态目录与数据卷,别在不同目录里反复重建
重复提交异步任务扣两次钱先记 task_id,用查询接口(免费)确认状态
拿 code == 0 判断成功明明成功却判成失败平台成功码是 1({"code":1,"msg":"success"})
拿 endpoint_path 字段拼 URL打不通生成类应用一律用 /api/v1/apps/<应用代号>/<接口代号>

六、计费

动作怎么算
文本对话按点数 / 百万 tokens,输入输出分别计价
图像生成按点数 / 张或分辨率档位
视频生成 / 超分按点数 / 秒(分辨率分档)
数字人按点数 / 次或时长
TTS / 音色克隆按点数 / 千字
语音转文字按点数 / 分钟
查询任务状态免费

1 元 = 100 点。 先冻结、后结算,调用失败直接退款,异步任务失败冻结点数全额退回。
每次返回的 data.usage.points_cost 就是本次真实扣费,可以直接对账。

平台同时给出标准价与租户价字段(tenant_*,平台侧报价)—— 两者都未必等于实际结算价。做预算以返回里的 data.usage.points_cost 为准;平台调价后需重新核对。


七、权限与边界

能力是否申请用途
网络访问申请调用 api.a7w.cn 的网关接口(本 Skill 唯一的联网行为)
读取文件仅读取你指定的输入文件用作素材入参
写入文件仅在传入 --out 时保存返回的 JSON 或下载产物
凭证读取你自己提供的 API Key从环境变量或 ~/.a7w/config.json 读取
子进程 / 后台常驻不申请a7w.py 执行完即退出,不注册服务、不常驻

不内嵌任何密钥。 请求只发往 api.a7w.cn,不发送到其他任何地址。

  • 不提供 Key、不代付费用:Key 必须你自己在 api.a7w.cn 申请
  • 不保证默认就安全:沙箱与审批默认关闭,对外暴露前必须自行硬化
  • 不替代合规审查:抓取、群发、消息留存与个人数据处理的合规责任在部署方
  • 不做多租户隔离:一个网关就是一个信任域,多租户要一租户一个网关

关于这个 Skill

作者亲测实操后发布,下载后可直接使用,自用商用都可以。

所有 AI 能力都走 算力集市 api.a7w.cn —— 一把 API Key 打通
大模型、语音、图像、视频、数字人等全部算力,注册即送点数,按量计费、没有月费。

你可能想问答案
要不要额外部署不用。下载本包即可使用,不必去别处找源码
怎么开始到 api.a7w.cn 注册领 Key → 填进 A7W_API_KEY → 一条命令跑起来
能不能商用可以
遇到问题找谁见文末「联系我们」,作者本人答疑

使用中碰到任何问题 —— 报错、效果不理想、想省钱、想批量 —— 都欢迎加微信聊。
加好友时说一下是从哪个 Skill 找过来的,直接给你配套的示例。


联系我们

  • 技术微信:9872659 —— 加好友时说一下是从哪个 Skill 找过来的,直接给你配套的 API Key 与能跑的示例。
  • 要算力 / 要 API Key:算力集市 · 注册领 API Key —— 一个 Key 调用全部 AI 算力,注册、充值、创建 Key 都在这里。
  • 更多 AI 插件与接口:AI 插件市场。

相关链接

链接地址说明
算力集市 · 注册领 API Keyapi.a7w.cn一个 Key 调用全部 AI 算力;注册、充值、创建 Key 都在这
AI 插件市场aigc.a7w.cn浏览全部 AI 插件与接口说明
三剪客 · 一句话批量出片ks.a7w.cn短剧二创 / 影视解说 / 矩阵号批量混剪桌面客户端
视频超清 · 在线批量超分vr.a7w.cn网页版视频超分,批量处理,最高 4K
0人公司 · AI Agent 平台a7w.cn主站,了解整套 AI Agent 生态

同类文章