工具接入
OpenClaw
在 OpenClaw 的 openclaw.json 中添加 LynShen 自定义服务商。
OpenClaw 是一个开源的个人 AI Agent，曾用名 Clawdbot、Moltbot。文档站 docs.openclaw.ai。本页按 v2026.10.1（2026-10-10 发布）编写。
接入方式
api 值 | 协议 | baseUrl |
|---|---|---|
openai-completions | Chat Completions | https://api.lynshen.org/v1 |
openai-responses | Responses | https://api.lynshen.org/v1 |
anthropic-messages | Messages | https://api.lynshen.org（带不带 /v1 都可以） |
配置文件位置
| 系统 | 路径 |
|---|---|
| macOS、Linux | ~/.openclaw/openclaw.json |
| Windows | %USERPROFILE%\.openclaw\openclaw.json |
| WSL2 中运行网关 | WSL 内部的 ~/.openclaw/openclaw.json |
文件格式为 JSON5，修改后自动重新加载。可以用 OPENCLAW_CONFIG_PATH 指定其他位置。Windows 路径按程序的主目录规则推断，官方文档没有单独写明。
方式一：使用向导
openclaw onboard --auth-choice custom-api-key \
--custom-base-url https://api.lynshen.org/v1 \
--custom-model-id deepseek-v4-pro \
--custom-api-key sk-... \
--custom-compatibility openai--custom-compatibility 可以是 openai（Chat Completions，默认）、openai-responses 或 anthropic。也可以运行 openclaw onboard，在交互菜单中选择自定义服务商。
方式二：编辑 openclaw.json
{
models: {
mode: "merge",
providers: {
lynshen: {
baseUrl: "https://api.lynshen.org/v1",
apiKey: "${LYNSHEN_API_KEY}",
api: "openai-completions",
models: [
{ id: "deepseek-v4-pro", name: "DeepSeek V4 Pro", reasoning: true,
input: ["text"], contextWindow: 128000, maxTokens: 32000 },
],
},
"lynshen-gpt": {
baseUrl: "https://api.lynshen.org/v1",
apiKey: "${LYNSHEN_API_KEY}",
api: "openai-responses",
models: [
{ id: "gpt-5.5", name: "GPT-5.5", reasoning: true,
input: ["text", "image"], contextWindow: 272000, maxTokens: 64000 },
],
},
"lynshen-claude": {
baseUrl: "https://api.lynshen.org",
apiKey: "${LYNSHEN_API_KEY}",
api: "anthropic-messages",
models: [
{ id: "claude-sonnet-5", name: "Claude Sonnet 5", reasoning: true,
input: ["text", "image"], contextWindow: 200000, maxTokens: 64000 },
],
},
},
},
agents: { defaults: { model: { primary: "lynshen/deepseek-v4-pro" } } },
}- 把模型 ID 换成你的
/v1/models中的值。上下文和输出上限是示例。 - 模型支持图片输入时，写
input: ["text", "image"]。 apiKey可以写${环境变量}，也可以直接写sk-...。
选择模型
- 命令行：
openclaw models set lynshen/<模型ID>。 - 会话中：
/model、/model list、/model default。
显示推理
/think <级别>设置思考档位，可选 off、minimal、low、medium、high、xhigh、adaptive、max、ultra。/reasoning on|off|stream控制是否显示推理。默认off。默认值的配置项为agents.defaults.reasoningDefault。- 模型写了
reasoning: true，请求才带reasoning_effort。使用 xhigh、max 前，要在模型的compat.supportedReasoningEfforts中声明它们。 openai-completions模式读取reasoning_details中reasoning.text类型的推理文字。流式块中没有reasoning.text时，它读取reasoning_content。LynShen 也在reasoning_content中返回推理摘要。所以通过 Chat 调用 DeepSeek、Claude 等模型时都能看到推理。调用 Claude 仍推荐使用anthropic-messages。
常见问题
| 现象 | 原因和处理 |
|---|---|
端点拒绝 reasoning_effort | 在模型上设置 compat.supportsReasoningEffort: false。 |
/think off 后仍在推理 | /think off 默认不发送推理参数，不保证关闭推理。 |
| 改了默认模型但会话仍用旧模型 | 会话会固定模型。发送 /model default。 |
| 依赖测试版功能的 Claude 请求失败 | OpenClaw 的 Anthropic 代理路由会去掉隐式的 beta 请求头。LynShen 也不转发 anthropic-beta。 |
来源
2026-10-11 查阅：