OpenClaw
为 OpenClaw 添加自定义 Anthropic 提供方。
OpenClaw 是运行在你自己电脑上的开源个人 AI 助手,可以接入聊天软件。它支持添加自定义模型提供方,OpenAI 兼容和 Anthropic 两种格式都能用。
- 协议:OpenAI 兼容,或 Anthropic
- 地址:OpenAI 兼容填
https://tokenfunc.com/v1,Anthropic 填https://tokenfunc.com - 模型:任意,例如
claude-sonnet-4-5
方式一:配置向导
运行向导
openclaw onboard选择 More… → Custom Provider。
截图待补充openclaw onboard 中的 Custom Provider 选项tools/openclaw-onboard.png
填写提供方信息
提示项 OpenAI 兼容 Anthropic Base URL https://tokenfunc.com/v1https://tokenfunc.comAPI key sk-xxxxxxxxxxxxxxxxsk-xxxxxxxxxxxxxxxxCompatibility OpenAI-compatible Anthropic-compatible Model ID claude-sonnet-4-5claude-sonnet-4-5选 OpenAI 兼容时,向导会自动拉取本站的模型列表供选择;选 Anthropic 时需要手动填写模型 ID。保存前向导会实际调用一次,确认能收到回复。
验证
openclaw models list --provider tokenfunc能列出本站的模型即配置成功。向导生成的提供方名默认是
custom-加域名,上面命令里的tokenfunc换成实际的名字。
方式二:一行命令
openclaw onboard --non-interactive --auth-choice custom-api-key \
--custom-provider-id tokenfunc \
--custom-base-url "https://tokenfunc.com/v1" \
--custom-model-id "claude-sonnet-4-5" \
--custom-api-key "sk-xxxxxxxxxxxxxxxx" \
--custom-compatibility openai方式三:编辑配置文件
配置文件是 ~/.openclaw/openclaw.json(JSON5 格式,可以写注释),修改后会自动生效:
~/.openclaw/openclaw.json
{
agents: { defaults: { model: { primary: 'tokenfunc/claude-sonnet-4-5' } } },
models: {
mode: 'merge',
providers: {
tokenfunc: {
baseUrl: 'https://tokenfunc.com/v1',
apiKey: 'sk-xxxxxxxxxxxxxxxx',
api: 'openai-completions',
models: [
{
id: 'claude-sonnet-4-5',
name: 'claude-sonnet-4-5',
contextWindow: 200000,
maxTokens: 8192,
},
],
},
},
},
}- 要用 Anthropic 格式,把
baseUrl改为https://tokenfunc.com、api改为"anthropic-messages"。 - 模型要支持看图,在模型上加
input: ["text", "image"]。 - 切换默认模型:
openclaw models set tokenfunc/claude-sonnet-4-5。
常见问题
| 现象 | 原因与处理 |
|---|---|
| 模型不可用 / not allowed by modelPolicy | 模型只写在了 agents.defaults 里,必须同时写进 providers.tokenfunc.models |
| 提示 returned no token usage | 在模型上加 compat: { supportsUsageInStreaming: true } |
| 上游不接受 reasoning_effort | 在模型上加 compat: { supportsReasoningEffort: false } |
| 404 | OpenAI 兼容格式的 baseUrl 少了 /v1 |
改了 openclaw configure 不生效 | 提供方要通过 openclaw onboard 或配置文件修改 |