跳转到主要内容

​
常见问题

这里放快速答案。正在故障排查时，先看 Troubleshooting、Diagnostics 和 Gateway Troubleshooting。

​
出问题时的前 60 秒

先运行： 
fased status
fased status --all
fased gateway probe
fased gateway status
fased doctor
fased logs --follow
然后打开对应 owner 页面：
  • Agent > Models：模型和 provider。
  • Agent > Channels：聊天路由。
  • Agent > Services：外部 API。
  • Agent > Skills / Tools：运行能力。
  • Agent > Memory：memory/QMD/session-memory。
  • Agent > Tasks：保存的任务定义和运行记录。
  • Wallets、Mining、Fased Network：钱包、挖矿、网络状态。

​
卡住时最快怎么排查？

  1. 运行 fased status --all。
  2. 打开 Logs，按失败子系统过滤。
  3. 先看对应 owner 页面，不要直接改 raw config。
  4. 运行 fased doctor。
  5. 渠道问题运行 fased channels status --probe。
钱包、挖矿、网络问题： 
fased wallet status --json
fased wallet signer doctor --json
fased mining readiness --wallet mining
fased mining status --json
fased federation status --json

​
安装和首次运行

​
推荐安装流程是什么？

使用 Getting Started：
  1. 安装。
  2. 运行 onboarding。
  3. 打开 Control UI。
  4. 配置模型 provider。
  5. 发送第一条 chat。
  6. 需要时再添加 channels、skills、tasks、wallets、mining 或 Fased Network。

​
Onboarding 做什么？

Onboarding 创建基础运行时：state directory、config、workspace、Gateway、 dashboard access，以及可选的钱包/挖矿初始设置。 它不会配置所有模型、渠道、技能、任务、服务、钱包或网络角色。基础运行时正常后，在 Control UI 中继续设置。

​
如何打开 dashboard？

fased dashboard
fased gateway status

​
安装程序卡住时怎么拿到更多信息？

fased status
fased doctor
fased logs --follow
再根据平台看 Install。

​
模型和 Provider

​
需要订阅或 API key 吗？

需要至少一个可用模型路径：API key、OAuth profile、支持的 subscription-backed CLI path，或本地模型 endpoint。 在 Agent > Models 配置。

​
推荐什么模型？

给 tool-enabled Agent 使用可靠、强指令跟随模型。小模型或本地模型可以使用，但应减少工具权限并启用 sandbox。

​
All models failed 是什么意思？

常见原因：
  • 没有对应 provider/profile 凭证；
  • model ref 不在允许列表；
  • provider quota/account 问题；
  • 网络/API 失败；
  • fallback model 也没有凭证。
先看 Agent > Models，再看 Model Failover。

​
Channels 和回复

​
Fased 不回复时检查什么？

fased gateway status
fased channels status --probe
fased pairing list --channel <channel>
fased logs --follow
常见原因：
  • sender 未 pairing 或 allowlist；
  • group 需要 mention；
  • channel token/account 未 ready；
  • Agent route 错误；
  • Gateway auth/URL 不匹配。

​
Tasks 和自动化

​
Fased 能按计划运行任务吗？

可以。Task 是 Agent/session 拥有的保存定义，run 是历史记录。 
fased task list
fased task run <task-id>

​
Tasks 不触发怎么办？

检查：
  • Agent > Tasks 里有保存的 Task；
  • Task 没有暂停；
  • Gateway/worker 正在运行；
  • model/skill/service preflight 通过；
  • delivery target 仍然存在；
  • Logs 没有 queue 或 stale lease 错误。

​
Wallets、Mining 和 Fased Network

​
应该读哪些文档？

​
钱包怎么分？

尽量按角色拆分：
  • Agent wallet：普通 Agent 钱包动作。
  • Mining wallet：SAT mining。
  • Vault/bond wallet：bond/operator inventory。

​
挖矿提交为什么低于 target？

实际提交会被 usable miner capital、locked/pending capital、fee reserve、erosion coverage 和 recovery buffer 限制。资本正在清理或 fee headroom 改变时，较低提交可能是正常保护行为。

​
Memory、文件和备份

​
Fased 的数据存在哪里？

默认 state 在 ~/.fased。 常见路径：
  • ~/.fased/fased.json
  • ~/.fased/credentials/
  • ~/.fased/agents/<agentId>/sessions/
  • ~/.fased/workspace
  • ~/.fased/extensions/
  • ~/.fased/sandboxes/

​
推荐怎么备份？

私密备份 Agent workspace。不要把 ~/.fased/credentials、auth profiles、 secrets 和 sessions 放到公开 repo。迁移机器时按需复制 state，并用 fased status 验证路径。

​
Config 和 Environment

​
环境变量和 .env 加载

见 Environment Variables。

​
Fased 如何加载环境变量？

优先级：
  1. process environment；
  2. 当前目录 .env；
  3. ~/.fased/.env；
  4. config env block；
  5. 可选 login-shell import。
Fased 不覆盖已有值。

​
Remote Gateway 和 Nodes

​
Gateway 应该本地还是远程？

首次设置本地最简单。需要常驻时可以远程/VPS。原始 Gateway 访问应保持私有，使用 Tailscale/SSH 或 trusted proxy。

​
Node 会运行 Gateway 吗？

Node 是 paired execution/device surface。Gateway 仍然是控制平面。Node pairing 应视为该设备的 operator 级访问。

​
Security

​
是否应该开放 inbound DMs？

使用 pairing 或 allowlists。除非明确知道受众并有严格 tool policy，不要给 tool-enabled Agent 开放 inbound DMs。

​
Prompt injection 只影响 public bots 吗？

不是。网页、邮件、文件、日志、图片或粘贴文本都可能携带对抗性指令。使用 access control、tool policy、sandboxing 和现代模型，不要只依赖 prompt 文案。 见 Gateway Security。

​
更多帮助