Ubuntu 22.04 部署 Openclaw AI 助手实战指南

重启服务生效：

openclaw-cn gateway restart

配置钉钉

1. 访问 https://open-dev.dingtalk.com 获取 Client ID (AppKey) 和 Client Secret (AppSecret)。
2. 在权限管理中添加：Card.Instance.Write, Card.Streaming.Write, im:message。
3. 默认未内置钉钉插件，需手动安装社区版本：

openclaw-cn plugins install https://github.com/soimy/clawdbot-channel-dingtalk.git

多模型切换策略

当免费 Token 不足时，可自动切换到付费模型（如 DeepSeek）。修改 openclaw.json 加入 DeepSeek 配置即可，无需复杂操作，重启网关后生效。

此外，还支持接入 MiniMax M2.5 和豆包（Seedance）模型，只需在对应平台获取 API Key 并写入配置文件，即可实现多模型负载均衡。

配置 Web 搜索

集成 Exa.ai 增强联网检索能力：

1. 注册 https://exa.ai/ 获取 API Key。
2. 告知 Openclaw 配置，例如：

   我注册了 Exa.ai，并得到 apikey：b9fxxxxx，请帮我配置 exa.ai，代替 Brave Search 进行网络搜索。

3. 重启服务：openclaw-cn gateway restart

.env 配置示例

EXA_API_KEY=YOUR_API_KEY

MCP Server 集成

支持为 OpenAI Codex 提供实时搜索上下文：

codex mcp add exa --url https://mcp.exa.ai/mcp?exaApiKey=YOUR_KEY

可通过 URL 参数启用特定工具，如 web_search_exa, get_code_context_exa 等。

函数调用与工具使用

Exa 支持 Function Calling，允许 AI 智能判断何时搜索。以下是 Python 示例：

import json
from openai import OpenAI
from exa_py import Exa

openai = OpenAI()
exa = Exa()

tools = [{
    "type": "function",
    "function": {
        "name": "exa_search",
        "description": "Search the web for current information.",
        "parameters": {
            "type": "object",
            "properties": {
                "query": {"type": "string", "description": "Search query"}
            },
            "required": ["query"]
        }
    }
}]

def exa_search(query: str) -> str:
    results = exa.search_and_contents(query, type="auto", num_results=10, text={"max_characters": 20000})
    return "\n".join([f"{r.title}: {r.url}" for r in results.results])

messages = [{"role": "user", "content": "What's the latest in AI safety?"}]
response = openai.chat.completions.create(model="gpt-4o", messages=messages, tools=tools)

if response.choices[0].message.tool_calls:
    tool_call = response.choices[0].message.tool_calls[0]
    search_results = exa_search(json.loads(tool_call.function.arguments)["query"])
    messages.append(response.choices[0].message)
    messages.append({"role": "tool", "tool_call_id": tool_call.id, "content": search_results})

final = openai.chat.completions.create(model="gpt-4o", messages=messages)
print(final.choices[0].message.content)

搜索类型参考

建议默认使用 type="auto"，仅在需要深度研究时使用 deep。

内容过滤与新鲜度

• Domain Filtering: 可指定包含或排除的域名，例如仅搜索 GitHub 或 Arxiv。
• Content Freshness: 通过 maxAgeHours 控制缓存时效。设为 0 强制实时爬取，-1 仅使用缓存。

其他端点

除 /search 外，Exa 还提供 /contents（获取已知 URL 内容）和 /answer（带引用的问答）接口。

常见问题排查

• 结果不相关？ 尝试 type: "auto" 或细化关键词。
• 速度太慢？ 使用 type: "fast" 或减少 num_results。
• 无结果？ 移除日期或域名限制，简化查询词。

通过上述配置，Openclaw 将具备更强的代码理解与联网检索能力，能够胜任嵌入式开发辅助、FPGA 编程及系统运维等复杂任务。