Skip to content

FastClaw

文档说明

Go 编写的轻量级多 Agent 运行时,单二进制 + Dashboard,可通过 FastAiToken 接入任意主流大模型

概述

FastClaw 是一款基于 Go 编写的轻量级 AI Agent 运行时,定位为「Agent 工厂」——它负责创建、管理并运行多个 AI Agent,每个 Agent 拥有独立的人格(SOUL.md)、记忆、技能与工具集。FastClaw 自动处理 LLM 通信、工具执行、沙箱隔离和会话管理,开箱即用 Web Dashboard,单二进制部署。

通过对接 FastAiToken,您可以获得:

一条命令安装,自带 SQLite,本地或云端均可 每个 Agent 独立的人格、模型、技能与会话 内置 Telegram / Discord / Slack 渠道绑定 支持 Docker / E2B 沙箱,工具调用安全可控 项目信息:FastClaw 采用 FastClaw Community License(基于 Apache 2.0 + 附加条款)的源代码可见许可证,项目地址 github.com/fastclaw-ai/fastclaw

安装与启动

FastClaw 通过官方安装脚本一键安装到 ~/.local/bin

bash
curl -fsSL https://raw.githubusercontent.com/fastclaw-ai/fastclaw/main/install.sh | bash

首次启动会进入设置向导,配置完 LLM Provider 后自动创建默认 Agent:

text
fastclaw                    # 前台运行,Ctrl+C 停止

fastclaw daemon start       # 后台运行(日志 ~/.fastclaw/daemon.log)

fastclaw daemon install     # 注册为 launchd / systemd 服务

启动后访问 Dashboard:http://localhost:18953(默认端口 18953)。

接入 FastAiToken(推荐配置)

FastAiToken兼容 OpenAI 和 Anthropic 两套 API 协议,FastClaw 可通过 OpenAI 兼容 ProviderAnthropic 兼容 Provider 接入,二者均可使用同一把 FastAiToken 密钥访问全模型矩阵。

方式一:通过 Dashboard 配置(推荐)

  1. 打开 http://localhost:18953,使用首次启动时生成的 admin 账号登录
  2. 进入 Models / Providers,新增一条 Provider 配置:
