Appearance
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 兼容 Provider 或 Anthropic 兼容 Provider 接入,二者均可使用同一把 FastAiToken 密钥访问全模型矩阵。
方式一:通过 Dashboard 配置(推荐)
- 打开
http://localhost:18953,使用首次启动时生成的 admin 账号登录 - 进入 Models / Providers,新增一条 Provider 配置:
| 字段 | 推荐值 |
|---|---|
| Provider 类型 | OpenAI 兼容 |
| Base URL | https://fastaitoken.com/v1 |
| API Key | 你的 FastAiToken 密钥(sk-...) |
| 模型列表 | 按需添加,如 gpt-5.4、claude-sonnet-4-6、deepseek-v3.2、gemini-3.1-pro-preview 等 |
- 进入对应 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 URL | https://fastaitoken.com |
| API Key | 你的 FastAiToken 密钥 |
| 模型列表 | claude-sonnet-4-6、claude-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=postgres、FASTCLAW_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.4、claude-sonnet-4-6、deepseek-v3.2、gemini-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 定价与首充优惠