兼容任意 OpenAI 接口
内置 OpenAI、Anthropic、Ollama、OpenRouter、Groq、DeepSeek、Mistral 预设,任何遵循 OpenAI API 的端点也能直接用。
按 Agent 覆盖
先设一个系统默认模型,再给任意 Agent 指定自己的服务商和模型。Agent 级配置会按名称遮蔽系统级配置。
继承与叠加
普通用户能看到管理员共享的服务商(标记为 Inherited),并在其上添加自己的私有配置。
充分利用提示缓存
完整保留原始的 assistant 回复,让服务商的 Prompt Cache 持续命中;用量统计里缓存读写单独列出。
扛得住不稳定的 API
遇到超时、断连、429 和 5xx 时最多重试 6 次,退避间隔从 2 秒到 30 秒,而不是直接结束这一轮。
图片进,图片出
支持 OpenAI image_url 和 Anthropic base64 两种图片格式;回复中的图片能在控制台和 IM 里正常显示。
一个运行时,接所有服务商
在控制台的 Models 里配置一次服务商即可,也可以用 CLI:
fastclaw agents config alpha set provider.openai.apiKeyEnv OPENAI_API_KEY
fastclaw agents config alpha set provider.openrouter.apiBase https://openrouter.ai/api/v1
OpenAI、Anthropic、DeepSeek、Ollama、OpenRouter、Groq 和 Mistral 都有预设,自动填好 Base URL 和默认值。--api-key-env 从环境变量读取密钥,不会留在 Shell 历史里。
默认值 + 覆盖
系统默认模型适用于所有没有单独指定的 Agent。Agent 自己的 model 设置会覆盖它,Agent 级的服务商配置也会遮蔽同名的系统配置——某个 Agent 换一把密钥或换一个 Base URL,其他 Agent 毫不受影响。SaaS 开发者靠它做套餐分级,独立开发者靠它混用本地和云端模型。
为长链路 Agent 循环而生
一轮对话可能连着几十次工具调用,所以 FastClaw 对模型的小毛病很宽容:请求会退避重试;输出被截断时会提示模型拆小步骤再试;DeepSeek 思考模式也能正确回传 reasoning_content。每一轮的真实 Token 用量(含工具循环)都会通过运行时 API 返回。
支持的集成
全部集成OpenAI
用 OpenAI 模型驱动 FastClaw Agent:设置全局默认模型、按 Agent 单独覆盖,并通过 OpenAI 兼容 API 对外提供 Agent。
Anthropic
通过 Anthropic 原生 Messages API 让 FastClaw Agent 跑在 Claude 上,完整保留提示缓存、扩展思考和图片输入。
DeepSeek
用 DeepSeek 驱动 FastClaw Agent:内置预设、支持思考模式、可按 Agent 覆盖模型,低成本也能跑出好效果。
Ollama
把 FastClaw 接到 Ollama,用本地开源模型运行 AI Agent:不需要 API Key,数据不出本机。
OpenRouter
把 FastClaw 接入 OpenRouter,用一个 API Key 让每个 Agent 都能使用多家厂商的模型。