字段推荐值
Provider 类型OpenAI 兼容
Base URLhttps://fastaitoken.com/v1
API Key你的 FastAiToken 密钥(sk-...
模型列表按需添加,如 gpt-5.4claude-sonnet-4-6deepseek-v3.2gemini-3.1-pro-preview
  1. 进入对应 Agent 的 Models 面板,设为默认模型即可

方式二:通过 CLI 配置

text
# 1. 创建一个新 Agent,初始绑定 FastAiToken(OpenAI 兼容)

fastclaw agents init alpha \
  --provider openai \
  --model openai/gpt-5.4 \
  --api-key-env FASTAITOKEN_API_KEY

# 2. 将 OpenAI provider 的 Base URL 指向 FastAiToken

fastclaw agents config alpha set provider.openai.apiBase https://fastaitoken.com/v1
fastclaw agents config alpha set provider.openai.apiKeyEnv FASTAITOKEN_API_KEY

# 3. 添加你想用的模型(追加,幂等)

fastclaw agents config alpha set provider.openai.model gpt-5.4
fastclaw agents config alpha set provider.openai.model claude-sonnet-4-6
fastclaw agents config alpha set provider.openai.model deepseek-v3.2

环境变量 FASTAITOKEN_API_KEY 需先在 Shell 中导出(export FASTAITOKEN_API_KEY=sk-...),FastClaw 不会把密钥明文写入数据库。

为什么选 FastAiToken?

  • 一把密钥多家模型:OpenAI / Anthropic / Google / DeepSeek / 智谱等全模型矩阵,无需逐个 Provider 申请
  • 价格优势:相对官方价格通常有 5%-20% 优惠,部分模型支持充值加赠
  • 国内直连:免代理直接访问海外大模型
  • OpenAI / Anthropic 双协议兼容:FastClaw 的两类 Provider 都能用

方式三:Anthropic 原生协议(适合主用 Claude)

如果你主用 Claude 系列模型,可将 Anthropic Provider 指向 FastAiToken:

字段推荐值
Provider 类型Anthropic
Base URLhttps://fastaitoken.com
API Key你的 FastAiToken 密钥
模型列表claude-sonnet-4-6claude-opus-4-7

CLI 等价写法:

text
fastclaw agents config alpha set provider.anthropic.apiBase https://fastaitoken.com
fastclaw agents config alpha set provider.anthropic.apiKeyEnv FASTAITOKEN_API_KEY
fastclaw agents config alpha set provider.anthropic.model claude-sonnet-4-6
fastclaw agents config alpha set model claude-sonnet-4-6

常用功能速查

Dashboard → Agents:创建/编辑 Agent,定义 SOUL.md(人格)、IDENTITY.md(身份)、MEMORY.md(长期记忆) 内置 code-runner、image-gen、data-analysis、web-search、skill-creator 等,可从 ClawHub / GitHub 安装 Agent → Channels:填入 Telegram / Discord / Slack 的 Bot Token,保存前会自动校验 /v1/chat/completions 流式接口可被任意 OpenAI SDK 直接调用 Settings → Runtime 切换 Docker / E2B 沙箱,工具调用后自动同步产物 Agent → Scheduler:让 Agent 通过 create_cron_job 创建定时提醒

部署模式

模式适用场景关键配置
本地个人使用fastclaw daemon start,SQLite 默认存储
Docker单机服务化cd deploy/docker && ./start.sh
Kubernetes多副本生产FASTCLAW_STORAGE_TYPE=postgres + S3 对象存储

多副本部署需要:

  • FASTCLAW_STORAGE_TYPE=postgresFASTCLAW_STORAGE_DSN=postgres://...
  • FASTCLAW_OBJECT_STORE_* 一组 S3 兼容对象存储变量(用于跨 Pod 同步 Skills 和工作目录)
  • FASTCLAW_BIND=all(监听 0.0.0.0

完整 K8s 清单见仓库 deploy/k8s/ 目录。

常见问题

  • FastClaw:Go 编写、单二进制、面向「Agent 工厂」场景,强调多 Agent 管理、IM 渠道接入、沙箱隔离,适合需要把 Agent 作为服务交付的团队
  • OpenClaw:Node.js 实现、面向个人本地助手,强调本地隐私 + 多 IM 平台联动
  • 两者都可以通过 FastAiToken 接入全模型矩阵,按部署形态选用即可 支持。FastAiToken 提供 OpenAI 兼容协议(https://fastaitoken.com/v1)和 Anthropic 兼容协议(https://fastaitoken.com),FastClaw 的两类 Provider 均可对接,模型 ID 直接填 FastAiToken 文档里的模型名即可(如 gpt-5.4claude-sonnet-4-6deepseek-v3.2gemini-3.1-pro-preview 等)。 1. 在对应平台创建 Bot 并拿到 Token 2. Dashboard → 选中 Agent → Channels → 填入 Token 保存(系统会自动校验 getMe / auth.test) 3. 在 IM 平台搜索你的 Bot 直接对话即可,每个 chatID 的会话相互隔离 可以。FastClaw 社区许可证允许:
text
* ✅ 作为后端嵌入到你自己的产品中商用
* ✅ 组织内部部署使用

不允许(未购买商业许可证时):

* ❌ 作为多租户 SaaS 直接对外托管 FastClaw 自身
* ❌ 去除/修改 Dashboard 中的 FastClaw 品牌

商业授权咨询:`[email protected]`

相关资源

github.com/fastclaw-ai/fastclaw 获取密钥与 Base URL 配置参考 个人本地助手场景的另一选择 了解 FastAiToken 定价与首充优惠