跳转到主要内容

​
概述

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

🚀 单二进制部署

一条命令安装，自带 SQLite，本地或云端均可

🤖 多 Agent 管理

每个 Agent 独立的人格、模型、技能与会话

📱 IM 多通道

内置 Telegram / Discord / Slack 渠道绑定

🛡️ 沙箱隔离

支持 Docker / E2B 沙箱，工具调用安全可控
项目信息：FastClaw 采用 FastClaw Community License（基于 Apache 2.0 + 附加条款）的源代码可见许可证，项目地址 github.com/fastclaw-ai/fastclaw。

​
安装与启动

FastClaw 通过官方安装脚本一键安装到 ~/.local/bin： 
curl -fsSL https://raw.githubusercontent.com/fastclaw-ai/fastclaw/main/install.sh | bash
首次启动会进入设置向导，配置完 LLM Provider 后自动创建默认 Agent： 
fastclaw                    # 前台运行，Ctrl+C 停止
fastclaw daemon start       # 后台运行（日志 ~/.fastclaw/daemon.log）
fastclaw daemon install     # 注册为 launchd / systemd 服务
启动后访问 Dashboard：http://localhost:18953（默认端口 18953）。

​
接入 API易（推荐配置）

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

​
方式一：通过 Dashboard 配置（推荐）

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

​
方式二：通过 CLI 配置

# 1. 创建一个新 Agent，初始绑定 API易（OpenAI 兼容）
fastclaw agents init alpha \
  --provider openai \
  --model openai/gpt-5.4 \
  --api-key-env APIYI_API_KEY

# 2. 将 OpenAI provider 的 Base URL 指向 API易
fastclaw agents config alpha set provider.openai.apiBase https://api.apiyi.com/v1
fastclaw agents config alpha set provider.openai.apiKeyEnv APIYI_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
环境变量 APIYI_API_KEY 需先在 Shell 中导出（export APIYI_API_KEY=sk-...），FastClaw 不会把密钥明文写入数据库。
为什么选 API易？
  • 一把密钥多家模型：OpenAI / Anthropic / Google / DeepSeek / 智谱等全模型矩阵，无需逐个 Provider 申请
  • 价格优势：相对官方价格通常有 5%-20% 优惠，部分模型支持充值加赠
  • 国内直连：免代理直接访问海外大模型
  • OpenAI / Anthropic 双协议兼容：FastClaw 的两类 Provider 都能用

​
方式三：Anthropic 原生协议（适合主用 Claude）

如果你主用 Claude 系列模型，可将 Anthropic Provider 指向 API易：
字段推荐值
Provider 类型Anthropic
Base URLhttps://api.apiyi.com
API Key你的 API易 密钥
模型列表claude-sonnet-4-6、claude-opus-4-7 等
CLI 等价写法： 
fastclaw agents config alpha set provider.anthropic.apiBase https://api.apiyi.com
fastclaw agents config alpha set provider.anthropic.apiKeyEnv APIYI_API_KEY
fastclaw agents config alpha set provider.anthropic.model claude-sonnet-4-6
fastclaw agents config alpha set model claude-sonnet-4-6

​
常用功能速查

Agent 管理

Dashboard → Agents：创建/编辑 Agent，定义 SOUL.md（人格）、IDENTITY.md（身份）、MEMORY.md（长期记忆）

技能（Skills）

内置 code-runner、image-gen、data-analysis、web-search、skill-creator 等，可从 ClawHub / GitHub 安装

IM 渠道绑定

Agent → Channels：填入 Telegram / Discord / Slack 的 Bot Token，保存前会自动校验

OpenAI 兼容 API

/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 平台联动
  • 两者都可以通过 API易 接入全模型矩阵，按部署形态选用即可
支持。API易 提供 OpenAI 兼容协议（https://api.apiyi.com/v1）和 Anthropic 兼容协议（https://api.apiyi.com），FastClaw 的两类 Provider 均可对接，模型 ID 直接填 API易 文档里的模型名即可（如 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 社区许可证允许：
  • ✅ 作为后端嵌入到你自己的产品中商用
  • ✅ 组织内部部署使用
不允许（未购买商业许可证时）：
  • ❌ 作为多租户 SaaS 直接对外托管 FastClaw 自身
  • ❌ 去除/修改 Dashboard 中的 FastClaw 品牌
商业授权咨询：[email protected]

​
相关资源

项目仓库

github.com/fastclaw-ai/fastclaw

API易 API 文档

获取密钥与 Base URL 配置参考

OpenClaw 对比方案

个人本地助手场景的另一选择

充值与定价

了解 API易 定价与首充优惠