FastClaw

概述

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 配置（推薦）

開啟 http://localhost:18953，使用首次啟動時生成的 admin 賬號登入
進入 Models / Providers，新增一條 Provider 配置：

欄位	推薦值
Provider 型別	`OpenAI` 相容
Base URL	`https://api.apiyi.com/v1`
API Key	你的 API易金鑰（`sk-...`）
模型列表	按需新增，如 `gpt-5.4`、`claude-sonnet-4-6`、`deepseek-v3.2`、`gemini-3.1-pro-preview` 等

進入對應 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 URL	`https://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 和 OpenClaw 有什麼區別？

FastClaw：Go 編寫、單二進位制、面向「Agent 工廠」場景，強調多 Agent 管理、IM 渠道接入、沙箱隔離，適合需要把 Agent 作為服務交付的團隊
OpenClaw：Node.js 實現、面向個人本地助手，強調本地隱私 + 多 IM 平臺聯動
兩者都可以通過 API易接入全模型矩陣，按部署形態選用即可

是否支援 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 等）。

如何讓 Agent 通過 Telegram / Discord 對外服務？

在對應平臺建立 Bot 並拿到 Token
Dashboard → 選中 Agent → Channels → 填入 Token 儲存（系統會自動校驗 getMe / auth.test）
在 IM 平臺搜尋你的 Bot 直接對話即可，每個 chatID 的會話相互隔離

許可證可以用於商業專案嗎？

可以。FastClaw 社群許可證允許：

✅ 作為後端嵌入到你自己的產品中商用
✅ 組織內部部署使用

不允許（未購買商業許可證時）：

❌ 作為多租戶 SaaS 直接對外託管 FastClaw 自身
❌ 去除/修改 Dashboard 中的 FastClaw 品牌

商業授權諮詢：[email protected]

專案倉庫

github.com/fastclaw-ai/fastclaw

API易 API 文件

獲取金鑰與 Base URL 配置參考

OpenClaw 對比方案

個人本地助手場景的另一選擇

充值與定價

瞭解 API易定價與首充優惠

概覽

對話型 AI

程式設計開發

社群貢獻

AI Agent

技術工程

翻譯場景

概述

🚀 單二進位制部署

🤖 多 Agent 管理

📱 IM 多通道

🛡️ 沙箱隔離

安裝與啟動

接入 API易（推薦配置）

方式一：通過 Dashboard 配置（推薦）

方式二：通過 CLI 配置

方式三：Anthropic 原生協議（適合主用 Claude）

常用功能速查

Agent 管理

技能（Skills）

IM 渠道繫結

OpenAI 相容 API

沙箱執行

定時任務

部署模式

常見問題

相關資源

專案倉庫

API易 API 文件

OpenClaw 對比方案

充值與定價

​概述

🚀 單二進位制部署

🤖 多 Agent 管理

📱 IM 多通道

🛡️ 沙箱隔離

​安裝與啟動

​接入 API易（推薦配置）

​方式一：通過 Dashboard 配置（推薦）

​方式二：通過 CLI 配置

​方式三：Anthropic 原生協議（適合主用 Claude）

​常用功能速查

Agent 管理

技能（Skills）

IM 渠道繫結

OpenAI 相容 API

沙箱執行

定時任務

​部署模式

​常見問題

​相關資源

專案倉庫

API易 API 文件

OpenClaw 對比方案

充值與定價

概述

安裝與啟動

接入 API易（推薦配置）

方式一：通過 Dashboard 配置（推薦）

方式二：通過 CLI 配置

方式三：Anthropic 原生協議（適合主用 Claude）

常用功能速查

部署模式

常見問題

相關資源